Add a credit account to your agent.

Connect an existing agent with MCP, or call services from your application with the HTTP API. Use your welcome credit to try a call before adding a card.

Get started Read the API reference

Connect over MCP

MCP lets your agent call Vaaya tools during a conversation. Run the installer to detect your client and add the connection.

Coding agents (Claude Code, Cursor, Codex)

Or paste this into any capable agent

Remote server (Claude, ChatGPT, any MCP client)

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

Vaaya checks the price and your spending limits before running a paid call.

Quote
Vaaya quotes the price for the service and action.
Ceiling
It checks the price against the maximum cost the agent sent with the call.
Policy
It checks the key’s categories, the key’s monthly limit, and the account ceiling.
Run
If every check passes, it runs the call with Vaaya’s own provider credentials.
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

Add a credit account to your agent.

Connect an existing agent with MCP, or call services from your application with the HTTP API. Use your welcome credit to try a call before adding a card.

Get started Read the API reference

Connect over MCP

MCP lets your agent call Vaaya tools during a conversation. Run the installer to detect your client and add the connection.

Coding agents (Claude Code, Cursor, Codex)

Or paste this into any capable agent

Remote server (Claude, ChatGPT, any MCP client)

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

Vaaya checks the price and your spending limits before running a paid call.

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