<!-- mcp-name: io.github.mister-franklin/gdpr-decisions -->
# MCP Server — GDPR Decisions

Remote MCP server providing AI-powered access to the largest EU GDPR enforcement decisions database. Search decisions, recommendations, and guidelines from all EU/EEA Data Protection Authorities, CJEU judgments, and EDPB guidelines.

Built by [Mr. Franklin](https://mrfranklin.be) for [The DPO](https://thedpo.eu).

## Features

- **Semantic search** across thousands of GDPR enforcement decisions using legal-domain embeddings (Voyage voyage-law-2)
- **Hybrid search** combining vector similarity, full-text search, and legal source hierarchy weighting
- **Reranking** with Voyage rerank-2.5 for optimal result relevance
- **GDPR article lookup** — find decisions by violated or cited GDPR article
- **Enforcement statistics** — aggregate data on fines, violations, and authority activity
- **Full decision details** including sanctions, controller data, and GDPR article references

## MCP Tools

| Tool | Description |
|------|-------------|
| `search_gdpr_decisions` | Semantic search with optional jurisdiction filter |
| `get_decision_detail` | Full decision details by ID |
| `search_by_gdpr_article` | Find decisions by GDPR article number |
| `get_gdpr_statistics` | Aggregate enforcement statistics |

## Getting Started

### 1. Get an API key

Sign up at [thedpo.eu/mcp](https://thedpo.eu/mcp) to get your API key. Free tier includes 3 advice sessions per month.

### 2. Add to Claude Desktop

Add to your Claude Desktop config (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "gdpr-decisions": {
      "command": "uvx",
      "args": ["mcp-server-gdpr-decisions"],
      "env": {
        "GDPR_API_KEY": "sk_free_your_key_here"
      }
    }
  }
}
```

### 3. Use in Claude

Ask Claude questions like:
- "What are the largest GDPR fines in 2024?"
- "Find decisions about consent for cookies"
- "Which DPA decisions cite Article 6 GDPR?"
- "Give me enforcement statistics for Belgium"

## Pricing

| Tier | Sessions/month | Price |
|------|---------------|-------|
| Free | 3 | Free |
| Pro | Unlimited | See [thedpo.eu/mcp](https://thedpo.eu/mcp) |

A session is a 15-minute window. Follow-up questions within the same session don't count as new sessions.

## License

MIT