Documentation / Getting started

MCP

akwito is also an MCP server: Claude Code, Claude Desktop, Cursor and any assistant that speaks the Model Context Protocol can verify numbers, re-read checks and list what was already verified, with the account's API key. Transport is Streamable HTTP, nothing to install.

Endpoint: POST https://api.akwito.eu/mcp, header Authorization: Bearer <your API key>. The monthly quota is the same as the REST API's. The per-key rate limit is not: each tool call re-enters the REST API behind the scenes, so one tool call counts as two requests against the per-key rate limit.

A test key works over MCP too: verify_vat_number runs against the sandbox and its results carry "test": true, exactly like the REST API — see Test keys.

Tools #

Tool	Input	What it does
`verify_vat_number`	`vat_number` (required), `country`, `name`, `street`, `postcode`, `city`, `refresh`, `reference`	Runs a check and records the proof, exactly like `POST /v1/checks`. Returns validity, confidence, the identity with its sources, the proof URL and the PDF URL. When VIES is down for the country, returns the `request_id` and a retry delay instead.
`get_check`	`check_id`	Re-reads a check, like `GET /v1/checks/{id}`, and the qualified RFC 3161 timestamp once one exists. No quota.
`list_checks`	`vat_number`, `reference`, `from`, `to`, `limit` (default 20, max 100)	The checks already made on this account, most recent first, optionally filtered by VAT number, reference and creation period, like `GET /v1/checks`. No quota.

Each result carries a French summary for the model and the check as structured content, with the same fields as the REST API plus pdf_url.

Ask things like « Vérifie le numéro FR40303265045 et donne-moi le PDF », « Est-ce qu'on a déjà vérifié DE811907980 ce mois-ci ? », « Relis la vérification chk_… ».

Claude Code #

claude mcp add --transport http akwito https://api.akwito.eu/mcp --header "Authorization: Bearer ak_live_…"

Claude Desktop, Cursor and others #

Add a remote MCP server with the URL https://api.akwito.eu/mcp and the header Authorization: Bearer ak_live_…. For clients configured by JSON:

json

{
  "mcpServers": {
    "akwito": {
      "url": "https://api.akwito.eu/mcp",
      "headers": { "Authorization": "Bearer ak_live_…" }
    }
  }
}

The key is a normal API key (dashboard → API keys). Revoke it there to cut the assistant's access.