Eureka MCP server

mcp-eureka

<!-- mcp-name: io.github.matematicsolutions/mcp-eureka -->

An MCP (Model Context Protocol) server for the EUREKA system of the Ministerstwo Finansow / MF (Ministry of Finance) (eureka.mf.gov.pl) - 550,000+ documents of Polish tax practice, including 517,000+ individual interpretacje podatkowe (tax interpretations) of the Krajowa Informacja Skarbowa / KIS (National Revenue Information), general interpretations, tax explanations, and binding rate (WIS) and excise (WIA) information.

The largest single corpus of tax practice in Poland, available to Claude / Cursor / VS Code MCP agents with verifiable citations (signature + URL + date).

Status: v0.1.0 | License: MIT | Maintainer: MateMatic

Tax interpretations are not a source of law - they are the practice of

authorities (art. 14a-14s of the Tax Ordinance). Legal protection applies to

the applicant of a given individual interpretation.

Data source

The public JSON API of the EUREKA portal (Angular SPA backend, no key required), verified live on 2026-07-08:

search (filters: SYG, KATEGORIAINFORMACJI as an array of ids, DTWYDstart/DTWYDend; searchQuery in the body). The trailing slash before ? is mandatory** - without it the backend returns HTTP 500.

• POST /api/public/v1/wyszukiwarka/informacje/?size=N&page=N&sort=DT_WYD,desc -

category dictionary (28 entries).

• GET /api/public/v1/informacje/{id} - full document (metadata + HTML content).
• GET /api/public/v1/pozycje-slownika/wyszukiwarka?kodSlownika=KATEGORIA_INFORMACJI -

MCP tools

search with filters; sorted by issue date descending.

• search(query?, fullphrase?, signature?, categoryids?, datefrom?, dateto?, page?, pagesize?)** -

3000 characters of content).

• getinterpretation(id) - full document by IDINFORMACJI (thesis + first

(0112-KDIL3.4012.367.2026.2.AK) or prefix (0112-KDIL3).

• searchbysignature(signature) - shortcut: by signature, full

• listcategories() - category dictionary (id -> name) for categoryids.

Every response includes structuredContent.citations (title, url, signature, issue_date) - the contract consumed by Patron and any MCP agent.

Quickstart

npm install
npm run build
npm start                # stdio transport

npm run drift            # consistency INSTRUCTIONS <-> TOOLS <-> ErrorCode
npm run test:parse       # offline - fixtures from real API responses
npm run smoke            # LIVE - eureka.mf.gov.pl (throttled 2 req/s)

MCP client configuration (mcp-servers.json):

{
  "mcpServers": {
    "eureka": {
      "command": "node",
      "args": ["<path>/mcp-eureka/dist/index.js"]
    }
  }
}

MateMatic Polish-law connectors

mcp-saos (common courts/SN/TK/KIO) · mcp-nsa (NSA + 16 WSA) · mcp-eureka (this one) · mcp-isap (Dz.U. + M.P.) · mcp-krs (KRS) · kio-orzeczenia-mcp (KIO)

Fleet convention: one connector = one source (single-source). Every call returns a citable source, zero content modification, stateless.

Disclaimer

The data comes from the public EUREKA system of the Ministry of Finance. The connector does not modify content, throttles requests (max 2 req/s), and identifies itself with a User-Agent carrying the repo address. Interpreting the law in a specific case requires your own individual interpretation or the opinion of a tax advisor.

License

MIT - see LICENSE.

Shortened. The full README is on GitHub.