Mcp Eureka

io.github.matematicsolutionsPublished by GitHub account matematicsolutionsv0.2.0Updated Oct 24, 2026

MCP server for Polish tax interpretations (KIS/MF) via EUREKA with citations.

The publisher's own server: Eureka EHR

VerifiedSTDIODesktop onlyFinance Knowledge & Memory

Server details

Identifier: io.github.matematicsolutions/mcp-eureka
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account matematicsolutions for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.matematicsolutions%2Fmcp-eureka.svg)](https://sourceweft.com/mcp/io.github.matematicsolutions%2Fmcp-eureka?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server that lets an assistant search and read Polish tax interpretations and other EUREKA documents from the Ministry of Finance, with citations.

What you can do: Search EUREKA documents by query, phrase, category, signature or date range, sorted by issue date descending and paginated. Retrieve a full document by its ID, including thesis and the first part of the content. Look up documents by full or partial signature. List the category dictionary used for filtering. Every response carries citations with title, URL, signature and issue date.
When to use it: Useful when an assistant needs to find Polish tax interpretations, general interpretations, tax explanations or WIS/WIA information and cite them. It is aimed at tax and legal research on Polish practice, not at general web search.
Requirements: Runs locally over stdio as an npm package started with npx or node. No API key, account, environment variable or header is declared. It calls the public EUREKA JSON API, so network access to the Ministry of Finance portal is needed.

Before you install

It sends search queries to the public EUREKA portal, a third party. Interpretations are practice of the authorities, not a source of law, and legal protection applies only to the applicant of a given interpretation; the README advises getting your own interpretation or a tax advisor's opinion. The server is at version 0.1.0.

Installation

In SourceWeft

Open Mcp Eureka in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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_INFORMACJI as an array of ids, DT_WYD_start/DT_WYD_end; searchQuery in 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) for category_ids.

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

Quickstart

bash

npm installnpm run buildnpm start                # stdio transport
npm run drift            # consistency INSTRUCTIONS <-> TOOLS <-> ErrorCodenpm run test:parse       # offline - fixtures from real API responsesnpm run smoke            # LIVE - eureka.mf.gov.pl (throttled 2 req/s)

npm installnpm run buildnpm start                # stdio transport
npm run drift            # consistency INSTRUCTIONS <-> TOOLS <-> ErrorCodenpm run test:parse       # offline - fixtures from real API responsesnpm run smoke            # LIVE - eureka.mf.gov.pl (throttled 2 req/s)

MCP client configuration (mcp-servers.json):

json

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

{  "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.

Source: README.md at commit de3e64e

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Other Eureka integrations

Eureka EHR

md.eurekaOfficial publisher

Remote MCP server exposing the Eureka EHR — patients, schedule, notes, messages, billing and orders — as tools an assistant can call.

Streamable HTTPWeb executableAuth

Location & LifestyleCredential requiredOct 24, 2026