Skip to main content
  1. Sign up — Create an account at platform.respan.ai
  2. Create an API key — Generate one on the API keys page
  3. Add credits or a provider key — Add credits on the Credits page or connect your own provider key on the Integrations page
Add the Docs MCP to your AI coding tool to get help building with Respan. No API key needed.
{
  "mcpServers": {
    "respan-docs": {
      "url": "https://docs.respan.ai/mcp"
    }
  }
}
This integration is for the Respan gateway.

​
What is Claude Agent SDK?

The Claude Agent SDK (claude-agent-sdk) is a framework for building agent workflows powered by Claude. Route Claude API calls through the Respan gateway so only a single RESPAN_API_KEY is needed for both the LLM call and trace export.

​
Quickstart

​
Step 1: Install packages

pip install claude-agent-sdk respan-exporter-anthropic-agents

​
Step 2: Set environment variables

export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"

​
Step 3: Point the agent to the Respan gateway

from claude_agent_sdk import ClaudeAgentOptions
from respan_exporter_anthropic_agents import RespanAnthropicAgentsExporter

RESPAN_API_KEY = "YOUR_RESPAN_API_KEY"

exporter = RespanAnthropicAgentsExporter(
    api_key=RESPAN_API_KEY,
    base_url="https://api.respan.ai/api",
)

options = ClaudeAgentOptions(
    permission_mode="bypassPermissions",
    max_turns=1,
    env={
        "ANTHROPIC_BASE_URL": "https://api.respan.ai/api",
        "ANTHROPIC_AUTH_TOKEN": RESPAN_API_KEY,
        "ANTHROPIC_API_KEY": RESPAN_API_KEY,
    },
)

async for message in exporter.query(
    prompt="Tell me a joke about AI",
    options=options,
):
    print(type(message).__name__)

​
Step 4: Verify

Open the Logs page to see your gateway requests.
Looking for tracing integration? See Tracing > Claude Agent SDK.