mcp-eureka
This server provides access to 550,000+ Polish tax practice documents from the Ministry of Finance's EUREKA system, enabling search and retrieval of tax interpretations and related documents.
search— Full-text search with flexible filters: keyword/phrase queries, document signature (full or prefix), category IDs, date range (date_from/date_to), and pagination. Results are sorted by issue date descending.get_interpretation— Retrieve a complete document by numeric ID, including metadata (signature, category, dates), legal thesis, and the first 3,000 characters of content (HTML stripped to plain text).search_by_signature— Shortcut to quickly find a document by its full or partial signature without using the full search interface.list_categories— Retrieve the dictionary of 28 document categories (id → name), covering individual interpretations (517,000+), general interpretations, tax explanations, WIS (binding rate information), WIA (binding excise information), and more — used as filters insearch.
Every response includes structured citation metadata (title, URL, signature, issue date) for traceability.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-eureka find interpretation on VAT for software"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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:
POST /api/public/v1/wyszukiwarka/informacje/?size=N&page=N&sort=DT_WYD,desc- search (filters:SYG,KATEGORIA_INFORMACJIas an array of ids,DT_WYD_start/DT_WYD_end;searchQueryin the body). The trailing slash before?is mandatory - without it the backend returns HTTP 500.GET /api/public/v1/informacje/{id}- full document (metadata + HTML content).GET /api/public/v1/pozycje-slownika/wyszukiwarka?kodSlownika=KATEGORIA_INFORMACJI- category dictionary (28 entries).
Related MCP server: mcp-nsa
MCP tools
search(query?, full_phrase?, signature?, category_ids?, date_from?, date_to?, page?, page_size?)- search with filters; sorted by issue date descending.get_interpretation(id)- full document by ID_INFORMACJI (thesis + first 3000 characters of content).search_by_signature(signature)- shortcut: by signature, full (0112-KDIL3.4012.367.2026.2.AK) or prefix (0112-KDIL3).list_categories()- category dictionary (id -> name) forcategory_ids.
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.
Citation: MateMatic Solutions (2026), mcp-eureka - MCP server for Polish tax interpretations (EUREKA/KIS), https://github.com/matematicsolutions/mcp-eureka, MIT.
Available Tools
4 toolsget_interpretationARead-onlyIdempotent
Pobiera pelny dokument EUREKA po ID_INFORMACJI (z wynikow 'search'). Zwraca metadane (sygnatura, kategoria, daty), teze i pierwsze 3000 znakow pelnej tresci (HTML odarty do tekstu). Bledy: missing_arg (brak id), not_found (id poza baza), upstream_error.
Inputs: id (required).
list_categoriesARead-onlyIdempotent
Zwraca slownik kategorii dokumentow EUREKA (id -> nazwa, 28 pozycji): interpretacje indywidualne/ogolne, objasnienia podatkowe, WIS, WIA, orzeczenia sadow itd. Uzyj id w parametrze category_ids narzedzia search. Bledy: upstream_error.
Inputs: no named parameters.
searchARead-onlyIdempotent
Przeszukuje EUREKA (eureka.mf.gov.pl) - 550 000+ dokumentow praktyki podatkowej Ministerstwa Finansow i KIS: interpretacje indywidualne (517 000+), interpretacje ogolne, objasnienia podatkowe, WIS, WIA. Fraza (query) szuka slow niezaleznie; filtry: sygnatura (takze prefiks), kategoria (category_ids ze slownika list_categories), zakres dat wydania. Wyniki sortowane data wydania malejaco. Bledy: invalid_filter (zly filtr), upstream_error (HTTP/timeout).
Inputs: page, query, date_to, date_from, +4 more.
search_by_signatureARead-onlyIdempotent
Skrot: szuka dokumentu po sygnaturze (pelnej lub prefiksie). Odpowiednik search z parametrem signature. Bledy: missing_arg (brak signature), upstream_error.
Inputs: signature (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Tools are mostly distinct: search by query, search_by_signature is a convenient shortcut, get_interpretation for full document, list_categories for filter options. However, search_by_signature overlaps with search with a signature parameter, which could cause confusion about which to use.
All tool names follow a consistent snake_case verb_noun pattern: get_interpretation, list_categories, search, search_by_signature. The naming is clear and predictable.
4 tools are appropriate for the server's purpose: searching and retrieving tax interpretation documents. The set is well-scoped without unnecessary bloat.
Covers core read-only operations: searching with filters, retrieving full content, and category listing. Missing pagination support for search results and full content retrieval beyond 3000 characters, but these are minor for typical use.
Maintenance
Related MCP Connectors
Poland public procurement MCP — official e-Zamówienia notice feed (keyless).
MCP server for FCA Handbook compliance analysis with verbatim citations.
Taxyearvo: the site's own MCP server — dataset; every answer cites the site.
EUR-Lex MCP — official EU law, article-level.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server that provides access to Polish individual tax interpretations (KIS) via the official EUREKA API, enabling search and retrieval of rulings with signatures, theses, and full text.45MIT
- AlicenseAqualityCmaintenanceMCP server for Polish administrative case-law (NSA + regional administrative courts, CBOSA) with ECLI and verifiable citations.3139 npmMIT
- AlicenseAqualityCmaintenanceMCP server for Polish legislation (ISAP / Sejm) — search acts (Dz.U., M.P.) and fetch full texts with ELI identifiers and verifiable citations.3141 npm1MIT
- FlicenseAqualityDmaintenanceMCP server for searching and retrieving contracts from the Polish Central Register of Contracts (CRU) via its API.2-