JarvisClaw — AI Gateway & API Marketplace

JarvisClaw MCP Server

通过一个 MCP 服务使用 283 个 AI 模型和 2,720 个按次付费 API。 通过 x402 使用 Base 或 Solana 上的 USDC 结算——无需账户、API 密钥或订阅。

使用服务的三种方式：

• 模型——共 283 个模型（GPT-5、Claude Opus 5、Gemini 3、DeepSeek），可通过一个兼容 OpenAI 的 chat 工具调用，也可以使用 auto 让路由器来选择。
• API 市场——涵盖 40 个类别（搜索、区块链、代码、DNS、图像、文档、OCR、电子邮件、地理位置、TTS 等）的 2,720 个独立定价端点，其中 411 个经过精选。搜索 API、查看价格，然后调用。
• AIP 意图——共 13 种意图类型。说明你的需求（web_search、image_generation、translation 等），AIP 会将其解析到相应的提供方，调用方无需了解 URL 结构。

目录会不断变化，list_models、search_apis 和 aip_list_intents 返回的是实时信息。

快速开始

本地钱包签名（x402 推荐方式）

运行此软件包。它会以标准 stdio MCP 服务的形式呈现给客户端，将每个请求转发到网关；当调用需要付款时，它会在你的设备上签署 x402 付款并重试。你的私钥绝不会被传输——只有已签名的付款载荷会被传输。

JARVISCLAW_WALLET_KEY=0xyourkey npx jarvisclaw-mcp

Claude Desktop / Cursor，Base 钱包：

{
  "mcpServers": {
    "jarvisclaw": {
      "command": "npx",
      "args": ["-y", "jarvisclaw-mcp"],
      "env": {
        "JARVISCLAW_WALLET_KEY": "0xYOUR_BASE_PRIVATE_KEY",
        "JARVISCLAW_CHAIN": "base"
      }
    }
  }
}

Solana 钱包：

{
  "mcpServers": {
    "jarvisclaw": {
      "command": "npx",
      "args": ["-y", "jarvisclaw-mcp"],
      "env": {
        "JARVISCLAW_WALLET_KEY": "YOUR_SOLANA_BS58_SECRET_KEY",
        "JARVISCLAW_CHAIN": "solana"
      }
    }
  }
}

直接使用 URL（无需本地进程）

适用于 Claude Code、Cursor 或任何使用 Streamable HTTP 传输的客户端。少一层转发，但此方式不包含钱包：免费工具可以使用；付费工具则需要预付费 API 密钥，因为这里无法签署付款。

{
  "mcpServers": {
    "jarvisclaw": {
      "type": "url",
      "url": "https://api.jarvisclaw.ai/mcp",
      "headers": { "Authorization": "Bearer sk-your-api-key" }
    }
  }
}

不添加请求头时，同一 URL 仍可免费列出目录；付费工具会返回 x402 报价，你需要自行签署付款。

环境变量

变量	必需	默认值	描述
JARVISCLAW_WALLET_KEY	付费工具需要	—	Base 私钥（0x… 十六进制）或 Solana 密钥（base58）。仅用于本地签名。
JARVISCLAW_CHAIN	否	base	base 或 solana。当服务同时提供两种选项时，指定签名所用的链。
JARVISCLAW_MCP_URL	否	https://api.jarvisclaw.ai/mcp	远程 MCP 端点。
JARVISCLAW_SOLANA_RPC	否	公共主网 RPC	自定义 Solana RPC（推荐使用，因为公共 RPC 有速率限制）。
JARVISCLAW_API_KEY	否	—	可选 API 密钥，通过 Authorization: Bearer 发送。免费工具无需凭据。

工具

工具	功能	计费
list_models	列出所有可用模型，以及传递给 chat 的 ID	免费
search_apis	搜索包含 2,720 个端点的市场；每条结果都包含路径和价格	免费
aip_list_intents	浏览 AIP 可以路由的意图类型	免费
aip_estimate_cost	在执行意图前估算其价格	免费
chat	调用任意模型，兼容 OpenAI	付费
get_api_detail	获取市场 API 的完整规格：定价、方法和准确请求格式	付费
discover_agents	查找在网关注册的其他 Agent	付费
aip_resolve	在花费前，按相关性排序并标价列出适用于某个意图的提供方	付费
aip_execute_with_budget	在你设定的支出上限内端到端执行任务	付费

免费工具无需凭据即可使用，因此你可以先查看目录，再决定是否付费。协议方法（initialize、tools/list、resources/list）也免费。

付费

方式	请求头	适用情况
x402 USDC	PAYMENT-SIGNATURE	无需账户。钱包在 Base 或 Solana 上结算。
API key	Authorization: Bearer sk-…	预付费账户。

调用付费工具时，如果两者都未提供，不会失败——它会返回一份 x402 报价：

tools/call → 402 with payment terms (amount, asset, payTo, network)
          → this proxy signs a USDC authorization locally
          → retry with PAYMENT-SIGNATURE → result

设置 JARVISCLAW_WALLET_KEY 后，所有三个步骤都会在此进程内完成，客户端只会看到结果。未设置时，报价会原样传递给客户端，不会得到响应。

两条链都已上线，大多数 x402 卖家都无法做到这一点：Agent 可以在其已持有 USDC 的链上结算，而无需跨链转账来接入某个网关。每个付费响应都附带一份 EIP-712 签名的结算回执，第三方可以离线验证——重新计算哈希、恢复签名者、检查链上交易——无需信任我们。

安全性

• 钱包密钥从环境变量读取，仅用于在本地签署付款授权。它绝不会发送给网关或任何其他地方。
• 安全上限会拒绝两条链上任何超过 100 USDC 的单笔付款。
• USDC 合约地址、铸币地址、链 ID 和小数位数均固定为协议常量，而非配置项——服务器无法诱使此代理签署其他资产的转账。

依赖项安全公告

npm audit 报告了 3 个中等严重程度的安全公告，问题可通过 @solana/web3.js（其本身，以及 jayson 和 uuid）触达。1.98.4 是最新版本，且处于标记范围内，因此没有可升级到的版本；npm 建议的“修复”是降级到 0.0.3，这并非可行选项。已跟踪，尚未解决。

这也适用于仅使用 Base 的用户：@solana/web3.js 是入口模块中的静态导入，因此无论 JARVISCLAW_CHAIN 设置为何值都会加载（实测：Base 路径会解析 6 个模块）。只有签名器对象会延迟构造。

从源代码构建

npm install
npm run build     # tsc → dist/
npm test          # bun test — x402 signer unit tests

链接

• 网站 — https://jarvisclaw.ai
• API 文档 — https://docs.jarvisclaw.ai
• Python SDK（AIP） — https://pypi.org/project/agent-intent-protocol/
• x402 发现 — https://api.jarvisclaw.ai/.well-known/x402
• A2A Agent 卡片 — https://api.jarvisclaw.ai/.well-known/agent-card.json
• x402scan — https://www.x402scan.com/server/e26bd614-0441-4af5-83db-53ab301e85d6

许可证

MIT