Connect via MCP

The Orchus MCP server exposes all Library data and x402 payment tools to any MCP-compatible AI client (Claude, GPT-4, custom agents).

MCP Endpoint

https://library.agentstrail.ai/mcp

Add this to your MCP client configuration. The server uses the standard MCP HTTP transport with JSON-RPC 2.0.

Claude Desktop Setup

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "orchus": {
      "url": "https://library.agentstrail.ai/mcp",
      "transport": "http"
    }
  }
}

What Happens on Connect

When your client sends initialize, the MCP server:

1. Creates a session wallet — a fresh Solana keypair derived from a server-side secret
2. Returns the wallet address in the instructions field
3. All subsequent orchus_fetch / orchus_pay calls use this wallet to sign payments

Fund the session wallet with USDC to enable paid calls. Use orchus_wallet to see your addresses and balances.

Session Wallet

Each MCP session gets its own isolated wallet. This means:

• Your keys never leave your environment (for local MCP setups)
• The server wallet is ephemeral — only exists for the session duration
• For hosted deployments, fund the wallet before calling paid endpoints

Available Tools

See MCP Tools Overview for full documentation.