# Finland Invoice MCP

> A remote MCP server that lets any AI agent send Finland B2B/B2G electronic invoices (verkkolasku) over the Peppol network in Peppol BIS 3.0 (EN 16931) format through Storecove, a certified Peppol Access Point. Supports the 25.5% decimal VAT rate. Check whether a recipient is reachable on Peppol, send the invoice, and fetch delivery proof. Stateless, bring-your-own Storecove credentials, never stores anything.

- MCP endpoint (Streamable HTTP): https://inv-fi.wishpool.app/mcp
- Credential header: x-storecove-key (your own Storecove API key). Sign up at storecove.com — the merchant is the Peppol Access Point account holder. Request a free 30-day sandbox account from Storecove for a test key. Sandbox vs production is determined by the account the key belongs to (same base URL, no key-prefix switch).
- create_invoice also needs seller_legal_entity_id: the Storecove legalEntityId of the sender you created under Senders in your account.
- Why now: Finland mandates structured e-invoicing (verkkolasku) for public-sector suppliers (B2G) since 2020-04-01; for B2B a business has the right to require an e-invoice from another business (turnover over EUR 10,000) under the Act on Electronic Invoicing (241/2019) — a right to demand, not a blanket obligation. Peppol/Finvoice is the Finnish rail.
- Design: this server ONLY forwards Storecove REST calls. It builds the structured Peppol BIS invoice JSON, computes the Finnish VAT (ALV) breakdown, and submits under the merchant's own account. Storecove is the Peppol Access Point (certification, delivery, archiving) — never this service. The key travels per-request in a header and is never stored; no invoice or customer data is persisted.
- Endpoints wrapped (Storecove, base https://api.storecove.com/api/v2, auth Bearer): POST /document_submissions (send, returns guid), GET /document_submissions/{guid}/evidence (delivery proof), POST /discovery/receives (Peppol participant lookup).
- Finnish VAT (ALV) rates: 25.5 (standard, DECIMAL rate since 2024-09-01), 14 (food/restaurant), 10 (books/pharmaceuticals/passenger transport), 0 (zero-rated/exempt/reverse charge). Fractional rates are fully supported (e.g. 100.00 @ 25.5% = 25.50 VAT; 33.33 @ 25.5% = 8.50 VAT). Currency EUR. Parties identified by Finnish VAT (FIxxxxxxxx) and/or Y-tunnus business ID. Peppol schemes: 0037 (OVT / Y-tunnus), 0213 (VAT).

## Tools

- create_invoice: Send a Peppol BIS 3.0 (EN 16931) B2B/B2G invoice over Peppol via Storecove — seller + buyer (name, Finnish VAT/Y-tunnus, address), line items ({description, quantity, unit_price (net EUR), vat_rate 25.5|14|10|0, tax_category? S/Z/E/AE, item_name?}), plus seller_legal_entity_id and Peppol routing (derived from the customer VAT/business ID, or recipient_peppol_id + recipient_peppol_scheme, or recipient_email fallback). Returns a submission guid + VAT totals (taxable, vat, total). No cancel over Peppol — reverse with a credit note.
- check_recipient: Peppol participant discovery — { identifier, scheme? (default 0037 OVT / Y-tunnus; 0213 for VAT), network? (default peppol), document_types? (default ["invoice"]) } in, { can_receive, code, email_only } out. The safe pre-flight before sending.
- get_delivery_evidence: Fetch delivery proof/status for a submission — { guid } in, the exact document sent + Peppol delivery evidence out. Async: poll until delivered.
- Owner policy guardrails: x-agentpay-max-amount (hard cap on the gross invoice total in EUR), x-agentpay-approval-above (returns an unsigned draft for human review), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them.

## Safety

Stateless translation layer that forwards the Storecove REST calls only. Storecove is the certified Peppol Access Point under the merchant's own account; the x-storecove-key travels per-request in a header and is never stored. This server never stores credentials, invoices, or customer data. It issues tax invoices — it does not move money. Privacy policy: https://inv-fi.wishpool.app/privacy

## Sister servers

Invoices: Belgium Peppol https://inv-be.wishpool.app/mcp, Sweden Peppol https://inv-se.wishpool.app/mcp, Italy FatturaPA https://inv-it.wishpool.app/mcp, Malaysia MyInvois https://inv-my.wishpool.app/mcp, Mexico CFDI https://inv-mx.wishpool.app/mcp, Brazil NF-e https://inv-br.wishpool.app/mcp, India GST https://inv-in.wishpool.app/mcp. Storecove also covers Norway/Denmark/NL/LU on Peppol — sister countries replicate this server. Local logistics: https://logi.wishpool.app. Same stateless BYO pattern, local payments in 81 countries — full list: https://mcp.wishpool.app/llms.txt (Taiwan e-invoice 電子發票 lives in https://mcp.wishpool.app/mcp).