# Describe the MCP Streamable HTTP endpoint

mcpDiscovery · GET /api/mcp

## 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 need an API key (a free key or Pro). The tool names are the operation names shared with the REST surface.

## Authentication
```json
[]
```
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](/docs/api/overview#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.

```json
{
  "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 need an API key (a free key or Pro). 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'"
    }
  ]
}
```