Endpoint#
GET /api/mcp
Unauthenticated discovery response. The endpoint implements JSON-RPC 2.0 over POST (MCP Streamable HTTP). initialize, notifications/initialized, and ping are unauthenticated protocol methods; tools/list and tools/call require the mcp_access entitlement. The tool names are the operation names shared with the REST surface.
Authentication#
[]An empty security requirement means this operation does not declare authentication. Read operation notes for entitlement and protocol-method requirements.
Parameters#
No parameters declared by the specification.
Responses and errors#
| HTTP status | Meaning |
|---|---|
| 200 | The self-describing MCP discovery body. |
Response examples#
No response example is supplied by OpenAPI for this operation. The complete response schemas are preserved below; use an actual response for observed values.
Retry guidance#
See errors and retries. Honor operation-specific response headers. A POST may create state; do not replay it automatically.
Complete operation contract#
The expanded contract below includes all parameter constraints, response headers, schemas and examples from OpenAPI.
{
"path": "/api/mcp",
"method": "GET",
"parameters": [],
"operationId": "mcpDiscovery",
"summary": "Describe the MCP Streamable HTTP endpoint",
"description": "Unauthenticated discovery response. The endpoint implements JSON-RPC 2.0 over POST (MCP Streamable HTTP). initialize, notifications/initialized, and ping are unauthenticated protocol methods; tools/list and tools/call require the mcp_access entitlement. The tool names are the operation names shared with the REST surface.",
"tags": [
"mcp"
],
"security": [],
"responses": {
"200": {
"description": "The self-describing MCP discovery body.",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
}
},
"x-codeSamples": [
{
"lang": "curl",
"label": "curl",
"source": "curl -s 'https://china-snapshot.com/api/mcp'"
}
]
}