Skip to main content

Connection Protocol

The MCP server uses streamable HTTP with the following specifications:
  • Transport: Streamable HTTP
  • Accept Header: application/json text/event-stream
  • Protocol: JSON-RPC 2.0 over HTTP

Example Request

curl -X POST https://mcp.zeroclick.ai \
  -H "Content-Type: application/json" \
  -H "x-tenant-api-key: your-api-key-here" \
  -H "x-tenant-llm-model: gpt-4o" \
  -H "x-tenant-grouping-id: website-1" \
  -H "x-tenant-user-id: user123" \
  -H "Accept: application/json text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "params": {},
    "id": 1
  }'

Error Handling

The server returns standard JSON-RPC 2.0 error responses:
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Internal Server Error"
  },
  "id": null
}
Common error codes:
  • -32700: Parse error
  • -32600: Invalid request
  • -32601: Method not found
  • -32602: Invalid params
  • -32603: Internal error