DEVELOPERS

Add a credit account to your agent.

Vaaya connects through MCP or a plain HTTP API. Setup takes a few minutes, and the welcome credit lets an agent make real calls before a card is on file.

Get started Read the API reference

Connect over MCP

MCP is the fastest way to connect. The installer detects the host and writes the configuration for it.

Coding agents (Claude Code, Cursor, Codex)

Or paste this into any capable agent

Remote server (Claude, ChatGPT, any MCP client)

OAuth 2.1 runs in the browser on first use. No API key is needed.

Claude Code CLI

Call the API directly

Create an API key on the account and call any service with it. The key carries the agent’s policy.

Request

POST /api/run/exa/search
Authorization: Bearer $VAAYA_API_KEY

{ "query": "agentic payments adoption 2026",
  "numResults": 10,
  "max_cost_cents": 5 }

Response

{ "ok": true,
  "data": { "results": [ … ] },
  "charged_cents": 1,
  "transaction_id": "tx_…" }

How a call is authorized

Every paid call goes through the same checks, in this order.

01
Quote
Vaaya quotes the price for the service and action.
02
Ceiling
It checks the price against the maximum cost the agent sent with the call.
03
Policy
It checks the key’s categories, the key’s monthly limit, and the account ceiling.
04
Run
If every check passes, it runs the call with Vaaya’s own provider credentials.
05
Record
On success it charges the account the quoted amount and records the transaction. On failure it records the call at $0.

Testing

There is no separate test mode. Every new account has a welcome credit, so an agent can make real calls at real prices before a card is added. A failed call is not charged, and you can revoke a key at any time.

Reference

Connect your first agent.

One command installs the MCP server. The welcome credit covers the first calls.

Get started Read the API reference

DEVELOPERS

Add a credit account to your agent.

Vaaya connects through MCP or a plain HTTP API. Setup takes a few minutes, and the welcome credit lets an agent make real calls before a card is on file.

Get started Read the API reference

Connect over MCP

MCP is the fastest way to connect. The installer detects the host and writes the configuration for it.

Coding agents (Claude Code, Cursor, Codex)

Or paste this into any capable agent

Remote server (Claude, ChatGPT, any MCP client)

OAuth 2.1 runs in the browser on first use. No API key is needed.

Claude Code CLI

Call the API directly

Create an API key on the account and call any service with it. The key carries the agent’s policy.

Request

POST /api/run/exa/search
Authorization: Bearer $VAAYA_API_KEY

{ "query": "agentic payments adoption 2026",
  "numResults": 10,
  "max_cost_cents": 5 }

Response

{ "ok": true,
  "data": { "results": [ … ] },
  "charged_cents": 1,
  "transaction_id": "tx_…" }

How a call is authorized

Every paid call goes through the same checks, in this order.

01
Quote
Vaaya quotes the price for the service and action.
02
Ceiling
It checks the price against the maximum cost the agent sent with the call.
03
Policy
It checks the key’s categories, the key’s monthly limit, and the account ceiling.
04
Run
If every check passes, it runs the call with Vaaya’s own provider credentials.
05
Record
On success it charges the account the quoted amount and records the transaction. On failure it records the call at $0.