MCP

Connect assistants to gospace with one secure endpoint.

MCP (Model Context Protocol) lets assistants discover tools and resources over a standard JSON-RPC interface.

Endpoints and authentication

  • Production JSON-RPC URL: https://api.gospace.ai/api/v1/mcp/mcp
  • UAT JSON-RPC URL: https://api.uat.gospace.ai/api/v1/mcp/mcp
  • Health check: GET https://api.gospace.ai/api/v1/mcp/health
  • Auth: send x-api-key: <GOSPACE_API_KEY>
curl -i https://api.gospace.ai/api/v1/mcp/health \
  -H "x-api-key: $GOSPACE_API_KEY"

List available resources

curl -X POST https://api.gospace.ai/api/v1/mcp/mcp \
  -H "x-api-key: $GOSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "resources",
    "method": "resources/list"
  }'

Call a tool

curl -X POST https://api.gospace.ai/api/v1/mcp/mcp \
  -H "x-api-key: $GOSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "search",
    "method": "tools/call",
    "params": {
      "name": "<tool_name>",
      "arguments": { }
    }
  }'

Wire an MCP client to gospace

Most MCP clients accept an HTTP endpoint with static headers:

{
  "mcpServers": {
    "gospace": {
      "url": "https://api.gospace.ai/api/v1/mcp/mcp",
      "headers": {
        "x-api-key": "$GOSPACE_API_KEY"
      }
    }
  }
}