Vaaya MCP — paid superpowers for any agent

Vaaya is the agent payment system: one MCP server that
lets any agent call paid APIs pay-per-call, with no API keys. Instead of
wiring up a dozen vendor keys, your agent asks Vaaya's conversational consult
tool for anything it can't do, gets back the exact call to run, and executes it
with use — billed on success only (x402 USDC on Base, Stripe MPP, or Tempo;
the payment is the auth). Failed calls are never charged.

What your agent can do through Vaaya

Install

One command (recommended)

npx vaaya-cli install

Sets up the Vaaya MCP server for every agent it detects on your machine —
Claude Code, Claude Desktop, Cursor, Codex — plus the agent skill.
Idempotent: re-run any time to update. Then restart your agent; the first
Vaaya call opens a short browser approval (sign-up happens right there).

Remote (Streamable HTTP + OAuth)

{ "mcpServers": { "vaaya": { "url": "https://vaaya.ai/mcp" } } }

Claude Code:

claude mcp add --transport http vaaya https://vaaya.ai/mcp

On first use your client runs the OAuth flow in the browser; approve and you're
connected. Revoke anytime at vaaya.ai/connected-apps.

npm stdio shim (for stdio-only clients: opencode, …)

{ "mcpServers": { "vaaya": { "command": "npx", "args": ["-y", "@vaaya/mcp"] } } }

The shim (@vaaya/mcp) opens the
OAuth flow on first call, stores a refresh token locally (0o600), and proxies
the live tool list from the backend — new server-side tools appear without a
shim upgrade. It also ships an agent skill so your client routes every
capability gap through consult automatically.

Agent skill (works across 70+ agents)

npx skills add MaruPelkar/vaaya-mcp

Installs the vaaya skill for Claude Code, Codex,
Cursor, Gemini CLI, Copilot, and any other client that supports the open
Agent Skills standard. The skill bootstraps the
Vaaya MCP server if it's missing and keeps the install updated.

As a plugin

• Claude Code: /plugin marketplace add MaruPelkar/vaaya-mcp then /plugin install vaaya@vaaya
• Codex: codex plugin marketplace add MaruPelkar/vaaya-mcp then install vaaya from the Plugins panel
• Gemini CLI: gemini extensions install https://github.com/MaruPelkar/vaaya-mcp

How it works

1. consult(intent) — describe any goal in plain English ("generate a hero
   video", "find 50 heads of RevOps with verified emails", "watch my
   competitor's pricing page"). It converses, clarifies, and returns the exact
   call(s) to run.
2. use(service, action, params, max_cost_cents) — execute the call.
   Billed on success; max_cost_cents is a hard spend ceiling. Long jobs
   return { async: true, job_id } — poll with result(job_id).
3. session / close — per-second-billed code sandbox sessions.

Plus a full GTM suite (gtm_leads_find, gtm_lead_enrich, gtm_signal_create,
gtm_segments, gtm_message, gtm_replies, …) and scheduled monitoring
workers (worker_create, worker_findings, …) — 34 tools total.

Example prompts

• "Generate a hero video for our landing page in 16:9."
• "Record my product and turn it into a narrated demo video."
• "Find 50 heads of RevOps at Series-B SaaS companies with verified emails."
• "Watch my competitor's pricing page and tell me when it changes."
• "Do deep research on the agentic payments market with cited sources."
• "Scrape these 200 product pages into structured JSON."
• "Run this benchmark in a GPU sandbox."

CLI

The vaaya-cli CLI manages everything from
the terminal:

npx vaaya-cli install        # set up the MCP server for every detected agent
npx vaaya-cli status         # connection state + live tool count
npx vaaya-cli consult "..."  # ask Vaaya how it would do something (returns the plan)
npx vaaya-cli reauthorize    # re-run the browser auth flow
npx vaaya-cli logout         # disconnect & delete local credentials

Security & billing

• Your agent never sees vendor API keys or upstream URLs — Vaaya proxies every
  call server-side.
• OAuth 2.1 (PKCE, dynamic client registration); anonymous tools/list for
  discovery; revocable grants.
• Pay-per-call on x402 (USDC on Base), Stripe MPP/SPT, or Tempo. Failed calls
  are never charged. Every call carries a max_cost_cents guard.

Links

• Website & docs: https://vaaya.ai
• Agent-readable docs (llms.txt): https://vaaya.ai/llms.txt · full tool reference: https://vaaya.ai/llms-full.txt
• npm: https://www.npmjs.com/package/@vaaya/mcp · https://www.npmjs.com/package/vaaya-cli
• Support: [email protected]