Documentation/MCP Server

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 list

Or add it with the Codex CLI:

codex mcp add threat-landscape \
  --url https://mcp.threatlandscape.io/mcp \
  --bearer-token-env-var THREAT_LANDSCAPE_API_KEY

Generic 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

ToolUse
tl_search_bundlesFlexible bundle search with structured filters.
tl_get_bundleRetrieve the complete STIX bundle for a bundle ID.
tl_get_threat_intelQuery by actor, malware, CVE, TTP, campaign, victim, sector or country.
tl_free_text_searchKeyword search across titles, summaries and extracted entities.
tl_lookup_iocCheck whether a value is a known IOC.
tl_get_active_iocsFetch active indicators, optionally by type.
tl_ioc_syncIncremental IOC sync using a seq_id watermark.
tl_ioc_contextRetrieve 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 Bearer format.
  • 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 →

Related guides