Vaaya

Vaaya MCP — 面向任何 Agent 的支付

用于 AI Agent 支付的 MCP 服务。Cursor、Claude Code、Claude Desktop、Codex 或任何 MCP 主机中的 Agent，都可以从同一余额调用付费 API（搜索、抓取、联系人数据、公共记录、计算、媒体、研究），每次调用都会声明支出上限，并且其环境中无需存放任何供应商密钥。仅在调用成功时收费（x402 USDC on Base、Stripe MPP 或 Tempo）；拒绝或失败的调用不产生费用。

npx @vaaya/mcp install            # Cursor, Claude Code, Claude Desktop, Codex
claude mcp add --transport http vaaya https://vaaya.ai/mcp

首次付费调用：consult 会返回定价方案；use({ service, action, params, max_cost_cents }) 会执行其中一项。如果报价高于 max_cost_cents，调用会在到达服务提供方之前被拒绝，并返回原因：

{ "error": "over_max", "message": "price is 5¢ but max_cost_cents was 1", "price_cents": 5 }

可运行示例：examples/pay-for-an-api（一次调用获准，一次被拒绝）、examples/cursor、 examples/claude。指南： 为 Agent 设置预算、 Cursor 设置、 Claude 设置、 什么是 AI Agent 钱包。

购买代币化股票——包括使用 Instinct 购买

Agent 可以使用 Vaaya 预付资金，在 Base 上购买受支持的代币化股票。这些是代币化股票，而非直接的经纪账户股票。使用 stocks({ command: "list" }) 查询当前支持的股票代码（例如 Apple AAPLc 和 NVIDIA NVDAc），然后使用 stocks({ command: "portfolio" }) 检查 buyingPowerCents。欢迎赠金和信用额度不能用于购买股票。

用户授权购买价值 $10 的 Apple 股票：

{ "command": "buy", "symbol": "AAPLc", "amount_cents": 1000, "idempotency_key": "<unique purchase key>" }

使用此输入调用专用的 stocks MCP 工具；它与 consult/use 分开。金额是包含费用在内的预付支出总额上限。保存返回的 id，然后轮询 stocks({ command: "order", order_id: "<id>" })。 只有状态为 confirmed 才表示已购买。遇到 failed 或 needs_review 时停止；在不确定的情况下重试时复用同一个购买密钥，切勿为了查询状态而下新订单。

预付余额不足？ 在用户授权购买 $10、$30 或 $100 套餐后，使用同一账户的 Bearer 令牌，通过 POST 向 https://vaaya.ai/api/v1/topup 发送 JSON { "pack_cents": 1000 }（或 3000 / 10000）。 如果 Instinct Agent 已获准使用用户保存的银行卡支付该套餐金额，则可以在自己的浏览器中使用返回的 Stripe Checkout url 付款。交接时，将 URL 和授权金额提供给用户的 Instinct Agent；否则将 URL 提供给用户。交接内容中不得包含银行卡信息和 Bearer 令牌。Vaaya 无法直接从 Instinct 中保存的银行卡扣款。仅授权购买股票并不代表授权额外的银行卡扣款。

轮询 GET /api/v1/wallet（wallet.prepaid_cents），然后在继续原购买密钥对应的操作前，重新检查股票购买额度。付款结果不确定时，不要再次付款。购买还受股票供应情况和账户权限限制。

MCP 和 REST 完整购买指南 · 完整工具参考

你的 Agent 可以通过 Vaaya 实现什么

能力	你可以获得什么
🎨 媒体生成	使用顶级模型生成图像和视频——Nano Banana Pro 2、GPT Image 2、Seedream v4.5、Kling v3、Seedance 2.0——以及 TTS 语音和音乐
🎬 产品演示视频	录制产品实时运行时未经处理、无声的屏幕录像；Vaaya 会自动撰写旁白、规划缩放和剪辑，并渲染出带旁白的成品演示视频
🖼️ 网站图像	提取网站的品牌风格，并直接在你的代码仓库中生成符合品牌形象的图像集
🔎 网页搜索	Exa 和 Parallel：查询搜索、URL 内容、异步深度研究任务
🕷️ 网页抓取	使用 Firecrawl 抓取、爬取、映射、搜索和提取内容，并将结果保存到文件
📚 深度研究	多跳、来源经过核实且附有引用的研究报告
📊 市场与竞品研究	公司报告（人员、招聘、广告、评论、SEO/LLM 曝光度）、带有评论情感分析的产品和功能目录、包含交互式产品地图的 UX 研究、“最适合我的数据的 X”对比评测，以及持久化的竞品知识库
🎯 GTM 与销售	查找符合 ICP 的潜在客户并核实其联系方式、补充联系人信息、跟踪购买信号（融资／招聘／发布／新闻报道）、全天候发掘 LinkedIn 联系人、按细分群体发送外联邮件——每封草稿都需经人工批准
⏰ 监控工作进程	定时监控（每 30 分钟至每周一次）竞争对手定价、优惠、评论、招聘信息和新闻——只呈现新增或变更的发现
🖥️ 计算沙盒	按秒计费的代码执行环境（Modal），用于基准测试、不可信代码、GPU 推理和数据任务
🌐 浏览器自动化	使用 Browserbase 会话点击、输入、登录和填写表单
📧 电子邮件	由你的 Agent 拥有的 AgentMail 收件箱——发送邮件并接收回复
🧠 记忆	通过 mem0、Zep 或 Letta 实现跨会话持久记忆

