@euaiactready/mcp

Model Context Protocol (MCP) server for EU AI Act Ready — AI compliance classification and documentation.

Tools

| Tool | Description | API Endpoint | |------|-------------|-------------| | classify_ai_system | Classify an AI system under the EU AI Act | POST /api/v1/classify | | full_assessment | Create a full compliance assessment (saved to DB) | POST /api/v1/assessments | | get_assessment | Retrieve an existing assessment by ID | GET /api/v1/assessments/:id | | generate_annex_iv | Generate Annex IV technical documentation | POST /api/v1/assessments/:id/annex-iv | | get_obligations | Get compliance obligations by article | GET /api/v1/obligations | | check_deadlines | Check compliance deadlines | GET /api/v1/deadlines | | list_client_assessments | List assessments for a consultant client | GET /api/v1/clients/:id/assessments | | Agent Audit Logging — Article 12 | | | | log_agent_action | Record a single agent event with PII redaction and integrity chain | POST /api/v1/agent-logs | | log_agent_batch | Record a batch of agent events (up to 100) | POST /api/v1/agent-logs/batch | | get_agent_logs | Query agent audit logs with filters and pagination | GET /api/v1/agent-logs | | get_agent_stats | Get aggregated statistics for an agent | GET /api/v1/agent-logs/stats | | Agent & Assessment Management | | | | register_agent | Register a new AI agent for Article 12 audit logging | POST /api/v1/agents | | list_agents | List all registered AI agents for the current API key owner | GET /api/v1/agents | | list_assessments | List risk assessments for the current user (paginated, filterable) | GET /api/v1/assessments | | Regulatory & Compliance | | | | get_regulatory_updates | Get published EU AI Act regulatory updates and guidance | GET /api/regulatory-updates | | generate_fria | Generate a Fundamental Rights Impact Assessment (costs 10 credits) | POST /api/v1/assessments/:id/fria |

Setup

1. Get an API Key

Sign up at euaiactready.tech and create an API key in Settings > API Keys.

Required scopes depend on which tools you use:

• classify — for classify_ai_system
• assessments:read, assessments:write — for assessment tools
• documents:generate — for generate_annex_iv
• clients:read — for list_client_assessments
• agent-logs:write — for log_agent_action, log_agent_batch
• agent-logs:read — for get_agent_logs, get_agent_stats

2. Configure Your MCP Client

Install via npm. @euaiactready/mcp is published on npm, so the npx @euaiactready/mcp configurations below work as-is — your MCP client downloads and runs the package automatically. Prefer building from source? Clone this repository, npm install && npm run build in packages/mcp-server, and point your MCP client's command/args at the built dist/index.js (see Development below).

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "euaiactready": {
      "command": "npx",
      "args": ["@euaiactready/mcp"],
      "env": {
        "EUAIACTREADY_API_KEY": "euar_your_api_key_here"
      }
    }
  }
}

Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "euaiactready": {
      "command": "npx",
      "args": ["@euaiactready/mcp"],
      "env": {
        "EUAIACTREADY_API_KEY": "euar_your_api_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "euaiactready": {
      "command": "npx",
      "args": ["@euaiactready/mcp"],
      "env": {
        "EUAIACTREADY_API_KEY": "euar_your_api_key_here"
      }
    }
  }
}

3. Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | EUAIACTREADY_API_KEY | Yes | Your API key (starts with euar_) | | EUAIACTREADY_BASE_URL | No | API base URL (default: https://euaiactready.tech) |

Usage Examples

Once configured, you can ask your AI assistant:

• "Classify my AI system that uses facial recognition for access control"
• "What are the upcoming EU AI Act compliance deadlines?"
• "Generate Annex IV documentation for assessment abc-123"
• "What obligations apply under Article 9 of the EU AI Act?"
• "Log this tool call from my customer support agent"
• "Show me the last 50 audit logs for agent abc-123"
• "What are the error rates for my agent over the last 30 days?"

Development

cd packages/mcp-server
npm install
npm run build
npm start

License

MIT