Vaaya MCP
Vaaya MCP gives an agent one balance for paid APIs: search, scraping, video, leads and email, with a price cap on every call
- 44 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The agent spends real money from a prepaid balance, including USDC crypto and card
- The stocks tool buys tokenized shares, and GTM tools send email and look up people's contacts
- Browser sessions and sandboxes run actions and code on behalf of the agent
Install
- Works in
Manual install
npx @vaaya/mcp installConfigures the server in Claude Code, Claude Desktop, Cursor and Codex and installs the skill.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent spends real money from a prepaid balance, including USDC crypto and card
- The stocks tool buys tokenized shares, and GTM tools send email and look up people's contacts
- Browser sessions and sandboxes run actions and code on behalf of the agent
This is third-party code. Review the repository files before installing.
What it does
Vaaya is a payment layer for agents. An agent in Cursor, Claude Code, Claude Desktop or Codex calls paid services from one balance with no vendor keys in its environment: Vaaya proxies every call server-side. Billing happens only for successful calls over x402 (USDC on Base), Stripe MPP or Tempo, and a refusal or failure costs nothing. Work rests on two calls. The consult tool takes a goal in plain words and returns a price and the exact calls. The use tool runs one call with a max_cost_cents parameter, a hard price ceiling: if the quote is higher, the call is refused before it reaches the provider. Long jobs return a job_id and are collected through result, and session and close cover sandboxes. Capabilities include image and video generation, voice, Exa and Parallel web search, Firecrawl scraping, deep research, lead search and contact enrichment, scheduled competitor monitoring, Modal sandboxes, Browserbase sessions, AgentMail inboxes and mem0, Zep or Letta memory. A separate stocks tool buys tokenized shares on Base from the prepaid balance.
Who it is for. Agent builders and founders who need to give an agent a limited budget for paid APIs without handing out keys of a dozen vendors.
Good fit when
- An agent needs search, scraping and video generation and you do not want a key for every service
- A single call needs a hard price ceiling so the agent cannot overspend
- Competitors should be monitored on a schedule with only new and changed findings returned
- A benchmark needs a per-second-billed sandbox
- You need leads with verified contacts and emails must go out only after manual approval
Not a fit when
- Agents must not touch money at all: the service spends a real balance
- You already have your own keys and vendor contracts and a middleman is superfluous
- You want shares at a licensed broker: Vaaya sells tokenized stocks on Base, not direct shares
- You want to approve every charge by hand: the only limit is max_cost_cents
Example request
Find 50 heads of operations at Series-B SaaS companies with verified emails. Call consult first and show the price, then run use with max_cost_cents no higher than 200.MCP
- Transport
- http, stdio
- Authentication
- OAuth
Limitations
The balance is topped up in packs of 10, 30 or 100 dollars, paid in USDC on Base or through Stripe. Welcome grants and credit lines cannot buy shares.
The agent sets the ceiling in each call itself, so its value is worth fixing in the instructions. A stock order counts only at status confirmed; on failed or needs_review the agent must stop.
The tool list comes from the server and changes; the docs are at vaaya.ai/llms.txt. Access from Russia was not checked for this card.
How to disable. Run `npx vaaya-cli logout` to disconnect and delete local credentials, and remove the vaaya entry from the client config. Grants are revoked at vaaya.ai/connected-apps.
FAQ
How do I install Vaaya MCP in Claude Code?
Run `npx @vaaya/mcp install`: it configures every client it finds. Or add the remote server: `claude mcp add --transport http vaaya https://vaaya.ai/mcp`. The first call opens an approval window in the browser.
What does max_cost_cents do?
It is a hard ceiling on the call price. If the quote is higher, the call is refused before it reaches the provider and the response gives a reason such as over_max. Failures and refusals cost nothing.
Does the agent see vendor keys?
No. Vaaya proxies every call server-side, and the agent gets no vendor keys or upstream URLs. Sign-in uses OAuth 2.1 with PKCE, and access can be revoked.
Does Vaaya have an agent skill?
Yes, `npx skills add vaaya-ai/vaaya-mcp` installs the vaaya skill for Claude Code, Codex, Cursor and other clients on the Agent Skills standard. The skill bootstraps the MCP server if it is missing.
Can I buy stocks through Vaaya?
The agent can buy tokenized shares on Base from the prepaid balance, and these are not direct brokerage shares. The tickers come from the `list` command of the `stocks` tool, and a purchase needs the user's authorization.
Discussion
No questions or reviews yet.
Related
MCP serversLocal ledger of AI agent work: tokens, estimated cost, steps, changed files and checks per task for Claude Code, Codex and OpenCode
Preloop is an open source agent control plane: an MCP firewall, a budgeted model gateway and event-driven agent runs.
One runtime for Claude Code, Codex, OpenCode and more: a run counts as done only when checks the agent did not write pass
ClawMetry reads the session files agents already write and shows the timeline, tool calls, tokens and cost in one dashboard.
A bundle of 176 skills, subagents and an MCP server for Claude Code, Cursor, Codex and Windsurf with code checks
A collection of 14 portable skills for long agent runs: work planning, live app QA, search across past sessions and a phone call
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Vaaya MCP (this card) | yes | OAuth | 44 | |
| Stripe AI | yes | OAuth | 2,059 | Stripe payments and billing for your own product |
| Firecrawl MCP Server | yes | API key | 7,814 | scraping and search only, with no shared balance |
README in short
The README shows a one-command install, remote OAuth connection, an npm shim for clients without HTTP, plugins for Claude Code, Codex and Gemini CLI, a skill and a capability table. The security section covers key proxying, pay-on-success billing and the mandatory max_cost_cents.