Allows AI clients to search and retrieve over 550,000 Polish tax practice documents and individual interpretations from the Ministry of Finance EUREKA system.
Also known as matematicsolutions/mcp-eureka, @matematicsolutions/mcp-eureka
- Stars
- 5
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Sep 24, 2026
- License
- MIT
What is Eureka MCP?
Eureka allows AI clients to search and retrieve over 550,000 Polish tax practice documents and individual interpretations from the Ministry of Finance EUREKA system. It exposes 4 tools, such as search, get_interpretation, search_by_signature.
Summary generated from the project's README
About Eureka MCP server
Accessing Polish tax practice documents directly from Claude, Cursor, or VS Code is what this server enables for legal and financial professionals. It connects AI agents to the Ministry of Finance EUREKA system, providing a way to query a massive database containing over 550,000 documents. This includes more than 517,000 individual tax interpretations from the National Revenue Information, along with general interpretations, tax explanations, and excise information.
Users interact with the system through specific tools like search, get_interpretation, search_by_signature, and list_categories. The server operates via stdio transport and connects to a public API that requires no API keys or special accounts. It is designed to provide verifiable citations, including signatures, URLs, and dates, for every piece of information retrieved. To maintain stability, the server throttles requests to a maximum of two per second.
What you can do with it
- 1Searching for specific tax interpretationsA developer can ask an AI agent to find tax interpretations using specific search queries, categories, or date ranges.
- 2Retrieving full document detailsAn AI client can pull the complete metadata and the initial content of a specific interpretation using its unique ID.
Written from the project's README. Every use case is checked against a quote from it.
How to install Eureka MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Eureka MCP in Claude Code
$ claude mcp add mcp-eureka -- npx -y @matematicsolutions/mcp-eurekaInstall Eureka MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-eureka": {
"command": "npx",
"args": [
"-y",
"@matematicsolutions/mcp-eureka"
]
}
}
}Install Eureka MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-eureka": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@matematicsolutions/mcp-eureka"
]
}
}
}Install Eureka MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-eureka","type":"stdio","command":"npx","args":["-y","@matematicsolutions/mcp-eureka"]}'Install Eureka MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-eureka": {
"command": "npx",
"args": [
"-y",
"@matematicsolutions/mcp-eureka"
]
}
}
}Install Eureka MCP in Codex
$ codex mcp add mcp-eureka -- npx -y @matematicsolutions/mcp-eurekaInstall Eureka MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-eureka] command = "npx" args = ["-y", "@matematicsolutions/mcp-eureka"]
Install Eureka MCP in Gemini CLI
$ gemini mcp add -s user mcp-eureka npx -- -y @matematicsolutions/mcp-eurekaInstall Eureka MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-eureka": {
"command": "npx",
"args": [
"-y",
"@matematicsolutions/mcp-eureka"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @matematicsolutions/mcp-eureka 0.2.0 in an isolated container with no network and no keys. It answered and listed 4 tools.
Eureka MCP tools 4
Read from the server with tools/listsearchRead-onlyPrzeszukuje 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).
get_interpretationRead-onlyPobiera 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`.
search_by_signatureRead-onlySkrot: szuka dokumentu po sygnaturze (pelnej lub prefiksie). Odpowiednik search z parametrem signature. Bledy: `missing_arg` (brak signature), `upstream_error`.
list_categoriesRead-onlyZwraca 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`.
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablematematicsolutions/mcp-eureka is public and reachablegithub.com/matematicsolutions/mcp-eureka ↗Pass
- Package names this repository as its source@matematicsolutions/mcp-eureka names matematicsolutions/mcp-eureka as sourcenpmjs.com/package/@matematicsolutions/mcp-eureka ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @matematicsolutions/mcp-eurekanpmjs.com/package/@matematicsolutions/mcp-eureka/v/0.2.0#pro ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-24github.com/matematicsolutions/mcp-eureka ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @matematicsolutions/mcp-eurekaPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubmcp-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).
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.
Eureka MCP questions
How do I add Eureka MCP to Claude Code?
Run claude mcp add mcp-eureka -- npx -y @matematicsolutions/mcp-eureka in your terminal. Add --scope user to make it available in every project.
How do I add Eureka MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Eureka MCP provide?
It exposes 4 tools, including search, get_interpretation, search_by_signature, list_categories.
Does the server provide citations for the tax data?
Yes, every response includes structured citations containing the title, URL, signature, and issue date.
Is an API key required to use the EUREKA data?
No, the server uses the public JSON API of the EUREKA portal which does not require a key.