{
  "markdown": "# opensanctions-mcp\n\nMCP server for sanctions screening and PEP checks via the [OpenSanctions](https://www.opensanctions.org/) API.\n\nLets AI agents (Claude, Cursor, Windsurf, GPT) screen persons and companies against 320+ sanctions and PEP lists from OFAC, EU, UN, UK HMT, and more.\n\n> **Disclaimer:** This tool provides informational data only. It is not legal or compliance advice. Always verify matches with official sources before taking action.\n\n## Quick Start\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"opensanctions\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"opensanctions-mcp\"],\n      \"env\": {\n        \"OPENSANCTIONS_API_KEY\": \"your-key-here\"\n      }\n    }\n  }\n}\n```\n\nGet a free API key at [opensanctions.org/api](https://www.opensanctions.org/api/).\n\n### Where to add this config\n\n- **Claude Desktop:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows)\n- **Cursor:** Settings > MCP Servers\n- **Windsurf:** `~/.windsurf/config.json`\n\n## Tools\n\n### search_entities\n\nSearch the OpenSanctions database by name or keyword.\n\n```\n\"Search for entities named Viktor Bout\"\n\"Find companies related to Iran sanctions\"\n```\n\n### match_entity\n\nScreen a person or company against sanctions and PEP lists using structured properties. This is the primary screening tool.\n\n```\n\"Screen Viktor Bout, born 1967-01-13, Russian national, against sanctions lists\"\n\"Check if Acme Corp is on any EU sanctions list\"\n```\n\n### get_entity\n\nFetch complete details for a specific entity, including relationships to other entities (companies, associates, family members).\n\n```\n\"Get full details for entity NK-2Ciy8EG7jz1YHMGCxYLb25\"\n```\n\n### list_datasets\n\nList available sanctions and PEP datasets. No API key required.\n\n```\n\"What sanctions lists are available?\"\n\"Show me EU-related datasets\"\n```\n\n### get_dataset\n\nGet details about a specific dataset (publisher, entity count, last updated). No API key required.\n\n```\n\"Tell me about the OFAC SDN list\"\n```\n\n### investigate_entity\n\nRun a full compliance investigation in one call: match, fetch details, map relationships, and return structured data.\n\n```\n\"Investigate Viktor Bout for sanctions exposure\"\n\"Run a compliance check on Acme Corp, jurisdiction Belgium\"\n```\n\n## Configuration\n\n| Environment Variable | Required | Default | Description |\n|---|---|---|---|\n| `OPENSANCTIONS_API_KEY` | Yes* | — | API key for the hosted OpenSanctions API. Get one at [opensanctions.org/api](https://www.opensanctions.org/api/). |\n| `OPENSANCTIONS_API_URL` | No | `https://api.opensanctions.org` | API URL. Set to your self-hosted yente instance. |\n| `OPENSANCTIONS_DATASET` | No | `default` | Dataset to screen against. `default` includes all 320+ sources. |\n| `OPENSANCTIONS_MAX_RETRIES` | No | `3` | Max retries for failed API calls. |\n| `DEBUG` | No | — | Set to any value to enable debug logging. |\n\n*Not required for `list_datasets`, `get_dataset`, or when using a self-hosted yente instance without auth.\n\n## Self-hosted yente\n\nIf you run your own [yente](https://github.com/opensanctions/yente) instance, point the server at it:\n\n```json\n{\n  \"mcpServers\": {\n    \"opensanctions\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"opensanctions-mcp\"],\n      \"env\": {\n        \"OPENSANCTIONS_API_URL\": \"http://localhost:8000\"\n      }\n    }\n  }\n}\n```\n\nNo API key needed for self-hosted yente.\n\n## Development\n\n```bash\ngit clone https://github.com/scka-de/opensanctions-mcp.git\ncd opensanctions-mcp\nnpm install\nnpm test          # run tests (fixtures, no API key needed)\nnpm run build     # compile to dist/\nnpm run dev       # run in dev mode\nnpm run lint      # check code style\n```\n\n## License\n\nMIT\n",
  "bytes": 3730,
  "sha": "e2275d51e1af38e585996aa5072373a527676bdadc01bbd16d6687fa475247ad",
  "repo_slug": "scka-de/opensanctions-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_scka_de_opensanctions_mcp_5ed83280/readme"
}