Skip to main content

Integrations Overview

You can connect many existing SDKs, coding tools, and agent frameworks to GoRoute by changing the endpoint and credential they use. Most integrations do not need a new application flow. Choose the guide for your client below, then use the protocol details when you need to troubleshoot a connection.

GoRoute supports OpenAI-compatible (/v1/*, /openai/v1/*) and Anthropic-compatible (/anthropic/v1/*, /v1/messages) endpoints, along with MCP (/mcp*) and A2A (/a2a/v1/*) protocols.


Base URLs by Protocol​

Client EcosystemBase URLSupported EndpointsReference
OpenAI-Compatiblehttp://localhost:8080/v1/v1/chat/completions, /v1/completions, /v1/embeddings, /v1/responses, /v1/realtime, /v1/models, /v1/audio/*, /v1/images/*, /v1/files, /v1/batches, /v1/rerank, /v1/moderationsGateway API
OpenAI Direct Aliashttp://localhost:8080/openai/v1/openai/v1/responses, /openai/v1/realtimeResponses API
Anthropic-Compatiblehttp://localhost:8080/anthropic/anthropic/v1/messages, /anthropic/v1/messages/count_tokens (also mounted at /v1/messages and /v1/messages/count_tokens)Anthropic Messages
Model Context Protocol (MCP)http://localhost:8080/mcp/mcp, /mcp/{serverSlug}, /mcp/toolsets/{toolsetSlug}, /mcp-rest/tools/*MCP Overview
Agent-to-Agent (A2A)http://localhost:8080/a2a/v1/.well-known/agent-card.json, /a2a/v1/agents/{agentSlug}/, /a2a/v1/agents/{agentSlug}/tasks*A2A Overview

Authentication with Virtual Keys (sk-gw-...)​

Data-plane routes authenticate callers using Virtual Keys prefixed with sk-gw- (issued via the Operator UI at /ui/ or POST /admin/v1/keys). See Virtual Keys for key creation, RBAC scoping, and budget caps.

GoRoute accepts either standard credential header:

  • Authorization: Bearer sk-gw-... (OpenAI-compatible clients)
  • x-api-key: sk-gw-... (Anthropic-compatible clients)

[!NOTE] If a client sends both Authorization: Bearer ... and x-api-key: ... with different values, GoRoute rejects the request with 400 Bad Request (ambiguous_gateway_credentials). Identical values in both headers are accepted.


Integration Guides​

Coding Agents & IDEs​

Official Language SDKs & Agent Frameworks​

Observability & Telemetry​

  • OpenTelemetry & Prometheus: OTLP/HTTP span export (tracing.otlp_endpoint, gen_ai.* attributes, W3C traceparent) and Prometheus /metrics scraping.