Which AI assistants does the MCP server support?

Every client that can work with MCP over Streamable HTTP: Claude Code (the claude mcp add command), Claude Desktop through the mcp-remote bridge (needs Node.js, because Claude Desktop does not yet support custom headers directly), Cursor (mcp.json) and VS Code with GitHub Copilot in agent mode. Ready-made configurations are in the portal on the API tokens page, MCP server tab. The web and mobile versions of Claude (claude.ai) connect remote servers only through OAuth, which we do not offer yet.

Can the assistant send an invoice without my knowledge?

No. The send_document tool refuses a call without the argument confirm = true, and the server instructions tell the assistant to ask for your explicit consent to the specific invoice and recipient. The sending gate (the verification token) applies as when sending from the portal: only a company that has completed the provider selection on the Financial Administration portal can send.

What does the assistant see and where do I check it?

Exactly what your account has access to and nothing more; the invoice data stays with us in the EU and the assistant only receives what it asks for. You see every call of the key on the API log tab of the API tokens page and in the security record of the account. We recommend a separate key just for the assistant so you can revoke it at any time without affecting other integrations.

What do I need before connecting?

An account on peppol.verteco.digital with at least one company, because an API key is bound to the companies of the account. The simplest way is selecting Verteco as the provider on the Financial Administration portal (signing in with eID or with the FS portal credentials); the company is created on your account automatically and right after that you generate the key.

How much does it cost?

The connection is free. The service costs from €2/month excl. VAT per company ID (IČO) that sends or has the Data archive switched on; receiving with the archive off is free (up to 1,000 invoices a month). During the voluntary period before the mandate of 1 January 2027 everything is free of charge.

Integrations / AI assistants / MCP server pre AI asistentov

MCP server for AI assistants

Available

The Verteco portal has its own server for the Model Context Protocol (MCP), the open standard through which AI assistants such as Claude Code, Claude Desktop, Cursor or VS Code Copilot connect to external systems. The assistant signs in with an ordinary API key of your account, gets six tools and never sees more than your account. Sending an invoice is legally binding, so the send_document tool refuses a call without the argument confirm = true.

Get the plugin in the portal Create a free account

How it works

1In the portal open API tokens (left menu) and the MCP server tab. Click Create a key for an AI assistant: a separate API key only for the assistant is created, which you can revoke at any time or restrict to IP addresses on the API keys tab. The key is shown only once.
2Copy the ready-made configuration for your assistant: Claude Code (the claude mcp add command with the http transport and the Authorization: Bearer header), Claude Desktop (claude_desktop_config.json through the mcp-remote bridge, needs Node.js), Cursor (mcp.json) or VS Code (.vscode/mcp.json). The server address is https://peppol.verteco.digital/api/mcp.
3Start a conversation. The assistant loads the companies of your account with the list_companies tool and then answers questions such as "Which invoices from last month are not delivered yet, and why?" or "Check whether this customer is in the Peppol network".
4The assistant sends an invoice only after your explicit consent to the specific invoice and recipient; the send_document tool refuses a call without confirm = true. You see every call of the assistant on the API log tab.

What the integration solves

✓Six tools: list_companies, list_documents, get_document, check_participant, validate_document and send_document
✓Streamable HTTP and stateless JSON-RPC 2.0: POST to /api/mcp with the Authorization: Bearer header and your API key
✓Invoice detail including the MLS delivery receipt, the report to the Financial Administration and optionally the UBL XML up to 1 MB
✓Live recipient lookup in the Peppol network (SML/SMP) and validation of the invoice against EN 16931 and Peppol BIS 3.0
✓Sending only with confirm = true after your explicit consent; the verification-token gate applies as when sending from the portal
✓The assistant never sees more than your account; you revoke the key with one click, restrict it to IP addresses, and every call is in the API log and in the security record of the account

Frequently asked questions: e-invoices for MCP server pre AI asistentov

Which AI assistants does the MCP server support?: Every client that can work with MCP over Streamable HTTP: Claude Code (the claude mcp add command), Claude Desktop through the mcp-remote bridge (needs Node.js, because Claude Desktop does not yet support custom headers directly), Cursor (mcp.json) and VS Code with GitHub Copilot in agent mode. Ready-made configurations are in the portal on the API tokens page, MCP server tab. The web and mobile versions of Claude (claude.ai) connect remote servers only through OAuth, which we do not offer yet.
Can the assistant send an invoice without my knowledge?: No. The send_document tool refuses a call without the argument confirm = true, and the server instructions tell the assistant to ask for your explicit consent to the specific invoice and recipient. The sending gate (the verification token) applies as when sending from the portal: only a company that has completed the provider selection on the Financial Administration portal can send.
What does the assistant see and where do I check it?: Exactly what your account has access to and nothing more; the invoice data stays with us in the EU and the assistant only receives what it asks for. You see every call of the key on the API log tab of the API tokens page and in the security record of the account. We recommend a separate key just for the assistant so you can revoke it at any time without affecting other integrations.
What do I need before connecting?: An account on peppol.verteco.digital with at least one company, because an API key is bound to the companies of the account. The simplest way is selecting Verteco as the provider on the Financial Administration portal (signing in with eID or with the FS portal credentials); the company is created on your account automatically and right after that you generate the key.
How much does it cost?: The connection is free. The service costs from €2/month excl. VAT per company ID (IČO) that sends or has the Data archive switched on; receiving with the archive off is free (up to 1,000 invoices a month). During the voluntary period before the mandate of 1 January 2027 everything is free of charge.

Start today: selecting us on the Financial Administration portal is enough

Receiving is free · no lock-in, no hidden feesMeet your 2027 legal obligation in 2 minutes

Choose Verteco on the Financial Administration portal →On the portal, click “Pokračovať” (Continue), sign in (slovensko.sk / eID or your FS portal credentials) and confirm the selection. We handle the rest automaticallyCertified provider of the Financial Administration (EFSK000031) · no commitment · you can change providers at any time

How does the selection work? (3 steps, ~2 minutes)

1Click the button above. The official Financial Administration page “Certified provider selection” opens with Verteco pre-selected. Click “Pokračovať” (Continue).
2Sign in to the Financial Administration portal, via slovensko.sk (eID / ID card with a chip) or with your PFS credentials, and confirm the provider selection.
3Done. A sign-in e-mail arrives. We create your account, company and Peppol network registration automatically. If another provider already holds your receiving record, we do not take it over: you get the migration-code procedure, or you choose in the portal that receiving stays with them and you only send through us.
No eID? You can also sign in to the Financial Administration portal with your PFS identifier and password. Or register here with an e-mail and password, add your company manually and finish the selection later.
Your company is not offered in the “taxpayer selection” step? Only entities you are authorised for on the FS portal appear. Add the authorisation in your Personal Internet Zone (Autorizácie → Pridať autorizovaného používateľa), then finish the selection.
Detailed guide to the FS portal selection (in Slovak) →