# mcp-eureka

mcp-eureka is an MCP server for Claude Code that searches Poland’s EUREKA tax database and returns document references. Agents can query by text, signature, category, or date.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: matematicsolutions
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/matematicsolutions/mcp-eureka
- Updated: 2026-09-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-eureka

## What it does

mcp-eureka connects an agent to the Polish Ministry of Finance’s public EUREKA system. It searches tax-practice documents and can fetch a full record by its ID.

Tools cover text search, signature lookup, category listing, and filters for categories and dates. Results include a title, URL, signature, and issue date. No API key is required for the public EUREKA API. Tax interpretations are not law, and protection from an individual interpretation applies to its applicant.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-eureka -- npx -y @matematicsolutions/mcp-eureka
```

### Codex

**Platform CLI**
```bash
codex mcp add mcp-eureka -- npx -y @matematicsolutions/mcp-eureka
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-eureka": {
            "command": "npx",
            "args": [
                "-y",
                "@matematicsolutions/mcp-eureka"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-eureka": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@matematicsolutions/mcp-eureka"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-eureka npx -y @matematicsolutions/mcp-eureka
```

## When to use it
- find Polish tax interpretations by query
- look up a document by its full signature or prefix
- narrow results by category and date
- retrieve a document’s citation details

## Example prompts
- Find EUREKA interpretations about rental income taxation.
- Look up documents with signature prefix `0112-KDIL3`.
- List the available tax information categories.

## Similar
- [app-marketplace-monetization-model](https://affpapa.org/en/nevibecode/skills/app-marketplace-monetization-model.md) — skill · 10500 installs
- [connector-quickbooks](https://affpapa.org/en/nevibecode/skills/connector-quickbooks.md) — skill · 10200 installs
- [trading-strategies](https://affpapa.org/en/nevibecode/skills/trading-strategies.md) — skill · 1300 installs
- [catalyst-pricing](https://affpapa.org/en/nevibecode/skills/catalyst-pricing.md) — skill · 1200 installs
- [use-arc](https://affpapa.org/en/nevibecode/skills/use-arc.md) — skill · 1100 installs
- [use-modular-wallets](https://affpapa.org/en/nevibecode/skills/use-modular-wallets.md) — skill · 1000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
