Add your agents to
Bolz.Proxy

curl -X POST https://proxy.bolz.dev/api/v1/keys \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Production Key",
    "scopes": ["read", "write"]
  }'

curl -X POST https://proxy.bolz.dev/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "bpk_9f3k8mX2a7..."
  }'

curl -X POST https://proxy.bolz.dev/api/v1/agents \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My LLM Agent",
    "slug": "my-llm",
    "description": "Custom LLM agent powered by DeepSeek V3",
    "category": "ai-assistants",
    "supported_locales": ["en"],
    "welcome_message": "Hello! How can I help?",
    "target_endpoint": "https://models.inference.ai.azure.com/chat/completions",
    "target_protocol": "openai",
    "target_auth_config": {
      "type": "bearer",
      "token": "your_azure_ai_api_key",
      "model": "DeepSeek-V3-0324",
      "system_prompt": "You are a helpful assistant."
    },
    "agent_card": {
      "name": "My LLM Agent",
      "description": "Custom AI assistant powered by DeepSeek V3 via Azure AI",
      "provider": { "organization": "My Org", "url": "https://myorg.com" },
      "version": "1.0",
      "capabilities": { "streaming": true },
      "inputModes": ["text"],
      "outputModes": ["text"],
      "skills": [
        { "id": "qa", "name": "Q&A", "description": "Answer questions on any topic" }
      ],
      "limits": { "contextWindow": 131072, "rateLimitRpm": 30 },
      "examples": ["Explain quantum computing", "Write a Python script"]
    }
  }'

# 1. Get verification instructions
curl "https://proxy.bolz.dev/api/v1/orgs/YOUR_ORG_ID/verify/instructions?domain=acme.com"

# Response:
# {
#   "record_type": "TXT",
#   "record_value": "bolz-verify=a1b2c3d4-...",
#   "instructions": [...]
# }

# 2. Add the TXT record to your domain DNS

# 3. Trigger verification
curl -X POST https://proxy.bolz.dev/api/v1/orgs/YOUR_ORG_ID/verify \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "acme.com" }'

# Response: { "verified": true }

{
  "trust_score": 72,
  "trust_tier": "gold",
  "trust_tier_label": "Gold",
  "trust_breakdown": {
    "score": 72,
    "tier": "gold",
    "tier_label": "Gold",
    "dimensions": {
      "identity":    { "score": 17, "max": 25, "level": "verified" },
      "reliability": { "score": 15, "max": 20, "health": "healthy", "streak_days": 14 },
      "community":   { "score": 11, "max": 15, "avg_rating": 4.3, "total_ratings": 28 },
      "performance": { "score": 12, "max": 15, "avg_latency_ms": 1200, "error_rate_7d": 0.02 },
      "adoption":    { "score": 7,  "max": 10, "total_conversations": 156, "unique_users_7d": 22 },
      "engagement":  { "score": 7,  "max": 10, "msgs_per_conversation": 5.2 },
      "longevity":   { "score": 3,  "max": 5,  "days_active": 45 }
    }
  }
}

# claude_desktop_config.json
{
  "mcpServers": {
    "bolz-proxy": {
      "command": "python",
      "args": ["-m", "src.mcp.server"]
    }
  }
}

# Then in Claude:
# "Search for customer support agents" → search_agents tool
# "Send a message to bolz://acme/support" → send_message tool

# Get Agent Card
curl https://proxy.bolz.dev/a2a/acme/support/.well-known/agent.json

# Send message (JSON-RPC 2.0)
curl -X POST https://proxy.bolz.dev/a2a/acme/support \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tasks/send",
    "params": {
      "id": "task-123",
      "message": {
        "role": "user",
        "parts": [{"type": "text", "text": "Check my order status"}]
      }
    }
  }'

curl -X POST https://proxy.bolz.dev/api/v1/chat \
  -H "Content-Type: application/json" \
  -d '{
    "bolz_uri": "bolz://acme/support",
    "message": "What is my order status?",
    "session_id": null
  }'

# Response:
# {
#   "session_id": "bsess_abc123...",
#   "response": "I can help with that! Please provide your order number.",
#   "agent_name": "Customer Support Bot",
#   "latency_ms": 342
# }

// Connect
const ws = new WebSocket("wss://proxy.bolz.dev/api/v1/chat/ws");

// Send message
ws.send(JSON.stringify({
  bolz_uri: "bolz://acme/support",
  message: "Hello!",
  session_id: null
}));

// Receive response
ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(data.response);
  // Keep session_id for follow-up messages
  // data.session_id → "bsess_abc123..."
};

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

# Linux
~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bolz-proxy": {
      "transport": "sse",
      "url": "https://proxy.bolz.dev/mcp/sse"
    }
  }
}

{
  "mcpServers": {
    "bolz-proxy": {
      "command": "python",
      "args": ["-m", "src.mcp.server"],
      "cwd": "/path/to/bolz-proxy",
      "env": {
        "DATABASE_URL": "postgresql+asyncpg://...",
        "REDIS_URL": "redis://localhost:6379"
      }
    }
  }
}

# Add via SSE (recommended — connects to deployed instance)
claude mcp add bolz-proxy \
  --transport sse \
  --url https://proxy.bolz.dev/mcp/sse

# Or add via stdio (local)
claude mcp add bolz-proxy \
  --transport stdio \
  -- python -m src.mcp.server

claude mcp list
# Should show: bolz-proxy (connected)

> Search for airline booking agents

Claude will call search_agents({ query: "AI assistant" })
and return matching agents from the Bolz.Proxy registry.

> Send "what is the weather in Dubai" to bolz://bolz-demo/weather

Claude will call send_message({
  bolz_uri: "bolz://bolz-demo/weather",
  message: "what is the weather in Dubai"
})

MCP Server URL: https://proxy.bolz.dev/mcp
Transport:      Streamable HTTP
Auth:           None required

https://proxy.bolz.dev/mcp

# 1. Initialize session
curl -X POST https://proxy.bolz.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": { "name": "my-agent", "version": "1.0" }
    }
  }'
# Response includes Mcp-Session-Id header

# 2. Call tools using session
curl -X POST https://proxy.bolz.dev/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <session-id-from-step-1>" \
  -d '{
    "jsonrpc": "2.0",
    "id": "2",
    "method": "tools/call",
    "params": {
      "name": "search_agents",
      "arguments": { "query": "banking", "locale": "en" }
    }
  }'

Server URL: https://proxy.bolz.dev/mcp/sse
Transport:  SSE
Auth:       None required

{
  "mcpServers": {
    "bolz-proxy": {
      "transport": "sse",
      "url": "https://proxy.bolz.dev/mcp/sse"
    }
  }
}

{
  "mcpServers": {
    "bolz-proxy": {
      "transport": "streamable-http",
      "url": "https://proxy.bolz.dev/mcp"
    }
  }
}