# EU Counterparty Check (VIES + Peppol)

> EU Counterparty Check (VIES + Peppol) is a freemium MCP server for finance and payments. Validate EU VAT numbers in VIES and look up Peppol e-invoicing support. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API
- **Website:** https://errandcode.com/mcp-peppol
- **MCP Registry name:** io.github.DouglasGouvea/mcp-peppol
- **Categories:** finance and payments, legal and government
- **Listing updated:** 2026-11-15

## About

This server separates 'invalid' from 'unavailable', which VIES often conflates. A VAT status can be valid, invalid or unavailable, and unavailable means VIES or a national system could not answer. A separate tool reports whether VIES and each member state's system are responding right now.

Peppol lookups search the OpenPeppol Directory by name, VAT number or participant ID and show whether a participant accepts invoices, credit notes or orders. Not being listed does not prove a company is outside Peppol. Some countries, such as ES and DE, never disclose company names, and names and addresses appear only for entities with a legal-form mark.

There is no score and no AI. Access is via MCPize with a bearer key, from Errand Code.

## Features

- **VAT validation:** Returns valid, invalid or unavailable for a VAT number.
- **Peppol lookup:** Searches the Peppol Directory by name, VAT or participant ID.
- **Document types:** Shows invoice, credit note and order support.
- **VIES status:** Reports whether VIES and national systems are answering.
- **Combined check:** Runs VAT and Peppol checks together.
- **Privacy limits:** Names and addresses shown only for legal entities.

## Good for

- Check an EU supplier's VAT number
- Find out whether a customer can receive Peppol e-invoices
- Tell if a failed check is a VIES outage
- Verify a counterparty before onboarding

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-peppol https://mcp-peppol.mcpize.run/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp-peppol.mcpize.run/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-peppol": {
      "url": "https://mcp-peppol.mcpize.run/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-peppol": {
      "type": "http",
      "url": "https://mcp-peppol.mcpize.run/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-peppol": {
      "serverUrl": "https://mcp-peppol.mcpize.run/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-peppol": {
      "type": "http",
      "url": "https://mcp-peppol.mcpize.run/mcp"
    }
  }
}
```

## Tools

- `validate_vat`: Validates a VAT number in VIES.
- `peppol_lookup`: Searches the Peppol Directory.
- `vies_country_status`: Reports whether VIES and member states are answering.
- `check_eu_counterparty`: Runs VAT and Peppol checks in parallel.

## FAQ

### What does 'unavailable' mean?

VIES or the national system could not answer; it does not mean the number is invalid.

### Does being absent from Peppol mean no Peppol?

No, the directory is opt-in.

### What does it cost?

50 free requests a month; Pro is $9 for 1,000.

### Is it tax advice?

No.

### Is EU Counterparty Check (VIES + Peppol) free?

EU Counterparty Check (VIES + Peppol) has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add EU Counterparty Check (VIES + Peppol) to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-peppol https://mcp-peppol.mcpize.run/mcp

### What are the best alternatives to EU Counterparty Check (VIES + Peppol)?

The closest alternatives to EU Counterparty Check (VIES + Peppol) are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/eu-counterparty-check-vies-peppol
