Skip to content

Platform MCP servers

XTM One embeds a native Model Context Protocol (MCP) server for every connected Filigran platform. This means any MCP-compatible client — Cursor, Claude Desktop, Claude Code, or your own agents — can connect to OpenCTI, OpenAEV, and OpenGRC through XTM One and work with your threat intelligence, exposure validation, and governance-risk-compliance content directly.

This page explains what the platform MCP servers are, where to find them, and how to connect a client.

What you get

One dedicated MCP endpoint per platform:

Endpoint Platform What it exposes
https://<your-xtm-one>/mcp/opencti OpenCTI Threat intelligence knowledge: search, entities (SDOs), observables (SCOs), relationships, indicators, containers (reports, cases, groupings), notes, labels, markings, statistics
https://<your-xtm-one>/mcp/openaev OpenAEV Adversarial exposure validation: scenarios, simulations, payloads, injects, atomic tests, expectations, findings, vulnerabilities, assets, media content, lessons learned, reports
https://<your-xtm-one>/mcp/opengrc OpenGRC Governance, risk & compliance: frameworks, requirements, controls (maturity), assessments, evidence, risk scenarios, attack outcomes, CRQ financial summaries, assets, CVE search

All endpoints use the MCP Streamable HTTP transport, the modern standard supported by all major MCP clients.

Availability

The platform MCP servers are a Community Edition feature. There is nothing to install and nothing extra to license:

  • A server becomes available as soon as the corresponding platform is registered with XTM One — the same registration that powers the embedded "Ask AI" experience in OpenCTI, OpenAEV, and OpenGRC.
  • While no platform of that type is connected, the endpoint simply answers that the platform is not registered.
  • Administrators can turn all platform servers off globally with the Platform MCP Servers toggle in Settings > MCP Endpoint.

Where to find your endpoints

Open My Profile > MCP Endpoint.

The Platform MCP Servers card is always visible there (as long as an administrator has not disabled the feature) and lists every platform server with its live status. For each connected platform it shows:

  • the endpoint URL, with a copy button
  • the live connection status (Connected or Registered)
  • a Config button that copies a ready-to-paste MCP client configuration

A platform that is not yet connected appears dimmed as Not connected, with a reminder that its MCP server activates automatically once the platform is registered with XTM One.

Administrators see the same information, along with the global enable/disable toggle, in Settings > MCP Endpoint.

Authentication

The servers accept a standard bearer token:

  • a personal API key (fcp-...), created in My Profile > API Keys, or
  • an OAuth 2.1 access token — MCP clients that support OAuth discover the authorization flow automatically.

Every tool call runs as you on the platform. XTM One signs a short-lived token for your user (matched by email on the platform side), so your platform permissions, data markings, and audit trail all apply exactly as if you performed the action yourself. The platform's own API token is never stored in or proxied through XTM One.

Connect a client

Copy the configuration from the Config button in your profile, or use this template (keep only the servers you need):

{
  "mcpServers": {
    "opencti": {
      "url": "https://<your-xtm-one>/mcp/opencti",
      "headers": {
        "Authorization": "Bearer fcp-..."
      }
    },
    "openaev": {
      "url": "https://<your-xtm-one>/mcp/openaev",
      "headers": {
        "Authorization": "Bearer fcp-..."
      }
    },
    "opengrc": {
      "url": "https://<your-xtm-one>/mcp/opengrc",
      "headers": {
        "Authorization": "Bearer fcp-..."
      }
    }
  }
}

Where to paste it:

  • Cursor: .cursor/mcp.json in your project (or the global MCP settings)
  • Claude Desktop: claude_desktop_config.json
  • Other clients: any client supporting MCP Streamable HTTP with custom headers

You can verify the connection from a terminal:

curl -s -X POST https://<your-xtm-one>/mcp/opencti \
  -H "Authorization: Bearer fcp-..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

What the tools cover

The tools are the same battle-tested tools used by XTM One agents through the native platform integrations.

For OpenCTI, you can:

  • search and read any STIX entity, observable, relationship, or container
  • create and update entities, observables, indicators, relationships, containers, and notes
  • manage labels, markings, and container membership
  • promote observables to indicators
  • retrieve statistics, top related entities, and modification history

For OpenAEV, you can:

  • search and read scenarios, simulations, payloads, injects, findings, assets, and ATT&CK content
  • create and manage scenarios, simulations, injects, expectations, and atomic tests
  • create and manage payloads, findings, and vulnerabilities
  • work with documents, media channels, articles, challenges, lessons learned, and reports

For OpenGRC, you can:

  • browse tenants, organizations, compliance frameworks, and their requirements
  • read and update controls (including maturity levels) and requirement assessments, and attach evidence
  • create and manage risk scenarios, and read attack outcomes and CRQ financial summaries
  • list primary and supporting assets and search CVEs

OpenGRC is multi-tenant: every tool accepts an optional tenant identifier and resolves your sole tenant automatically when omitted.

What the tools deliberately do not cover

The platform MCP servers expose business and knowledge tools only. Platform administration is out of scope by design:

  • no user, group, role, tenant, or organization management
  • no playbooks, dashboards, or workspace administration
  • no notification, customization, ingestion, or data-sharing configuration
  • no connector or platform settings management

This is enforced server-side with a strict allow-list: a tool that is not explicitly allowed can never be listed or executed through these endpoints.

OpenCTI writes are direct

Knowledge changes made through the OpenCTI MCP server are applied directly to the live knowledge graph, with your user's permissions. The draft-review workflow used by XTM One agents does not apply to MCP clients — review changes on the client side before running write tools.

Troubleshooting

Symptom Meaning What to do
401 Unauthorized Missing or invalid token Check the Authorization header and that your API key is active
403 Forbidden Platform MCP servers are disabled Ask an administrator to enable them in Settings > MCP Endpoint
404 Not Found The platform is not registered with XTM One Connect the OpenCTI / OpenAEV / OpenGRC instance to XTM One first
Tool result contains an error message The platform rejected the call (permissions, invalid input, connectivity) Read the message — it reflects your own permissions on the platform

Good practices

  • Create a dedicated API key per MCP client so you can revoke access independently.
  • Remember that every action is performed as you — write tools modify real platform data.
  • If a tool you expect is missing, it is most likely excluded on purpose (platform administration) rather than misconfigured.

Next step

If you also want to expose XTM One agents (not platform tools) to your MCP clients, continue with the MCP Endpoint tab described in My Profile.