Skip to main content

MCP (Model Context Protocol)

The MCP server provides programmatic access to Zen Mesh data through the Model Context Protocol.

Current Status

  • Server implemented at src/saas/mcp/ in zen-platform
  • Deployment: K8s deployment exists but disabled in sandbox (mcp.enabled: false)
  • Not production-live
  • No evidence/proof/readiness tools yet — existing tools cover API keys, deliveries, webhooks

Existing Tools

ToolDescriptionRead-Only
list_api_keysList API keys
create_api_keyCreate API key
revoke_api_keyRevoke API key
list_deliveriesList deliveries
get_deliveryGet delivery details
list_webhooksList webhooks
get_webhookGet webhook details
get_delivery_statsGet delivery statistics

Proposed Evidence Tools

ToolDescriptionStatus
get_runtime_statusRuntime convergence overviewplanned
get_trust_proofTrust proof by IDplanned
get_compliance_mappingCompliance framework mappingsplanned
explain_non_claimsNon-claims by categoryplanned
summarize_readinessReadiness summaryplanned

Intended Resources

URIDescriptionStatus
zen://capabilitiesAll capabilities with proof statusplanned
zen://runtime/proofsRuntime proof ledgerplanned
zen://trust/proofsTrust proof ledgerplanned
zen://compliance/mapCompliance feature graphplanned
zen://non-claimsNon-claims by categoryplanned
zen://readinessReadiness and blocker summaryplanned

Design Principles

  • Read-only for evidence tools: Proposed tools are read-only
  • Rate-limited: 50 req/s, burst 100
  • Database-backed: Uses persistent storage
  • Tenant-scoped: API key authentication required

Non-Claims

  • Not production-live — disabled in sandbox
  • Evidence tools are planned — not yet implemented
  • Existing mutating tools (create/revoke API key) preserved but out of evidence scope
  • No compliance certification via MCP