vaaya / docs / reference

MCP

Vaaya is also available as a hosted MCP server at https://vaaya.ai/mcp. It exposes the same catalog and the same wallet. Interactive clients sign in with OAuth. Headless agents use the API key as a bearer token.

Headless: bearer token

{ "mcpServers": { "vaaya": {
    "url": "https://vaaya.ai/mcp",
    "headers": { "Authorization": "Bearer vaaya_sk_..." }
} } }

The key authenticates the session directly, with no browser OAuth step. Use this for CI, servers, and agent runtimes without a browser.

Interactive: OAuth

Claude, ChatGPT, Cursor, and other interactive clients can add https://vaaya.ai/mcp as a remote MCP server and sign in with Google. Client setup steps are at /how-to-get-started.

The tools

The MCP surface centers on two tools. consult routes plain English to exact calls. use runs a call with { service, action, params, max_cost_cents }. The full tool reference is at /llms-full.txt.