{
  "markdown": "# mcp-eureka\n\n<!-- mcp-name: io.github.matematicsolutions/mcp-eureka -->\n\nAn **MCP (Model Context Protocol)** server for the **EUREKA** system of the\nMinisterstwo Finansow / MF (Ministry of Finance) (`eureka.mf.gov.pl`) -\n**550,000+ documents of Polish tax practice**, including **517,000+ individual\ninterpretacje podatkowe (tax interpretations) of the Krajowa Informacja\nSkarbowa / KIS (National Revenue Information)**, general interpretations, tax\nexplanations, and binding rate (WIS) and excise (WIA) information.\n\nThe largest single corpus of tax practice in Poland, available to Claude /\nCursor / VS Code MCP agents with verifiable citations (signature + URL + date).\n\n**Status: v0.1.0** | License: **MIT** | Maintainer: [MateMatic](https://matematicsolutions.com)\n\n> Tax interpretations are not a source of law - they are the practice of\n> authorities (art. 14a-14s of the Tax Ordinance). Legal protection applies to\n> the applicant of a given individual interpretation.\n\n## Data source\n\nThe public JSON API of the EUREKA portal (Angular SPA backend, no key required),\nverified live on 2026-07-08:\n\n- `POST /api/public/v1/wyszukiwarka/informacje/?size=N&page=N&sort=DT_WYD,desc` -\n  search (filters: `SYG`, `KATEGORIA_INFORMACJI` as an array of ids,\n  `DT_WYD_start`/`DT_WYD_end`; `searchQuery` in the body). **The trailing slash\n  before `?` is mandatory** - without it the backend returns HTTP 500.\n- `GET /api/public/v1/informacje/{id}` - full document (metadata + HTML content).\n- `GET /api/public/v1/pozycje-slownika/wyszukiwarka?kodSlownika=KATEGORIA_INFORMACJI` -\n  category dictionary (28 entries).\n\n## MCP tools\n\n- **`search(query?, full_phrase?, signature?, category_ids?, date_from?, date_to?, page?, page_size?)`** -\n  search with filters; sorted by issue date descending.\n- **`get_interpretation(id)`** - full document by ID_INFORMACJI (thesis + first\n  3000 characters of content).\n- **`search_by_signature(signature)`** - shortcut: by signature, full\n  (`0112-KDIL3.4012.367.2026.2.AK`) or prefix (`0112-KDIL3`).\n- **`list_categories()`** - category dictionary (id -> name) for `category_ids`.\n\nEvery response includes `structuredContent.citations` (title, url, signature,\nissue_date) - the contract consumed by [Patron](https://github.com/matematicsolutions/patron)\nand any MCP agent.\n\n## Quickstart\n\n```bash\nnpm install\nnpm run build\nnpm start                # stdio transport\n\nnpm run drift            # consistency INSTRUCTIONS <-> TOOLS <-> ErrorCode\nnpm run test:parse       # offline - fixtures from real API responses\nnpm run smoke            # LIVE - eureka.mf.gov.pl (throttled 2 req/s)\n```\n\nMCP client configuration (`mcp-servers.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"eureka\": {\n      \"command\": \"node\",\n      \"args\": [\"<path>/mcp-eureka/dist/index.js\"]\n    }\n  }\n}\n```\n\n## MateMatic Polish-law connectors\n\n[`mcp-saos`](https://github.com/matematicsolutions/mcp-saos) (common courts/SN/TK/KIO) ·\n[`mcp-nsa`](https://github.com/matematicsolutions/mcp-nsa) (NSA + 16 WSA) ·\n[`mcp-eureka`](https://github.com/matematicsolutions/mcp-eureka) (this one) ·\n[`mcp-isap`](https://github.com/matematicsolutions/mcp-isap) (Dz.U. + M.P.) ·\n[`mcp-krs`](https://github.com/matematicsolutions/mcp-krs) (KRS) ·\n[`kio-orzeczenia-mcp`](https://github.com/matematicsolutions/kio-orzeczenia-mcp) (KIO)\n\nFleet convention: one connector = one source (single-source). Every call returns\na citable source, zero content modification, stateless.\n\n## Disclaimer\n\nThe data comes from the public EUREKA system of the Ministry of Finance. The\nconnector does not modify content, throttles requests (max 2 req/s), and\nidentifies itself with a User-Agent carrying the repo address. Interpreting the\nlaw in a specific case requires your own individual interpretation or the\nopinion of a tax advisor.\n\n## License\n\nMIT - see [LICENSE](./LICENSE).\n\nCitation: *MateMatic Solutions (2026), mcp-eureka - MCP server for Polish tax\ninterpretations (EUREKA/KIS), https://github.com/matematicsolutions/mcp-eureka, MIT.*\n",
  "bytes": 4013,
  "sha": "0029928a14d9c551e9fb7cfa91a1f9b1855504fc8ff6bfd0654e5eed34a61c8f",
  "repo_slug": "matematicsolutions/mcp-eureka",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_matematicsolutions_mcp_eureka_6fc1c102/readme"
}