# Team Cymru MCP

> Four MCP servers exposing Team Cymru's real-time threat intelligence to AI agents and coding tools. Covers IP reputation, attack surface monitoring, ASN/BGP ownership, and threat tag definitions. For AI agent integration use https://mcp.cymru.com/building-with-ai.md — for human setup see https://mcp.cymru.com/docs.html

## MCP Servers

- [Scout](https://scout-mcp.cymru.com/mcp): Investigate any IP — reputation, threat tags, communication history, passive DNS. Tools: search, get_ip_details, get_ip_foundation, get_ip_comms_aggregate, export_tags, get_usage, get_scout_query_help. Auth header: X-Scout-API-Key
- [Radar](https://radar-mcp.cymru.com/mcp): Discover and monitor external attack surface — exposed assets, CVEs, shadow IT. Tools: get_jobs, get_job, get_job_ips, get_job_cidrs, get_job_hostnames, get_job_relations, get_api_usage. Auth header: X-Radar-API-Key
- [ASN Enricher](https://asn-enricher-mcp.cymru.com/mcp): Identify who owns any IP or network — organization, country, ASN, BGP prefix. Tools: asn_info, ip_to_asn, prefix_to_asn, asn_to_ip_prefixes. Auth header: X-ASN-Enricher-API-Key
- [Scout Tags](https://scout-tags-mcp.cymru.com/mcp): Look up Team Cymru threat tag definitions, related tags, and hierarchies. Tools: search_tags, get_tag_details. Auth header: X-Scout-Tags-API-Key

## Authentication

All servers require three HTTP headers: X-<Server>-API-Key (your API key), X-User-Context-ID (your user identifier), and X-Log-PII-Opt-In: true. ChatGPT uses OAuth instead of API keys. No credentials yet: https://www.team-cymru.com/contact-sales

## Setup Guides

- [Claude Code](https://mcp.cymru.com/building-with-ai.md): claude mcp add --transport=http with --header flags
- [Claude Desktop](https://mcp.cymru.com/building-with-ai.md): OAuth via custom connector, or API key via uvx mcp-proxy in claude_desktop_config.json
- [Cursor](https://mcp.cymru.com/building-with-ai.md): headers block in .cursor/mcp.json
- [ChatGPT](https://mcp.cymru.com/building-with-ai.md): OAuth only via Settings → Apps & Connectors
- [Gemini CLI](https://mcp.cymru.com/building-with-ai.md): gemini mcp add --transport=http with --header flags
- [Codex CLI](https://mcp.cymru.com/building-with-ai.md): uvx mcp-proxy via codex mcp add
- [OpenAI SDK](https://mcp.cymru.com/building-with-ai.md): type: mcp tool block in responses.create with headers dict

## Reference

- [Building with Team Cymru AI](https://mcp.cymru.com/building-with-ai.md): Complete setup guide — all servers, tools, authentication, and client-specific configuration (Claude Code, Claude Desktop, Cursor, ChatGPT, Gemini CLI, Codex, OpenAI SDK)
- [Full documentation](https://mcp.cymru.com/docs.html)
- [Team Cymru](https://www.team-cymru.com)
- [Request access](https://www.team-cymru.com/contact-sales)