# Veille

An MCP server for Claude Code connects agents to Veille’s data-validation API. It handles requests to check emails, domains, IPs, phone numbers, VAT IDs, and IBANs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: veilleio
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/veilleio/veille-mcp
- Updated: 2026-11-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/veille

## What it does

Veille sends agent requests to the Veille API and returns validation results. Its tools check email addresses and domains, assess IP reputation, inspect phone numbers, and verify VAT IDs and IBANs. Email checks include deliverability and risk signals; IP checks return a threat score.

API calls consume credits from the Veille account. An API key is required: local runs read it from `VEILLE_API_KEY`, while the hosted service accepts it in a request header. Local installation requires Node.js 20 or newer and runs the package with `npx -y @veilleio/mcp`. The hosted server is at `https://mcp.veille.io/`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.veille.io/`
- Environment variables: `VEILLE_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add mcp -e VEILLE_API_KEY=<VEILLE_API_KEY> -- npx -y @veilleio/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http veille https://mcp.veille.io/
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add veille --url https://mcp.veille.io/
```

2. **Platform CLI**
```bash
codex mcp add veille --env VEILLE_API_KEY=<VEILLE_API_KEY> -- npx -y @veilleio/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "veille": {
            "url": "https://mcp.veille.io/"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "veille": {
            "command": "npx",
            "args": [
                "-y",
                "@veilleio/mcp"
            ],
            "env": {
                "VEILLE_API_KEY": "<VEILLE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "veille": {
            "type": "http",
            "url": "https://mcp.veille.io/"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "veille": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@veilleio/mcp"
            ],
            "env": {
                "VEILLE_API_KEY": "<VEILLE_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http veille https://mcp.veille.io/
```

2. **Platform CLI**
```bash
gemini mcp add -e VEILLE_API_KEY=<VEILLE_API_KEY> veille npx -y @veilleio/mcp
```
Replace <…> with your own values

## When to use it
- flag disposable email addresses
- assess the reputation of an IP address
- check a VAT number against VIES
- validate an IBAN and retrieve bank details
- inspect a phone number and identify its line type

## Example prompts
- Check `alex@example.com` and assess its risk.
- Assess the reputation of IP address `203.0.113.10`.
- Verify VAT ID `DE123456789` and IBAN `DE89370400440532013000`.

## Similar
- [VerifyDesk](https://affpapa.org/en/nevibecode/mcp/verifydesk.md) — MCP server
- [mcp](https://affpapa.org/en/nevibecode/mcp/getapinl-mcp.md) — MCP server
- [Arnakoff](https://affpapa.org/en/nevibecode/mcp/arnakoff.md) — MCP server
- [HoneyLabs](https://affpapa.org/en/nevibecode/mcp/honeylabs.md) — MCP server · ★ 2 repo stars
- [Outlook SNDS](https://affpapa.org/en/nevibecode/mcp/outlook-snds.md) — MCP server · ★ 7 repo stars
- [🌮 MadTaco MCP — verification and trust checks for AI agents.](https://affpapa.org/en/nevibecode/mcp/madtaco-mcp-verification-and-trust-checks-for-ai-agents.md) — MCP server · 810 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