安装

一条命令（推荐）

npx @vaaya/mcp install

（npx vaaya-cli install 会运行同一个安装程序。）

为机器上检测到的每个 Agent 设置 Vaaya MCP 服务—— Claude Code、Claude Desktop、Cursor、Codex——以及 Agent 技能。 支持幂等操作：可随时重新运行以更新。然后重启你的 Agent；首次 调用 Vaaya 时会打开一个简短的浏览器授权流程（直接在浏览器中注册）。

远程服务（Streamable HTTP + OAuth）

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

Claude Code：

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

OpenClaw：

openclaw mcp add vaaya --url https://vaaya.ai/mcp --transport streamable-http --auth oauth
openclaw mcp login vaaya

Hermes（~/.hermes/config.yaml）：

mcp_servers:
  vaaya:
    url: "https://vaaya.ai/mcp"
    auth: oauth

首次使用时，客户端会在浏览器中启动 OAuth 流程；批准后即可 连接。你可以随时在 vaaya.ai/connected-apps 撤销授权。

npm stdio 适配器（适用于仅支持 stdio 的客户端：opencode 等）

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

该适配器（@vaaya/mcp）会在首次调用时 启动 OAuth 流程，在本地存储刷新令牌（0o600），并代理 后端提供的实时工具列表——无需升级适配器即可使用服务端新增的工具。它还附带 Agent 技能，让你的客户端自动通过 consult 填补所有能力缺口。

Agent 技能（适用于 70 多种 Agent）

npx skills add vaaya-ai/vaaya-mcp

为 Claude Code、Codex、 Cursor、Gemini CLI、Copilot 以及任何支持开放 Agent Skills 标准的客户端安装 vaaya 技能。如果缺少 Vaaya MCP 服务，该技能会负责启动，并确保安装保持更新。

作为插件安装

• Claude Code：运行 /plugin marketplace add vaaya-ai/vaaya-mcp，然后运行 /plugin install vaaya@vaaya——其中包含远程 MCP 服务、vaaya 技能和 SessionStart 提醒钩子
• Codex：运行 codex plugin marketplace add vaaya-ai/vaaya-mcp，然后从 Plugins 面板安装 vaaya
• Gemini CLI：运行 gemini extensions install https://github.com/vaaya-ai/vaaya-mcp

工作原理

1. consult(intent) — 用通俗英语描述任何目标（“生成一段主视觉视频”、“寻找 50 位经过验证邮箱的 RevOps 负责人”、“监控竞争对手的定价页面”）。它会与你对话、澄清需求，并返回要运行的确切调用。
2. use(service, action, params, max_cost_cents) — 执行调用。成功后才计费；max_cost_cents 是硬性支出上限。长时间运行的任务会返回 { async: true, job_id } ——使用 result(job_id) 轮询。
3. session / close — 按秒计费的代码沙箱会话。

此外，还提供完整的 GTM 套件（gtm_leads_find、gtm_lead_enrich、gtm_signal_create、gtm_segments、gtm_message、gtm_replies 等）和定时监控工作器（worker_create、worker_findings 等）——工具列表由后端实时代理。

示例提示词

• “为我们的落地页生成一段 16:9 的主视觉视频。”
• “录制我的产品，并将其制作成带旁白的演示视频。”
• “寻找 50 位来自 B 轮 SaaS 公司的 RevOps 负责人，并提供经过验证的邮箱。”
• “监控竞争对手的定价页面，并在内容变更时通知我。”
• “深入研究 Agentic 支付市场，并提供引用来源。”
• “将这 200 个产品页面抓取为结构化 JSON。”
• “在 GPU 沙箱中运行此基准测试。”

命令行界面

vaaya-cli CLI 可在终端中管理一切：

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

安全与计费

• 你的 Agent 永远不会看到供应商 API 密钥或上游 URL——Vaaya 会在服务器端代理每次调用。
• OAuth 2.1（PKCE、动态客户端注册）；匿名 tools/list 用于发现；授权可撤销。
• 支持按调用付费的 x402（Base 上的 USDC）、Stripe MPP/SPT 或 Tempo。调用失败不收费。每次调用都会受到 max_cost_cents 限额保护。

链接

• 网站和文档：https://vaaya.ai
• 面向 Agent 的文档（llms.txt）：https://vaaya.ai/llms.txt · 完整工具参考：https://vaaya.ai/llms-full.txt
• npm：https://www.npmjs.com/package/@vaaya/mcp · https://www.npmjs.com/package/vaaya-cli
• 支持：[email protected]