Product MCP

Org-scoped Intertrace tools over Streamable HTTP at /mcp. Clerk authenticates humans; Intertrace issues MCP tokens.

Two MCP URLs

Product MCP (https://platform.intertrace.ai/mcp) is Intertrace as a server: findings, assets, authorize, HITL. Identity is Clerk for the consent screen; the MCP client then uses an Intertrace token (itm_…), not a Clerk access token.

Gateway MCP proxy (https://intertrace.fly.dev/mcp) is how you send your agents through Intertrace to customer MCP servers. See MCP servers.

Connect

Remote MCP URL: https://platform.intertrace.ai/mcp. OAuth 2.1 with PKCE S256. Resource indicator: the same URL. Scopes: mcp:read, mcp:write, mcp:authorize, offline_access.

  1. 1

    Claude.ai

    Settings → Connectors → Add custom connector named Intertrace. URL https://platform.intertrace.ai/mcp. Sign in with Clerk; Intertrace issues itm_… tokens.

  2. 2

    ChatGPT

    Settings → Apps & Connectors → add a custom MCP connector. Same URL. Do not paste a Clerk or OpenAI JWT.

  3. 3

    Cursor / Claude Code

    Add the snippet below. OAuth is discovered from the 401 WWW-Authenticate challenge.

{
  "mcpServers": {
    "intertrace": {
      "url": "https://platform.intertrace.ai/mcp"
    }
  }
}

Cursor and Claude Code discover OAuth from the 401 WWW-Authenticate challenge. API keys work as Authorization: Bearer on the same URL.

curl -sS -D - https://platform.intertrace.ai/mcp \
  -H "Authorization: Bearer itm_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"docs","version":"1"}}}'

curl -sS https://platform.intertrace.ai/mcp \
  -H "Authorization: Bearer itm_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Revoke clients in Settings → MCP. Calls share the org monthly request quota (gateway_requests).

Tools

Every tool is org-scoped. Auth is headers only — never put tokens in arguments. Writes need mcp:write; authorize needs mcp:authorize.

  • intertrace_health Intertrace healthPublic Intertrace control-plane health (database, ingest, runtime). No tenant data.(mcp:read)
  • intertrace_whoami Who am IReturn the authenticated organization, role, scopes, and auth source for this MCP session.(mcp:read)
  • intertrace_list_traces List tracesList recent Intertrace telemetry traces for the authenticated organization.(mcp:read)
  • intertrace_get_trace Get traceFetch one telemetry trace by id if it belongs to the authenticated organization.(mcp:read)
  • intertrace_list_findings List findingsList Intertrace findings with optional status, source, and severity filters.(mcp:read)
  • intertrace_get_finding Get findingFetch one finding with prompt fields revealed according to the caller's role.(mcp:read)
  • intertrace_list_assets List assetsList AI assets in the authenticated organization (secrets redacted).(mcp:read)
  • intertrace_get_asset Get assetFetch one AI asset. Provider API keys are never returned in plaintext.(mcp:read)
  • intertrace_discovery_coverage Discovery coverageConnector fidelity coverage: configured vs fixture vs live, plus estate gaps.(mcp:read)
  • intertrace_list_gateway_keys List gateway ingest keysList gateway ingest keys (key id / prefix only). Never returns signing secrets.(mcp:read)
  • intertrace_list_mcp_inventory List MCP inventoryList customer MCP servers Intertrace governs (upstream URLs, not vault credentials).(mcp:read)
  • intertrace_list_runtime_sessions List runtime sessionsList runtime sessions with risk/alignment summaries.(mcp:read)
  • intertrace_get_runtime_session Get runtime sessionFetch one runtime session story and related evidence for the authenticated org.(mcp:read)
  • intertrace_list_runtime_decisions List runtime decisionsList recent runtime verification / authorize decisions for the organization.(mcp:read)
  • intertrace_list_usage List usageReturn organization usage counters for the current billing period.(mcp:read)
  • intertrace_search SearchOrg-scoped search across findings, assets, and traces. Not a staff/ops search.(mcp:read)
  • intertrace_posture_evaluate Evaluate postureEvaluate posture checks for org assets. dry_run=true (default) does not persist findings.(mcp:read)
  • intertrace_policy_simulate Simulate policyDry-run events through local authorize.rego-priority rules. Does not enforce live traffic.(mcp:read)
  • intertrace_list_assessments List assessmentsList recent assessment runs for the organization.(mcp:read)
  • intertrace_industry_readiness Industry solution readinessComputed industry-solution readiness. Catalog wording only — not a compliance certificate.(mcp:read)
  • intertrace_authorize_action Authorize actionAsk Intertrace whether an intended agent action is allowed. Uses the same policy simulator as /api/policy/simulate and persists an authorize outcome. Live Fly gateway enforcement remains the data-plane kernel.(mcp:authorize)
  • intertrace_update_finding_status Update finding statusSet a finding status (in_progress, resolved, accepted, false_positive) with the same audit trail as the dashboard.(mcp:write)
  • intertrace_hitl_approve Approve HITL requestApprove a pending runtime approval request for this organization.(mcp:write)
  • intertrace_hitl_deny Deny HITL requestDeny a pending runtime approval request for this organization.(mcp:write)
  • intertrace_protect_asset Protect assetMark an asset as protected (counts against the protected-agent quota).(mcp:write)
  • intertrace_start_assessment Start assessmentQueue an assessment run for an asset using an existing probe profile.(mcp:write)