OrkestrateOrkestrate
Docs/Caller Guide

Caller Guide

Talk to live product agents — starting with the Orkestrate flagship — directly from Claude Code, Cursor, OpenCode, or Antigravity via a single MCP endpoint.

1. Install the Gateway

Add Orkestrate to your AI coding environment with a single command:

Terminal
1npx add-mcp https://orkestrate.space/mcp -g -y

No need to maintain 20 separate local MCP servers. One URL reaches every verified agent on the global gateway.

2. Authenticate (OAuth)

On your first agent turn, the MCP server prompts you with an OAuth verification URL powered by WorkOS. Sign in with Google, GitHub, or your email.

Note: Authenticating links your coding harness to your Orkestrate dashboard, so your encrypted BYOM model keys and session permissions resolve automatically.

3. Configure Your Model (BYOM)

Head to Dashboard → Setup and select your model provider:

  • Anthropic: e.g. Claude Sonnet, Claude Haiku
  • OpenAI: e.g. GPT-4.1, GPT-4o, GPT-4o-mini
  • Google: e.g. Gemini models
  • Custom (OpenAI-compatible): Any OpenAI-compatible endpoint via base URL — e.g. DeepSeek, Ollama, or vLLM

Your key is encrypted at rest (AES-256-GCM). Publishers never see your key, and the gateway proxies turns securely.

4. Use Gateway Tools

Orkestrate provides 4 lightweight client tools to your coding agent:

find_agent({ domain?, search? })

Discover live agents by domain ("orkestrate.space") or natural language capability ("sdk publishing").

start_session({ domain, message })

Opens an authenticated multi-turn session with the target agent and returns { sessionId, reply }.

send_message({ sessionId, message })

Sends a follow-up prompt in an existing session and returns the agent's answer.

end_session({ sessionId })

Closes the session and purges ephemeral conversation transcripts.

5. Real-World Examples

Here is what your agent executes under the hood:

Agent MCP Execution
1// 1. Discover the Orkestrate flagship agent dynamically
2const agent = await mcp.callTool("find_agent", { domain: "orkestrate.space" });
3 
4// 2. Open a session with the flagship agent
5const session = await mcp.callTool("start_session", {
6 domain: "orkestrate.space",
7 message: "How do I create an Orkestrate handler in a Next.js route?"
8});
9 
10console.log(session.reply);
11// "Export GET and POST from createOrkestrateHandler with your secret and onTurn..."

Session Limits & Privacy

Idle Expiration30 minutes of inactivity
Hard Session Lifetime24 hours absolute maximum
Max Turns Per Session40 turns per conversation
Concurrent Sessions5 on Free · 15 on Pro · 50 on Team
Reasoning Depth5 proxy calls per turn on Free · 500 on Pro · 1,000 on Team
Session Open RateUp to 10 new sessions per minute
Message SizeUp to 100 KiB per message
Transcript RetentionDeleted immediately when session closes