MCP Server
The Threat Landscape MCP server gives MCP-compatible agents direct access to STIX 2.1 intelligence bundles and actionable IOCs. There is no server to install. The endpoint is already deployed.
Server URL: https://mcp.threatlandscape.io/mcp
Authentication: Authorization: Bearer YOUR_THREATLANDSCAPE_API_KEY
Claude Desktop
Add this to claude_desktop_config.json under mcpServers:
{
"mcpServers": {
"threat-landscape": {
"type": "streamable-http",
"url": "https://mcp.threatlandscape.io/mcp",
"headers": {
"Authorization": "Bearer tl_your_api_key_here"
}
}
}
}Restart Claude Desktop. The threat-landscape server should appear in the tools panel.
Codex
Add the remote server to ~/.codex/config.toml and read the token from an environment variable:
[mcp_servers.threat-landscape]
url = "https://mcp.threatlandscape.io/mcp"
bearer_token_env_var = "THREAT_LANDSCAPE_API_KEY"Export the key in the shell that launches Codex:
export THREAT_LANDSCAPE_API_KEY="tl_your_api_key_here"
codex mcp listOr add it with the Codex CLI:
codex mcp add threat-landscape \
--url https://mcp.threatlandscape.io/mcp \
--bearer-token-env-var THREAT_LANDSCAPE_API_KEYGeneric MCP client
{
"mcpServers": [
{
"name": "threat-landscape",
"transport": {
"type": "streamable-http",
"url": "https://mcp.threatlandscape.io/mcp",
"requestInit": {
"headers": {
"Authorization": "Bearer tl_your_api_key_here"
}
}
}
}
]
}Available tools
| Tool | Use |
|---|---|
tl_search_bundles | Flexible bundle search with structured filters. |
tl_get_bundle | Retrieve the complete STIX bundle for a bundle ID. |
tl_get_threat_intel | Query by actor, malware, CVE, TTP, campaign, victim, sector or country. |
tl_free_text_search | Keyword search across titles, summaries and extracted entities. |
tl_lookup_ioc | Check whether a value is a known IOC. |
tl_get_active_iocs | Fetch active indicators, optionally by type. |
tl_ioc_sync | Incremental IOC sync using a seq_id watermark. |
tl_ioc_context | Retrieve the full STIX indicator bundle for a value. |
Example prompts
- “What malware is targeting the Finance sector in the United States?”
- “Which actors are actively exploiting CVE-2025-27152?”
- “Pull the 20 most recent extortion posts from ransomware leak sites.”
- “Retrieve all active malicious domains for DNS sinkholing.”
- “Retrieve the STIX pattern and TLP markings for evil.example.com.”
Troubleshooting
- Unauthorized: check the key and the exact
Bearerformat. - No results: the query returned zero matches. Broaden the filters.
- Rate limited: reduce request frequency or upgrade the plan.
- Tools missing: restart the client after changing the MCP configuration.
Full reference
Read the complete MCP server reference on GitHub →