Skip to content
OpsTech Docs

mcp-control-plane

📦 Auto-synced from

opsclaw-product/tools/api-inventory/openapi/mcp-control-plane.yaml

@ 2061009. To change this page, edit the upstream OpenAPI fragment and let docs-propagate.yml re-sync.

At a glance

FieldValue
Listen port8084
Ownercontrol-plane
Default authbearer-pat
Public hostnamesinternal-only
Service-level side effectsmutates-db
Declared paths21
Scanned routes2
Total paths emitted21

Event-flow diagram


      
        mmdc render failed: Command failed: npx --no-install mmdc -i "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/924fe0bc139431a8.mmd" -o "/home/runner/_work/opstech-site/opstech-site/docs-site/.mermaid-cache/924fe0bc139431a8.svg" -b transparent 2>&1
mcp-control-plane — operations grouped and coloured by their primary side-effect class.

Endpoints

MethodPathSummarySide effectsStatus
GET/healthzLiveness proberead-onlyverified-from-code
GET/readyzReadiness proberead-dbverified-from-code
GET/v1/hosted-mcpsList hosted MCPs (publisher view)read-dbverified-from-code
POST/v1/hosted-mcpsSubmit a hosted MCP for reviewmutates-dbverified-from-code
POST/v1/hosted-mcps/{hostedMCPID}/image-scanReport the image-scan result for a hosted MCPmutates-dbverified-from-code
POST/v1/hosted-mcps/{hostedMCPID}/publishPublish a hosted MCP (publisher-side)mutates-dbverified-from-code
GET/v1/mcp-attachmentsList MCP attachmentsread-dbverified-from-code
POST/v1/mcp-attachmentsAttach an MCP installation to an agent or runmutates-dbverified-from-code
DELETE/v1/mcp-attachments/{attachmentID}Soft-delete an MCP attachmentmutates-dbverified-from-code
GET/v1/mcp-attachments/runtime-projectionMaterialise the MCP attachments for an agent or runread-dbverified-from-code
GET/v1/mcp-installationsList MCP installations for the caller's tenantread-dbverified-from-code
POST/v1/mcp-installationsCreate an MCP installationmutates-dbverified-from-code
DELETE/v1/mcp-installations/{installationID}Soft-delete an MCP installationmutates-dbverified-from-code
GET/v1/mcp-installations/{installationID}Get an MCP installationread-dbverified-from-code
POST/v1/mcp-installations/{installationID}/credentialsWrite the upstream credential for an MCP installationmutates-dbverified-from-code
GET/v1/mcp-installations/{installationID}/oauth/callbackComplete a tenant-OAuth flow for an MCP installationmutates-dbverified-from-code
POST/v1/mcp-installations/{installationID}/oauth/startBegin a tenant-OAuth flow for an MCP installationmutates-dbverified-from-code
POST/v1/mcp-marketplace/{productID}/api-keysIssue a marketplace API key for a subscriptionmutates-dbverified-from-code
POST/v1/mcp-marketplace/{productID}/approveApprove a marketplace product (platform-only)mutates-dbverified-from-code
POST/v1/mcp-marketplace/{productID}/subscribeSubscribe a tenant to a marketplace productmutates-dbverified-from-code
GET/v1/mcp-usageList MCP usage eventsread-dbverified-from-code
GET/v1/mcpsList curated MCPsread-onlyverified-from-code
GET/v1/mcps/{name}Get a curated MCP by nameread-onlyverified-from-code
GET/v1/mcps/customList the caller's custom MCPsread-dbverified-from-code
POST/v1/mcps/customRegister a tenant-custom MCPmutates-dbverified-from-code
DELETE/v1/mcps/custom/{customMCPID}Delete a tenant-custom MCPmutates-dbverified-from-code