Counterfoil MCP Server

by einvoicegoblin Your server? Claim it

answering

Counterfoil is answering right now. Last checked moments ago. It exposes 4 tools.

Read stored EU e-invoice rule notes and the invoice field map. Not a validator.

Uptime history 13 days of history

13 days agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

194 ms

Response time

average over 24h

open, no key

Access

streamable-http

Nothing serious here today

Today is the operative word: we check Counterfoil every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 0 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add counterfoil --transport http https://einvoicegoblin.com/mcp

Settings → Connectors → Add custom connector, then paste this address

https://einvoicegoblin.com/mcp

~/.codex/config.toml

[mcp_servers.counterfoil]
url = "https://einvoicegoblin.com/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "counterfoil": {
      "url": "https://einvoicegoblin.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "counterfoil": {
      "type": "http",
      "url": "https://einvoicegoblin.com/mcp"
    }
  }
}

Available tools 4

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

explain

explain_error

Read a stored rule named in a rule id or a validator message. Returns the stored statement, plain reading, fix, and source URL when a stored rule matches. Does not check an invoice.

invoice

check_invoice

Read a UBL Invoice XML slice of at most 60000 characters. Returns the business terms that slice writes, the field-map gaps, and one stored note when BR-DE-15 finds no non-empty buyer reference (BT-10). evaluation is false: no Schematron runs. The result does not say the invoice passed. The XML is not stored. A larger file is the raw body of POST /v1/invoices/check, up to 1048576 bytes.

rule

get_rule

Read one stored EU e-invoice rule by id. Returns the stored statement, context, test, plain reading, fix, and source URL. Does not check an invoice.

rules

search_rules

Find stored rules by words, a BT code, or a group. Each hit returns the stored statement, plain reading, fix, and source URL. At most 100 hits. Does not check an invoice.

Endpoints

URL	Transport	State	Latency	Checked
https://einvoicegoblin.com/mcp	streamable-http	answering	203 ms	0 min ago

Alternatives to Counterfoil

same job, measured the same way

NormAPI

by normapi

Validate, generate and read German e-invoices (XRechnung, ZUGFeRD) against the official KoSIT rules.

588 installs/wk 4 tools answering

En16931 Einvoice Lint

by jmshinhwa

Checks an invoice payload or field mapping against EN 16931 and the national CIUS of the country it

52 installs/wk local only

Piku

by usepiku

Find creators and read their Rate Cards. Creators draft quotes and invoices on their Piku account.

13 tools answering

Invoice

by yaktool

Check invoice mandatory fields, validate a draft before issuing, and look up EN 16931 code lists.

62 installs/wk local only

Catalogue

by theluckystrike

A price list and rate card the quotes and invoice servers read by SKU.

12 tools answering

Duebuddy Invoices

by antondrakon

Read incoming supplier invoices through a remote MCP server and get structured data for accounting.

4 tools answering

E-Invoice Map

by einvoicemap

Free, read-only e-invoicing data: mandate dates, Peppol providers, validation-error explainers.

7 tools answering

Invoicepdfs

by invoicepdfs

Render invoices and credit notes as PDFs, and check them against EN 16931 e-invoicing rules.

65 installs/wk answering

Counterfoil — questions

Answers built from our own checks of this server.

What can Counterfoil do?

It exposes 4 tools, read directly from the server on our last check. Among them: check_invoice, explain_error, get_rule, search_rules. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Counterfoil working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 194 ms. The bar chart above shows every period we have measured.

How do I connect Counterfoil?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Counterfoil need an API key?

No. Counterfoil completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 4 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Counterfoil?

It answers our handshake in 194 ms on average, which is faster than 72% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.