关于 Agent402
Agent402 是面向 AI Agent 的开源、可自托管 MCP 服务,结合网页搜索、引用式回答、确定性工具目录和多工具技能包,并支持通过 x402 和 MPP 按次付费。
主要功能
- 01网页搜索与引用式回答
- 02500 多种可调用工具
- 03浏览器渲染及 PDF、图像和 OCR 工具
- 04金融数据与 CPU 实用工具
- 05多工具技能包
- 06x402 和 MPP 付款
适用场景
- 01为 Agent 任务查找并调用工具
- 02渲染网页或处理 PDF 与图像
- 03运行确定性数据或计算工具
- 04按 API 调用向 Agent 收费
MCP 相关
通过托管连接器或本地运行的服务,向 MCP 客户端提供搜索、工具和技能包;也可作为 HTTP API 使用。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://agent402.tools/mcpclaude mcp add --transport http Agent402 https://agent402.tools/mcp{"mcpServers":{"Agent402":{"type":"http","url":"https://agent402.tools/mcp"}}}在 Cursor 中打开{"servers":{"Agent402":{"type":"http","url":"https://agent402.tools/mcp"}}}在 VS Code 中打开{"mcpServers":{"Agent402":{"type":"http","url":"https://agent402.tools/mcp"}}}{"mcpServers":{"Agent402":{"serverUrl":"https://agent402.tools/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
15| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 需要完成的事项,例如 "search the web for x402"、"answer a question with citations"、"decode JWT" |
| limit | number | 否 | 结果数量上限(默认值为 10) |
详细介绍
Agent402:面向 AI Agent 的 500+ 种工具、按用量计费的模型和成品报告
现已上线 agent402.tools。
面向 AI Agent 的付费入口:500+ 种工具、按用量计费的模型和成品报告,支持通过 x402 和 MPP 使用 USDC 按次付费,也可刷卡支付。Agentic Finance 的应用层。开源、可自托管、原生支持 MCP。
由 Havok Holdings LLC 运营 · 在线服务 · 为何在此付费 · 收据 · 状态 · 安全 · 公司
**30 秒即可试用:**运行 claude mcp add agent402 -- npx -y agent402-mcp,或将 https://agent402.tools/mcp 粘贴到任何 MCP 客户端中。免费层级无需钱包。适用于 Cursor、VS Code、Windsurf、Cline、Roo Code、Codex CLI、Gemini CLI、Continue、ElizaOS 和 AgentCore 的经验证配置说明:agent402.tools/guides/agent-hosts(短链接为 agent402.sh/<host>,例如 agent402.sh/cursor)。
**付费方:**Agent 按次付费(起价 $0.001;模型按用量计费,费用不超过报价上限,并按实际用量结算);个人可刷卡购买成品报告($2 至 $5)和监控服务(每月 $5);网站可通过收费关卡向爬虫收费。
Agent402 是什么
Agentic Finance 指软件 Agent 自主付费和收款:发现服务,通过开放协议(x402、MPP)从钱包按请求付费,收到可验证的收据,并通过按请求收费获得收入。Agent402 是其应用层——说明:agent402.tools/agentic-finance · 术语表。
正在销售 x402 API? 免费将其列入索引,访问
/sell(POST /api/index/register: 自助操作,无需注册,抽成 0%)。当路由显示已收到来自多个独立买家的结算付款后,路由器便会将买家导向卖家;定价不超过 $0.01 的调用可在此之前试用,并会在买家的收据上标记为未经验证。想在自己的网站上向爬虫收费?agent402-tollbooth可为其设置 402 付费门槛。它的不同之处: Agent402 开源且可自托管——只需一次集成,买家就能在整个 x402 生态系统中使用三种免费基础功能:
- 查找 -
/api/find?q={task}将任务描述解析为最匹配的工具(路由、价格、架构、可直接使用的示例)。- 路由 -
POST /api/route是中立的智能订单路由器:对从 Coinbase CDP Bazaar 自动发现的所有 x402 卖家中抓取的工具进行排序,并考虑健康状态;使用include=external可排除我们自身。响应会返回排名前 N 的结果,并通过matched给出评分数量。- 排行榜 -
GET /api/leaderboard是按 Base USDC 结算交易量排列 x402 卖家的公开链上排名——包括每个卖家的已处理调用数、totalUsd 和独立买家数。它返回排名前 N 的卖家,不会返回完整榜单(默认 25 个,上限 50 个;totalSellers提供完整数量)。处理流程:Bazaar →eth_getLogs→ 单次调用上限 → 按payTo聚合。每小时生成快照。此外还有目录——500 多项优质内容:以搜索/回答作为 MCP 入口,然后提供 500 多种工具和精选技能包(可作为 MCP 提示词调用的多工具工作流)——均可自行运行;还有
agent402-tollbooth——面向 x402 另一方的开放式按爬取收费门槛。两种入口,两套价格。 Agent 可通过 USDC 按次付费(x402 / MPP),也可通过工作量证明免费使用;通过这种方式,一份完整的报告费用为 $0.60 至 $2.00。用户可刷卡支付:agent402.tools/reports 上的同类报告(公司档案、13F 基金报告、内部人交易动态、市场简报、深度研究、FDA 召回、域名审计)售价为 $2 至 $5;在发生变化时重新运行的监控项(/monitors)每月 $5;已发放的预付额度密钥仍可按成功调用付费(
Authorization: Bearer a402_…;新额度不再出售)。刷卡价格包含支付处理费用。Agent 按次付费时,同一份报告可享受较低的工具价格。两种支付通道,一个 URL。 每个付费端点均支持 x402 (
PAYMENT-SIGNATURE,支持 12 条链上的 USDC 或 Robinhood Chain 上的 USDG)和 MPP(Machine Payments Protocol,由 Tempo 和 Stripe 联合撰写、正处于 IETF 标准化流程中的PaymentHTTP 认证方案):同一个 402 响应同时携带两者,mppx客户端可开箱即用地完成支付;MPP 可在 Base 和 Celo(USDC)结算,也可原生在 Tempo 上结算(通过 Tempo 中继使用 USDC.e 或 PathUSD),或通过 MPP 刷卡支付(Stripestripe/charge,运营方配置后适用于定价 $0.50 及以上的路由)。MPP marketplace 列出所有可实时验证的 MPP 卖家。详情:什么是 MPP · 实时 MPP 结算。 框架适配器(适用于主流 Agent 技术栈的即插即用工具——底层自动付款):![]()
![]()
![]()
![]()
![]()
![]()
![]()
![]()
功能强大,拥有 500 多项工具——通过 MCP 提供实时网络搜索和带引用的答案,作为入口;再由同一服务为你的 AI Agent 提供开箱即用的网络工具和多工具技能包。每项工具都按调用计费,并在链上结算。支持浏览器
渲染、网络搜索、PDF、图像、OCR、实时金融/加密货币/宏观数据、SEC EDGAR、确定性统计、预测、期权/债券定价(Black-Scholes、YTM)、压缩,以及 150 多项纯 CPU 工具。 30 秒内免费自行运行(MCP 或
纯 HTTP,无需 API 密钥或注册——免费层和 x402/MPP 付款从不需要密钥;只有已签发的预付额度密钥属于持有者密钥),将其连接到 Claude/ChatGPT/任意 MCP 客户端,并用几行代码添加自己的工具。
没有大模型会生成实用工具的答案;每次发布前,CI 可在无需第三方密钥运行的每个工具都会根据自己的示例重新测试。基于模型的服务明确标示并按此定价:/v1 网关(按调用计量,设定报价上限,或采用固定费率套餐)以及完整报告产品(见下文的 /v1/research、/v1/dossier 等)。
可选地,同一服务也可以通过 x402 协议按调用收费(支持 Base、Solana、Polygon、Arbitrum、Monad、Celo、Avalanche、Sei、Optimism、Arc、Stellar 和 Algorand 上的 USDC,以及 Robinhood Chain 上的 USDG——共 13 条链)——因此,你免费 自托管的实例也可以成为托管式营收服务。免费模式只需设置一个选项(
FREE_MODE=true);付费实例需要收款钱包。
🟢 托管演示:agent402.tools · 📖 Wiki · 📦 npm · 🔌 MCP Registry · 🧩 Smithery
30 秒内自行运行
选择适合你的方式。它们都免费且无需钱包:
1. 无需安装——将托管连接器添加到 Claude(claude.ai → Settings → Connectors → Add custom connector):
https://agent402.tools/mcp
2. 一条命令——在本地运行 MCP 服务(纯 CPU 工具无需密钥;它会代你完成少量工作量证明):
npx -y agent402-mcp
# in Claude Code: claude mcp add agent402 -- npx -y agent402-mcp
3. 克隆并托管整个项目(全部 500+ 个工具均可通过 HTTP API + MCP 使用,免费模式,无需付款):
git clone https://github.com/MikeyPetrillo/Agent402 && cd Agent402
npm install
FREE_MODE=true npm start # → http://localhost:3000 (HTTP API + /mcp)
# try a tool over HTTP - no auth in free mode
curl -s -X POST localhost:3000/api/hash -H 'content-type: application/json' \
-d '{"text":"hello world","algo":"sha256"}'
4. 一键部署到 Railway(完整的可自托管实例——可选添加 Postgres + Redis 插件,用于分析和响应缓存):
服务会直接从仓库的 Dockerfile 启动。可选插件会通过 env 自动检测:添加 Redis → REDIS_URL 可启用上游响应缓存(X-Cache: hit|miss);添加 Postgres → DATABASE_URL 可启用公开的 /api/analytics 仪表板。免费模式下无需设置环境变量即可启动。
使用钱包按次付费
每个付费路由都会返回 402,其中同时包含 x402 报价和 MPP 挑战,因此任一种客户端都可以完成付款。无需 API 密钥,无需注册:钱包就是账户。
MPP(Tempo 上的 USDC.e 或 PathUSD,在 402 响应中优先列出;也支持 Base 或 Celo 上的 USDC),使用 mppx:
import { Mppx, tempo, evm } from "mppx/client";
const account = (await import("viem/accounts")).privateKeyToAccount(process.env.AGENT_KEY);
const res = await Mppx.create({ methods: [tempo.charge({ account }), evm.charge({ account })] }).fetch("https://agent402.tools/api/uuid");
x402(Base 及其他链上的 USDC),使用 @x402/fetch:
import { wrapFetchWithPayment } from "@x402/fetch"; import { x402Client } from "@x402/core/client"; import { registerExactEvmScheme } from "@x402/evm/exact/client";
const client = new x402Client(); registerExactEvmScheme(client, { signer: (await import("viem/accounts")).privateKeyToAccount(process.env.AGENT_KEY) });
const res = await wrapFetchWithPayment(fetch, client)("https://agent402.tools/api/uuid");
更多信息:使用 MPP 付款 · 使用 x402 付款。
目录中有什么(500+ 个工具)
每个工具都有其存在价值:按市场定价并在链上结算;每个无需第三方密钥即可由 CI 运行的工具,都会在每次 CI 运行时根据其自身示例进行测试。 CI 会确保目录至少包含 400 个条目,并根据运行中的目录验证“500+”这一说法(
scripts/sync-count.js --check)。 只有值得调用的工具才会加入目录。 | | 示例 | |---|---| | 浏览器与 Web |render(无头 Chromium,可执行 JS)、screenshot、extract(文章→markdown)、meta| | 实时搜索与解答 |search(真实 Web 索引)、search-lite(快速返回 5 条结果的示例)、answer(附带引用的 Web 解答)、search-news/search-images/search-videos变体、search-suggest、multi-search| | PDF 与媒体 |pdf-to-markdown、pdf-merge、pdf-extract-pages、pdf-rotate、images-to-pdf、audio-convert、audio-normalize(EBU R128,真实 ffmpeg) | | 图像 |image-resize、image-convert、image-thumbnail、barcode-decode(jimp/zxing,纯 CPU) | | OCR |image-ocr(从任意图像中提取文本——纯 CPU,无需模型) | | 地理信息 |geo-distance(haversine,纯 CPU)、geocode、reverse-geocode、place-search、geo-lookup| | 实时数据 |fx-rate(ECB)、barcode-lookup(Open Food Facts)、gov-data(data.gov)、weather-forecast/weather-alerts、earthquakes(USGS) | | 金融与加密货币 |stock-quote/stock-history(授权数据源,整合多个交易场所)、crypto-price/crypto-market/crypto-history/crypto-trending/crypto-global(CoinGecko) | | 加密货币衍生品与期权 |perp-markets、perp-funding、perp-funding-screener、perp-basis、perp-open-interest、perp-klines、perp-orderbook(实时永续合约:标记/预言机价格、资金费率、OI、K 线、深度);options-summary、crypto-options-chain、options-ticker、options-volume(期权簿、IV 和希腊值、链上期权交易量)——每次调用 $0.001 至 $0.005,无需交易所账户 | | DeFi 与稳定币 |defi-yields(按链、项目、TVL 和仅稳定币筛选资金池)、defi-yield-history、defi-protocols、defi-protocol、defi-chains、defi-chain-tvl-history、defi-fees、defi-dex-volume、stablecoins、stablecoin-supply-history——每次调用 $0.001 至 $0.003 | | Solana 代币情报 |sol-token-pairs、sol-token-search、sol-trending、sol-price、sol-swap-quote、sol-token-lookup——提供任意 mint 的市场、价格和路由信息 | | 加密货币市场覆盖 |crypto-news、crypto-indicators(RSI、MACD、移动平均线,在此处计算)、crypto-market-pulse、coin-profile、coin-history、coin-ohlc、coin-market-chart-range、coin-categories、coin-price-by-contract(按代币 ADDRESS 查询价格,无需 coin id)、global-defi、exchanges、exchange-tickers、exchange-rates、coin-search、coins-list——还可通过同一个 CoinGecko 密钥查询代币化现实世界资产:rwa-list、rwa-markets、rwa-asset、rwa-issuers、rwa-issuer(代币化股票、ETF 和大宗商品,附带链上市场数据及其发行方信息) | | 索引链上数据 |asset-transfers(筛选转账历史)、token-balances、token-allowance、tx-receipt(已解码的转账)、block-receipts、token-price-history——跨主流 EVM 链读取索引数据,无需节点或自备密钥 | | Farcaster 社交 |fc-cast-search、fc-channel-feed、fc-trending、fc-user-casts、fc-cast、fc-cast-replies、fc-channel、fc-user-search、fc-cast-metrics——在链上社交图谱中搜索、查看信息流和互动指标 | | 网站爬取 |site-map(枚举网站 URL)和site-crawl(广度优先爬取为干净的 markdown,遵守 robots.txt,并严格限制页面数、深度和耗时)——这是完成任何“读取整个网站”任务的确定性组合 | | 宏观数据(FRED 及更多) | 收益率曲线、国债、财政、美联储基金利率、CPI、失业率、Sahm rule、ECB 外汇、世界银行、FRED 批量发布观测值 | | SEC EDGAR | ticker→CIK、文件列表、10-K/10-Q 正文、XBRL 框架、内部人交易、13F 持仓、IPO 日历、全文搜索 | | 成品报告(附引用) |research/research-pro/research-max(有依据的深度研究)、market-brief、dossier/dossier-max(公司尽职调查)、fund-report/fund-report-max(13F 投资组合)、domain-audit/domain-audit-pro(分级安全性与可交付性)、recall-report(FDA)、insider-report(Form 4 流向)、token-risk/token-risk-pro(链上合约风险)、filing-report(最新 SEC 文件)、token-brief(Solana mint 风险证据,数据源可响应时提供)、ticker-pack(尽调档案 + 内部人流向 + 持有者)、ipo-report(S-1 + 424B4 摘要,结果确定)——通过 x402 / MPP 每份 $0.05 至 $2.00,或在 /reports 使用银行卡支付 $2 至 $5;见下方/v1表格 | | 网络信息 |dns、dns-lookup、tls-cert、whois、http-check、robots-check、email-validate、ip-info| | 加密货币与支付 |usdc-balance、tx-status、gas-estimate、ens-resolve、x402-quote、x402-verify、transfer-authorization——非托管、多链(Base/Polygon/Arbitrum/Optimism/Ethereum) | | Agent 记忆 | 以钱包为键的 KV + TTL、原子计数器、跨钱包授权、哈希链审计日志、相似性检索 | | 统计与预测 |stats-summary、correlation、linear-regression、moving-average、outliers;forecast-naive、forecast-ses、forecast-holt、forecast-holt-winters+forecast-eval(MAPE/RMSE 回测) | | 金融数学 |black-scholes(期权定价 + 希腊值)、bond-price/bond-ytm、cagr、sharpe-ratio、annuity、npv/irr、compound-interest、loan-payment/amortization、break-even、effective-annual-rate(纯 CPU,结果确定) | | 压缩 |gzip/gunzip、brotli-compress/brotli-decompress、compress-compare(算法对比,使用 node:zlib,纯 CPU) | | HTML 提取 |html-select(CSS 查询)、html-table、html-strip、html-links、html-meta——与extract对应的确定性工具 | | 网络运维 |dns-lookup、dns-propagation、spf-check/dmarc-check/dkim-lookup、email-deliverability;cert-transparency、http-headers(安全审计)、tech-stack、asn-info(IP 地理信息) | | 链上读取 |block-number、chain-info、block-info、contract-code、erc721-owner、event-logs——通过 JSON-RPC 无需密钥读取,在 Ethereum/Base/Polygon/Arbitrum/Optimism 上支持多端点故障转移,价格从 $0.001 起 | | SQL 策略 |sql-guard($0.004——对 SQL 语句给出 pass/warn/block 判定及具名风险;配置签名密钥后,还会提供 Ed25519 签名的检查结果)、sql-cert-verify($0.001——根据准确的 SQL 语句验证签名结果) | | x402 卖家情报 | 针对同一问题分三档,价格从低到高。seller-trust(GET /api/x402/seller-trust,$0.005)——逐项检查路由器的准入字段:是否已索引、清单能否解析、是否声明了链、是否观察到已结算调用,以及是否会在此处花费买家的资金。seller-dossier(POST /api/seller-dossier,$0.05)——汇总记录:每个价格及其来源、声明的钱包与实际收款钱包对照、各来源的结算证据、按链给出的派发判定及原因,以及路由器向其付款时的情况。seller-payability(POST /api/seller-payability,$0.10)——立即购买一次真实调用并报告每个环节,包括 accept 的 EIP-712 域是否与其指定的代币匹配。前两项离线读取现有信息;第三项会花费 USDC 来验证 | | 150+ 项纯 CPU 实用工具 | 哈希、JWT、base58、JSON⇄CSV/YAML、token-count、text-chunk、json-validate、文本统计、cron 数学、验证器、涵盖 13 个类别的单位转换(一个参数化工具) | 完整架构定义见/openapi.json;机器可读目录见/api/pricing和/llms.txt。不知道需要哪个工具?/api/find?q=<task>可将 任务描述匹配到合适的工具——路由、价格、架构定义和可直接使用的示例—— 让 Agent 无需耗费大量 Token 执行“到处搜索,寻找工具”这一步。
LLM 网关(/v1)——聊天、嵌入、重排、图像、语音和完整报告,按次付费
将任意 OpenAI SDK 指向 base_url = https://agent402.tools/v1,通过 x402 或 MPP 使用
USDC 按次付费——无需 API 密钥、注册或账户(已发放的预付费额度密钥也可使用,参见面向用户):
| 端点 | 价格 | 提供服务 |
|---|---|---|
POST /v1/nano/chat/completions | $0.003 | nano 模型——专为高频 Agent 循环定价 |
POST /v1/auto/chat/completions | $0.01 | 无需指定模型——基于评测排名的确定性路由(代码 / 推理 / 长文本 / 通用),可选 quality: fast | balanced | best,价格不变;通过 agent402_router 公布决策 |
POST /v1/chat/completions | $0.02 | 经济型 / 中端模型(gpt-4o-mini、claude haiku、gemini flash、deepseek、llama…) |
POST /v1/pro/chat/completions | $0.10 | 中端前沿模型(gpt-4o、gpt-4.1、gpt-6 sol、claude sonnet、gemini pro、grok) |
POST /v1/premium/chat/completions | $0.50 | 前沿模型(gpt-5 和 gpt-6 astra、o3 和 o4-mini、claude opus 和 claude fable 5.1) |
POST /v1/grounded/chat/completions | $0.03 | 自动路由器,并在每次调用时进行实时网络搜索——回答附带 OpenAI-wire url_citation 注释;永不缓存 |
POST /v1/{nano,auto,pro,premium}/messages、POST /v1/messages | 对应层级价格 | 每个层级都支持 Anthropic Messages wire(与聊天路由使用相同的允许列表、上限和故障切换);Claude 4.7+ 通过 effort(low 到 max)控制推理深度,较早版本的 Claude 使用 thinking.budget_tokens |
POST /v1/{nano,auto,pro,premium}/responses、POST /v1/responses | 对应层级价格 | 每个层级都支持 OpenAI Responses wire(仅支持函数工具,无服务端状态) |
POST /v1/embeddings | $0.002 | OpenAI 嵌入,最多批量处理 64 个输入——相同的重复请求免费:不收取重复请求的付款;但若在调用前已发送 Tempo 转账,则款项一经发送便不可撤回(输出确定性,默认开启缓存) |
POST /v1/rerank | $0.002 | 兼容 Cohere 的重排({query, documents[], top_n}),最多支持 50 篇文档,默认开启缓存 |
POST /v1/images/generations | $0.08 | 图像生成(FLUX.2 Pro,1024x1024 PNG)——OpenAI images wire,内联 Base64 输出 |
POST /v1/images/fast | $0.02 | 经济型文生图,使用相同的 OpenAI images wire,生成一张图片约需两秒 |
POST /v1/images/pro | $0.05 | 更高保真度的文生图,每次调用生成一张图片 |
POST /v1/videos/generations | $0.20 | 文生视频:一段无声的 4 秒 720p 视频片段,MP4 内联 Base64,16:9 或 9:16 |
POST /v1/audio/speech | $0.06 | 文本转语音,兼容 OpenAI audio.speech.create() wire——输入最多 2,000 个字符,输出原始 MP3(默认)或 PCM 字节,包含 5 模型故障切换链 |
支持流式传输(stream: true)、完整的工具 / 函数调用透传、聊天层级的可选提示词缓存
(cache: true → 10 分钟内字节完全相同的重复请求免费;不收取重复请求的付款,但若在调用前已发送 Tempo 转账,则款项一经发送便不可撤回)、以通过金丝雀验证的模型为终点的上游故障切换链,以及免费的 GET /v1/models 列表,其中列出了
每个模型及其层级和上限。每日会使用真金白银对核心功能进行金丝雀测试(聊天
层级、messages 和 responses wire、嵌入、重排、图像生成
和语音),并涵盖流式传输、路由决策公示以及两种缓存行为。
已完成的报告产品也使用相同的 /v1 前缀:一次付费调用即可获得完整且带引用来源的报告(JSON,附来源附录),而不是原始模型回复。每份报告都以服务器自行获取的第一手数据为依据,再进行综合分析(EDGAR 文件、openFDA、DNS/TLS 探测、链上读取、实时网络搜索);ipo-report 完全确定性(完全不使用模型):
| 端点 | 价格 | 报告 |
|---|---|---|
POST /v1/research · /v1/research/pro · /v1/research/max | $0.60 · $0.85 · $1.10 | 深度研究报告({query})- 基于多轮搜索、重新排序和带引用来源的综合分析 |
POST /v1/research/market-brief | $0.85 | 市场 / 竞争对手简报({query}) |
POST /v1/dossier · /v1/dossier/max | $0.85 · $1.10 | 公司尽职调查档案({ticker})- 文件、内部人士交易流、网络信息 |
POST /v1/fund · /v1/fund/max | $0.60 · $0.85 | 基于最新 13F 的基金投资组合报告({manager})- 上季度买入 / 卖出情况 |
POST /v1/domain-audit · /v1/domain-audit/pro | $0.60 · $0.85 | 评级制域名安全与投递能力审计({domain}) |
POST /v1/recall-report | $0.60 | FDA 药品 / 食品 / 医疗器械召回报告({query}) |
POST /v1/insider-report | $0.60 | 基于已解析 Form 4 文件的内部人士交易流报告({ticker}) |
POST /v1/filing-report | $0.85 | 阅读最新 SEC 文件并总结其中产生影响的事实({ticker}) |
POST /v1/token-brief | $0.60 | 基于链上数据和市场数据的 Solana 代币风险证据({mint}),在其数据源正常响应时可用 |
POST /v1/ticker-pack | $2.00 | 一份报告涵盖一个股票代码:档案、内部人士交易流和持有者 |
POST /v1/token-risk · /v1/token-risk/pro | $0.60 · $0.85 | 基于链上证据的代币和合约风险报告({address, chain}) |
POST /v1/ipo-report | $0.05 | IPO 管线摘要,通过 EDGAR 全文搜索获取 S-1 + 424B4({days, keyword}),确定性生成 |
报告仅支持钱包支付(x402 / MPP / 预付额度,不支持工作量证明),生成需要几分钟。同样的报告也通过银行卡以 $2 至 $5 的价格出售给用户,具体价格取决于报告深度,详见 agent402.tools/reports。银行卡价格包含支付处理费;Agent 通过 x402 或 MPP 按次付费,可用较低的工具价格获得相同报告。
两款配套工具构成完整闭环:POST /api/route/execute($0.01;针对较贵工具,还提供 execute-plus $0.05、execute-max $0.55 和 execute-pro $3.30 档位)可根据任务描述找到最佳工具,并通过一次付费调用运行该工具。使用 include:"external" 时,还可调用其他 x402 卖家销售的工具(它根据已验证的链上结算交易量进行路由;唯一例外是尚无历史记录的 Base 或 Solana 卖家,仅会在所有已验证候选项都尝试过之后才进行尝试,每次调用设有较低额度上限,并会在回执中标记为未经验证;它会在你付款所用的链上向卖家购买结果,然后转售给你,支持 Base、Solana、Algorand 或 Tempo;详见智能订单路由指南);POST /api/my-usage($0.005)则会返回付款钱包自身的购买记录——无需钱包参数;x402 付款即是身份凭证,因此任何人都无法读取其他钱包的资料。
面向用户:报告和监控
同一目录还提供一个支持银行卡支付的入口(Stripe Checkout;运营方通过 STRIPE_SECRET_KEY 启用,否则这些页面不会挂载):
| 页面 | 可获取内容 |
|---|---|
| agent402.tools/reports | 使用银行卡购买上表中的任意已完成报告(POST /api/buy),价格为 $2 至 $5(最深入的层级和股票代码包处于该价格区间的上限;当前价格请查看页面),报告会发送至 /r/<session>——无需钱包或账户。银行卡价格包含支付处理费;Agent 按次付费时,同一份报告的工具价格更低。只有经过 Stripe 验证的已付款会话才能生成报告,且仅生成一次;生成失败会自动退款。 |
| agent402.tools/monitors | $5/月的订阅服务:当情况发生变化时重新生成报告并通过电子邮件发送给你(任意 30 天内最多 4 份完整报告;超出上限的变化会通过提醒邮件发送):域名安全监控(每日免费重新探测;发生安全变化、证书将在 14 天内到期,或每隔 30 天时,付费重新生成完整报告)、SEC 文件监控(有新文件提交时)、Solana 代币风险监控(风险事实发生变化时,数据源可用期间提供)、基金 13F 监控(有新文件提交时)、FDA 召回监控(出现新的召回编号时)、内部人士交易监控(有新的 Form 4 时)、IPO 动态监控(每周摘要)。报告会存放在 /m/<id>;可通过 Stripe Customer Portal 在 /monitors/manage 管理或取消订阅。 |
| agent402.tools/credits | 预付额度:当前不出售。已发放的密钥(a402_…)仍可使用;在任何收费路由中通过 Authorization: Bearer a402_… 发送该密钥,即可从余额中扣费——仅在成功响应时扣款,以整数微美元计价,因此可精确处理不足一美分的价格,且永不过期。GET /api/credits/balance(使用相同的请求头)可读取余额;若返回包含 {reason, balanceUsd, topup} 的 402 响应,表示余额不足。绑定身份的工具(/api/memory*、my-usage)不接受额度支付,因为在这些工具中,支付本身就是身份凭证;请通过 x402 支付。 |
已发放的额度密钥可供 SDK 使用:agent402-mcp 会读取
AGENT402_CREDITS_KEY,而 agent402-client 接受 { creditsKey }。
决策 - 描述任务,获取计划
POST /api/decide 会将自然语言任务转换为可直接用于调用的计划:从本目录以及在过去一周内通过 402 验证的外部 x402 卖家中选出工具,确定调用顺序和回退方案,提供符合各工具架构验证规则的输入,以及费用和延迟估算。
按深度收费:quick(一个最佳工具)、plan(步骤和回退方案)和 full(另附编译后的提示词);通过 x402 或 MPP 支付时,每次决策价格从 $0.005 起。
curl -X POST https://agent402.tools/api/decide \
-H "Content-Type: application/json" \
-d '{"task":"Check whether wallet 0xd8dA...6045 is on a sanctions list, then list its recent token transfers on Base","depth":"plan"}'
- 排名中立。 所有候选工具均按同一公式评分(匹配度、实测可靠性、价格、架构质量、新鲜度),评分不考虑工具的销售方;每个步骤都会标明工具是否属于我们(
firstParty)。 - 费用可抵扣。 决策费用会作为 24 小时内有效的额度,抵扣
POST /api/decide/execute的费用。该接口会执行计划:我们的工具直接调用;外部步骤则从卖家处购买,再按卖家价格加上明确披露的 5% 加价转售。支出不会超过预算,回退方案按顺序尝试;若执行中没有任何步骤成功,则不收费。 - **在 MCP 中,**同一组接口为
decide.plan和decide.execute;decide.feedback(免费)用于记录某个步骤是否成功。页面:agent402.tools/decide。
技能包 - 70 多种多工具工作流
对于跨多个工具的任务——“审计域名”“诊断邮件送达能力”“分析时间序列”“剥开不透明数据块”——Agent402 提供精心策划的 技能包:按顺序排列、类型明确的工具调用序列,并附带适用于 Claude 的提示词模板。可作为 MCP 提示词(prompts/list → prompts/get { name, arguments })调用,也可通过普通 HTTP 访问:GET /api/skill-packs/{slug}/prompt(所有 slug 均列在免费的 JSON 索引 /api/skill-packs.json 中)。针对任务的 catalog.search 查询(托管连接器的搜索工具;旧名称 search_tools 仍可作为别名使用)会返回匹配的技能包以及单个工具。
| 精选技能包 | 调用链 | 适用场景 |
|---|---|---|
security-audit | cert-transparency · dns-lookup · spf-check · dmarc-check · http-headers · tls-cert · tech-stack | 评估域名安全状况 |
trend-analysis | stock-history · fred-series · stats-summary · moving-average · linear-regression · outliers · correlation · forecast-eval | 对任意时间序列进行定量分析 |
structured-scrape | extract · render · html-select · html-table · html-strip · html-links · html-meta | 确定性的抓取决策树 |
decode-blob | jwt-decode · gunzip · brotli-decompress · base64 · hex · json-format · hash | 识别并剥解任意不透明字符串 |
forecasting-bake-off | stock-history · fred-series · forecast-eval · forecast-naive · forecast-ses · forecast-holt · forecast-holt-winters | 按 RMSE 对 4 种预测方法进行排名,并选出最佳方法 |
document-intel | pdf-info · pdf-to-markdown · pdf-extract-pages · image-ocr · barcode-decode · pdf-merge · images-to-pdf | PDF/OCR/条形码处理流程 |
status-snapshot | dns-lookup · http-check · http-headers · tls-cert · robots-check | 一次性服务健康状况检查 |
全部 80 多种技能包见 /skills · JSON 索引见 /api/skill-packs.json ·
在 MCP 中,技能包会显示在 prompts/list 下,因此任何兼容 MCP 的客户端都会自动获取它们。
x402 索引 - 查找 · 路由 · 排行榜
Agent402 也是 整个 x402 生态系统的开放路由与排名层:它会爬取公开的 x402 卖家(本地目录以及从 Coinbase CDP Bazaar 自动发现的一组卖家,每小时更新),并通过三个免费入口提供这些卖家——其逻辑与 /api/find 相同:发现功能不应收费。
| 表面 | 内容 |
|---|---|
GET /api/find?q={task} | 将任务解析为最匹配的工具(路由、价格、架构、可直接使用的示例) |
POST /api/route | 智能订单路由器:{ query, top, include } → 跨卖家的工具排名(先按匹配分数,再按健康状况,最后按价格;随后由判断模型将真正能完成任务的条目移至首位,同样合适的工具中价格最低者胜出,结果报告在 judged 中)。include=external 会排除 Agent402 自身 |
GET /api/leaderboard | x402 卖家的链上排名,依据在 Base 上结算的 USDC 交易量(每个卖家的 callsSettled、totalUsd、uniqueBuyers)。仅返回前 N 名——默认 25 名,上限 50 名;totalSellers 表示完整总数。处理流程:Bazaar → eth_getLogs → 单次调用上限 → 汇总。每小时生成快照 |
/marketplace | 公共 HTML 仪表板:所有卖家、工具数量、网络、最近抓取时间、滚动健康状况 |
GET /api/index | JSON 格式的卖家索引(总数、各卖家的健康状况/可路由标志)。分页——每页最多 250 条;还有更多内容时返回 complete: false,并在 Link 标头中带有 rel="next";sellerCount 表示总数。获取单个来源及其完整爬取历史:?seller=<host> |
/stellar · /algorand | 按链划分的市场页面:专门在相应通道上结算的卖家和工具 |
# "I need an OCR tool - find me the cheapest healthy one anywhere on x402"
curl -X POST https://agent402.tools/api/route \
-H 'content-type: application/json' \
-d '{"query":"ocr image to text","top":5}'
# "Who are the most-used x402 sellers right now? (on-chain proof, not self-reports)"
curl 'https://agent402.tools/api/leaderboard?top=25&include=external'
**派发状态明确标注,绝不含糊:**每条 /api/route 记录和 /api/index
卖家信息都带有 routerDispatchEligible 和 routerDispatchReason(crawl_failed、
network_unknown、settlement_required、settlement_checked_at_pay_time、
eligible 等);只有路由器此刻会为其付款的记录才会显示 executeVia
(executeViaCallableNow: true),否则层级会移至
executeViaWhenEligible。routable 表示爬取就绪状态,绝不代表承诺付款。
对于按清单定价的路由,系统还会实时读取一次,之后每周读取一次,因此即使卖家的清单滞后,路由记录中也会包含其 402 实际提供的链。
**考虑健康状况:**最近几次爬取出错的卖家会被路由器排除(买家被路由到失效卖家会白白浪费资金)。匹配分数和价格相同时,健康状况更好的卖家也会胜出,因此不稳定但便宜的卖家会输给可靠的卖家。对于刚加入、尚无历史记录的卖家,系统会给予宽待。
**判断适配度:**词法评分会奖励名称中重复出现任务关键词的条目,因此某个卖家的 20 条狭窄路由可能会排在能完成任务的通用工具之前。现在,判断模型会读取候选清单——每个卖家最多两条记录,加上本地目录中的最佳匹配项——并将真正能完成任务的条目移至首位;若有多个条目效果同样好,则选择最便宜的。它绝不会添加结算门槛未准入的卖家,也可以判定“这些都不合适”(此时 route-execute 会在付款前拒绝),而且出现故障时会回退到词法排序。工具本身仍不会运行模型;这仅用于路由器做出选择。
运营方可在仪表板上查看三类通道归因(/api/stats、
/__operator,需令牌授权——未提供运营令牌时会返回 404):USDC、工作量证明和心跳探测流量分别计数;心跳通道由 POW_SECRET 签名令牌控制(而非可伪造的 User-Agent),因此运营视图反映的是真实外部需求。
面向 API 卖家:/sell 是入口——通过
POST /api/index/register 免费将现有的 x402 API 列入索引
(按健康状况路由、抽成 0%、自助服务、无需注册),或安装 agent402-tollbooth,在尚未原生支持 x402 的网站前设置按爬取付费的访问门槛。
在代码中,agent402-client npm 包封装了这一切——
先用 find() 查找工具,再用 call() 调用,付款会自动处理(免费工具使用内置的工作量证明,付费工具使用你的 x402 钱包),并提供缓存和幂等重试:
npm install agent402-client
import { Agent402 } from "agent402-client";
const a = new Agent402(); // free tier (proof-of-work)
const out = await a.call("hash", { text: "hello world", algo: "sha256" });
// a prepaid credits key already issued pays wallet-only tools (new credits are not on sale)
const b = new Agent402({ creditsKey: "a402_..." });
实时支付视图(services/live)
这是一个独立的只读服务,可在 Base 上的 x402 支付和 Tempo 上的 MPP 支付结算时将其呈现出来。它读取公共链 RPC 和公共发现列表,在内存中保留最近一小时的数据,并通过一个服务器发送事件流向浏览器推送数据;它与 API 不共享进程、数据库或密钥。托管地址为 https://live.agent402.tools。
在本地运行(Node 22+,无依赖):
cd services/live
PORT=8090 node server.js # then open http://localhost:8090
node test.js # offline tests
可选设置:LIVE_BASE_RPCS 和 LIVE_TEMPO_RPCS(以逗号分隔的 RPC URL)、LIVE_INCLUDE_UNLISTED=1(也统计支付到未在发现列表中命名的钱包的 Base 支付)、LIVE_INTERNAL_PAYERS(标记为测试流量的付款方钱包)、LIVE_MAX_PAYMENT_USD(默认值为 50)。
接入你的 Agent 框架(零依赖适配器)
如果你已经在使用以下某个技术栈——OpenAI、Anthropic、Vercel AI SDK、LangChain(JS 或 Python)、LlamaIndex、Strands、Google ADK 或 OpenAI Agents SDK——就不必再自行接线:有一个即插即用的包,可将 Agent402 目录转换为适用于你框架的原生工具对象,并在底层处理付款(免费工具使用工作量证明;传入 @x402/fetch 时,使用 x402+USDC):
| 技术栈 | npm | 返回值 |
|---|---|---|
| OpenAI function-calling(chat.completions / Assistants v2 / Responses) | agent402-openai-tools | 供 tools: 参数使用的 tools[] |
Anthropic Messages API(tool_use) | agent402-anthropic-tools | 供 tools: 参数使用的 tools[] |
Vercel AI SDK(streamText / generateText) | agent402-ai-sdk | Record<name, tool()> |
| LangChain JS / LangGraph | agent402-langchain | DynamicStructuredTool[] |
| LlamaIndex TS | agent402-llamaindex | FunctionTool[] |
| Strands Agents(AWS Bedrock AgentCore) | agent402-strands | 供 new Agent({ tools }) 使用的 StrandsTool[] |
| Google ADK(Agent Development Kit) | agent402-google-adk | 供 ADK Agent 使用的 FunctionTool[] |
| OpenAI Agents SDK | agent402-openai-agents | 适用于 @openai/agents 的 Agent tools |
| Coinbase AgentKit(CDP、Privy、ZeroDev、viem 钱包) | agent402-agentkit | 供 AgentKit.from({ actionProviders }) 使用的 ActionProvider |
| LangChain Python / CrewAI | agent402-langchain(PyPI) | 通过 Agent402Toolkit.get_tools() 获取的 StructuredTool[]——四个元工具(find / route / call / about),而不是每个 slug 一个工具 |
// e.g. OpenAI - every adapter has the same surface.
import OpenAI from "openai";
import { agent402Tools } from "agent402-openai-tools";
const openai = new OpenAI();
const { tools, execute } = await agent402Tools({ slugs: ["extract", "hash", "render"] });
const res = await openai.chat.completions.create({ model: "gpt-4o-mini", tools, messages: [...] });
// when the model returns a tool call: await execute(call.function.name, JSON.parse(call.function.arguments));
已经在使用 Claude/MCP?agent402-mcp 仍是更好的选择——将 https://agent402.tools/mcp 粘贴到你的客户端即可。适配器适用于无法使用 MCP 的直接 API 集成。源码:adapters/。
**OpenClaw Agent:**直接加入 skills/openclaw/agent402/SKILL.md——它会教会 OpenClaw Agent 查找、付费(Base 上的 x402 USDC、也接受另外 11 条链,或免费的工作量证明)并调用 500 多种工具和工具包。
添加自己的工具(约 15 行)
工具只是工具包数组中的一个对象。将其放入
src/tools/ 中的任意文件(例如,追加到 src/tools/agent-kit.js 中的 AGENT_TOOLS)
即可立即生效——完成路由、发布架构、通过 MCP 暴露,并通过“每个工具都能回答自己的示例”CI 检查:
{
route: "POST /api/reverse",
name: "Reverse text",
slug: "reverse",
category: "text",
price: "$0.001", // free via proof-of-work for pure-CPU tools
description: "Reverse a string. Example: {\"text\":\"abc\"} → {\"reversed\":\"cba\"}",
discovery: {
inputSchema: { properties: { text: { type: "string" } }, required: ["text"] },
example: { text: "abc" }, // CI calls this and checks it works
},
handler: (input) => {
if (typeof input.text !== "string") { const e = new Error('"text" required'); e.statusCode = 400; throw e; }
return { reversed: [...input.text].reverse().join("") };
},
}
这就是全部约定:handler(input) 返回一个可序列化为 JSON 的对象(对于 4xx 错误,则抛出带有 .statusCode 的 Error)。纯 CPU 工具会自动通过工作量证明免费使用;访问网络或磁盘的工具则仅限钱包付费。完整操作指南请参阅 CONTRIBUTING.md。
可选:使用 x402 按次收费
同一服务可以要求每次调用付费——适合托管公共实例。默认采用收费模式:直接运行 npm start 会失败关闭,除非设置了 WALLET_ADDRESS,否则进程会退出;不收费运行需要显式选择加入(FREE_MODE=true npm start)。如需收费,请设置 WALLET_ADDRESS 和 CDP facilitator 密钥(可在 portal.cdp.coinbase.com 免费获取),Agent 会通过标准 x402 客户端使用 USDC 在 Base 上付款(也支持 Solana、Polygon、Arbitrum、Monad、Celo、Avalanche、Sei、Optimism、Arc、Stellar、Algorand;或通过 PAYMENT_NETWORKS=…,robinhood + ROBINHOOD_FACILITATOR_URL 使用 Robinhood Chain 上的 USDG):
每个 402 响应都符合 @x402/core 自身的架构(最多五个标签,CI 会检查所有路由),并且会两次携带类型化输出架构:一次位于 bazaar 发现扩展中,另一次作为第一个 accept 中的 accepts[0].outputSchema。因此,读取规范中该字段的客户端可以在付款前看到响应结构。
可选:设置 GATEWAY_NANOPAYMENTS=on,即可在 Arc 和 Base 上,除普通 accept 外再添加 Circle Gateway 批量 accept(价格和 payTo 相同;已将 USDC 存入 Gateway 的买家可免 gas 按次签名,Gateway 会在链下结算到你的 Gateway 余额,可通过 scripts/gateway-withdraw.js 提取)。默认关闭;请参阅 wiki 的 Self-Hosting 页面。
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/extract", {
method: "POST", headers: { "Content-Type": "application/json" },
body: JSON.stringify({ url: "https://agent402.tools/guides/x402-in-5-minutes" }),
});
MPP 双栈。 付费墙也支持 MPP(Machine Payments Protocol——来自 tempoxyz/mpp 的 IETF 标准化 Payment HTTP 身份验证方案):同一个 402 响应会携带 WWW-Authenticate: Payment 挑战,使用 Authorization: Payment 凭据进行结算,结算后的响应则返回 Payment-Receipt。这里提供两种 MPP 方式:evm 的结算方式与 x402 完全相同(EIP-3009 USDC、相同的 facilitator、相同的价格);tempo 则通过 Tempo 自带的中继原生结算(TIP-1034/TIP-20,不涉及 x402 facilitator)——这是完全独立的结算路径,设置 TEMPO_API_KEY 即可启用。无论哪种方式,mppx 客户端都可以开箱即用;设置 MPP_SECRET_KEY 即可在你自己的实例上启用该兼容层。两种方式使用相同的 URL——由买家的客户端选择协议格式。
没有钱包的 Agent 仍可通过求解一次性 sha256 工作量证明来使用所有纯 CPU 工具(在笔记本电脑上只需不到一秒;MCP 服务会自动完成)。详情请参阅: wiki:使用 x402 付款 · 使用 MPP 付款 · 使用计算量付款。
为什么在这里付费——七项不同之处
每项说法都链接到可验证它的页面(线上版本,主页上的一个版块:agent402.tools/#why)。
- 按模型实际使用量付费,并预先报出上限。 计量网关(
POST /v1/metered/chat/completions)会根据请求正文为每次 402 报价;钱包按upto付款时,最终按上限内的实际用量结算,提示词缓存读取等提供商折扣会直接传递给你,每个已结算的 x402 或 MPP 响应都附带收据;使用 EVM 钱包购买的 JSON 答案,可由该钱包在 Base 上进行证明(POST /api/attest)。 - x402 调用失败不会扣费,响应会证明这一点。 结算在处理程序执行后进行,错误状态会取消结算,因此没有付款收据的响应,或收据标记为
success:false的响应,都表示没有资金转移;携带相同Idempotency-Key和相同付款凭证重试,会重放已付费的答案,而不会再次付款;使用相同已签名 EVM 付款重新发送的请求,即使没有密钥,也会返回首次生成的答案(X-Replayed-Answer: 1);唯一遗留情况(错误响应中出现已结算收据)会由我们的告警自动检测,并记入退款账本作为欠款,绝不会悄悄核销。 - 一把密钥,购买一切。 同一个钱包可为四种接口上的五个 LLM 档位(OpenAI chat、OpenAI Responses、Anthropic Messages、Gemini generateContent)、嵌入、重排、图像、视频、语音、转录、带引用的有据可查答案、500 多种工具和完整报告付款;EVM 钱包还可作为其自身记忆的密钥。
- 无需钱包。 工作量证明可为纯 CPU 工具付款;通过 MPP 使用银行卡可购买定价为 $0.50 或更高的路由;银行卡结账可购买完整报告。此外,还支持十三条链上的 USDC 或 USDG,以及 Tempo 上的原生 MPP。
- 工作成果完整,可直接使用。 包括调查档案、内幕资金流、13F 持仓、申报文件报告、IPO 摘要、域名审计、代币风险、深度研究、市场简报、回忆提醒和 LinkedIn 文章套件,均以实时来源为依据,且大多数附带可下载的数据附录;监控器会按计划免费检查,并在事实发生变化时重新运行付费报告,每 30 天最多提供 4 份完整报告。
- 我们从其他卖家采购。
POST /api/route/execute会在整个生态系统中为任务找到最佳卖家,使用我们的钱包向该卖家购买结果,再凭一张收据卖给你。卖家必须有经过验证的链上结算记录才能参与路由;唯一有限例外是历史记录为零的 Base 或 Solana 卖家,但每次调用都有较低的额度上限。 - 一切都可核验。 由生产环境之外的两个探针观测运行时间(
/status),每天通过每条链上支付通道执行一次真实资金金丝雀测试,按支付通道和接口公布交易(/revenue),并且开源、可自托管。确定性工具不会运行模型;会运行模型的工具都已明确列出(/v1 档位、报告产品、图像、语音、转录、嵌入和 AI 答案工具、Decide 规划器,以及可从路由器筛选出的候选项中作出选择的判断模型)。运营方的身份已在链上标明:Agent402 是 Base 上 ERC-8004 Identity Registry 中的 agent 94639,可解析到/.well-known/agent-registration.json,并在/.well-known/agent-card.json提供 A2A Agent 卡片。
为什么它值得信赖
- 所有内容都经过测试 - CI 会使用各工具自带的文档示例,调用每个不需要第三方密钥的工具;任何失败都会阻止发布。需要密钥或由模型驱动的工具则通过输入探测和每日付费金丝雀测试覆盖,因为 CI 不持有任何第三方密钥。两个相互独立、位于生产环境之外的探测器会监测线上实例(其中一个每 5 分钟检查一次,且与另一个使用不同的基础设施),它们观测到的结果会公开显示在
/status;如果某天没有观测记录,就会显示“无数据”,而不是正常运行时间,因为服务中断时探测器恰恰无法报告。 - 安全加固 - 对每个 URL 工具都实施连接时 SSRF 防护(可抵御 DNS 重绑定攻击)、已签名/单次使用/限定 slug 的工作量证明、按 IP 限流,以及安全标头。参见 wiki:安全模型。
- 确定性实用工具 - 实用工具的服务路径中没有模型:纯计算工具对相同输入始终返回相同输出;实时数据工具则返回其来源的当前读数,并提供完整的 OpenAPI 架构。
- 可审计的链上收入 - Base 上的付费调用以 USDC 结算至
agent402.base.eth(这是一个指向公开收款钱包的 Base 名称);其他所有链的收款地址都可在实时 402 响应和/.well-known/x402中查看,因此任何人都能在链上核验;实时计数见/api/stats。 - 采用 AGPL-3.0 许可,可轻松自托管 - 克隆项目,移除不需要的内容,再添加所需内容。
Agent402 在 x402 生态系统中的定位
x402 是一种基于 HTTP 402 Payment Required 构建的开放支付协议,支持机器对机器以稳定币(USDC)按次付费。
该领域的大多数项目属于协议 + SDK、入门模板或支付服务商。Agent402 是应用层 -
一个可直接运行的 x402 服务,已支持该协议并附带 500 多个可用工具,因此你无需自行构建工具目录。
- 想要协议或 SDK? → coinbase/x402。
- 想要一个今天就能运行、真正通过 x402 + MCP 执行任务的服务? → 你来对地方了。
- 可自托管;无需钱包即可通过工作量证明免费使用;支付工具采用非托管模式(你的 Agent 使用自己的密钥签名,我们不会为其持有任何加密货币余额;预付卡额度属于托管余额,并会明确标注)。
已列入官方 MCP 注册表,并可在 Coinbase x402 Bazaar 中发现。
开箱即用,兼容 AWS Bedrock AgentCore Payments - AgentCore 会编排 x402,而 Agent402 已支持该协议。将 AgentCore Gateway 指向 https://agent402.tools/mcp,即可使用全部 500 多个工具;或者在 Strands Agent 中使用 agent402-strands,获取精心挑选的工具子集。五分钟快速配置指南:wiki:AWS Bedrock AgentCore。
Tollbooth - 为你的网站按抓取收费(x402 的另一面)
向访问你网站的 AI 爬虫收费。人类用户可免费浏览;已知的机器人会收到
402 Payment Required,并可通过 x402 使用 USDC 付款,或完成免费的
工作量证明。这是对 Cloudflare 封闭式按抓取收费方案的开放、原生加密货币替代方案:不绑定 CDN、不用 Stripe、无需名义商家,也无需注册。
- 产品页面 · 定价 · 在线安装: agent402.tools/tollbooth
- 自行运行(MIT、npm):
npm i agent402-tollbooth·tollbooth/· tollbooth/README.md
可作为 Express 中间件、Next.js / Vercel Edge 中间件、Cloudflare
Worker、反向代理或 WordPress 插件(测试版)运行。可直接使用的模板位于
tollbooth/deploy/。一个 Web-Crypto 核心为所有这些部署方式提供支持。
从 0.9.x 开始,网关也原生支持 MPP:传入你的 @x402/express
中间件(createTollbooth({ x402 })),它就会基于同一个 402 生成 WWW-Authenticate: Payment
EVM 挑战;也可以提供 Tempo 中继密钥
(createTollbooth({ tempo: { apiKey, recipient, currency, splits } })),它就会在 Tempo 上结算 MPP tempo/charge 凭证,并支持可选的分账,
完全无需 x402 中间件。
从 0.10.0 开始,边缘构建版本也支持 MPP:设置好 secret、payTo 和你的
verifyX402 回调后,每个 402 都会在 x402 报价旁附带一个 WWW-Authenticate: Payment
挑战;Authorization: Payment 凭证
(与该挑战进行 HMAC 绑定、尚未过期且专为该资源签发)会被转换为
PAYMENT-SIGNATURE,并交给同一个验证器处理。
仓库结构
| 路径 | 内容 |
|---|---|
src/server.js | Express 应用 + 工具目录(路由、价格、架构、发现) |
src/tools/ | 工具套件(Web、PDF、媒体、图像、实时数据、加密货币/x402、150+ 个纯 CPU 工具)——在此处添加工具 |
src/mcp-http.js | 托管 MCP 连接器(可流式传输的 HTTP、无需身份验证的免费层) |
src/pow.js | 工作量证明层(已签名、单次使用、限定 slug 的挑战) |
src/payments.js | 可选的 x402 v2 接线:Base/Solana/Polygon/Arbitrum/Monad/Celo/Avalanche/Sei/Optimism/Arc/Stellar/Algorand 上的 USDC + Robinhood Chain 上的 USDG(13 条链)、CDP facilitator、Bazaar 发现 |
src/mpp-shim.js, src/mpp-tempo.js, src/mpp-stripe.js | 同一路由上的 MPP:将 Payment 挑战/凭据转换为 x402(evm)、通过 Tempo 的 relay 进行原生 Tempo 结算,以及通过 MPP 使用 Stripe 卡支付 |
src/x402-index.js | x402 Index + Smart Order Router:跨卖家抓取、自动发现、基于健康状态的路由、按链划分的市场页面(/stellar、/algorand) |
src/sell.js | /sell——卖家入口:免费自助上架(POST /api/index/register)或使用 agent402-tollbooth 按抓取付费 |
src/human-checkout.js | 报告产品的银行卡入口:/reports(页面位于 src/human-reports-page.js)、POST /api/buy,在 /r/:sessionId 交付(Stripe Checkout、仅生成一次、失败时自动退款) |
src/stripe-subscriptions.js | /monitors——每月 $5 的监控订阅(MONITOR_PRODUCTS:domain、filing、token、fund、recall、insider、ipo)、经签名验证的 webhook、Customer Portal |
src/monitor-scheduler.js | 监控服务的交付:低成本每日探测、变更时付费重新运行、电子邮件交付、报告位于 /m/:id |
src/credits.js | 预付卡额度:/credits、a402_ bearer 密钥,以及每个定价路由前的先授权后扣款关卡 |
mcp/ | agent402-mcp npm 包(stdio MCP 服务) |
client/ | agent402-client 买家 SDK(find() + call(),支持自动付款) |
tollbooth/ | agent402-tollbooth 按抓取付费关卡(Express / edge / proxy) |
adapters/ | 适用于上方适配器表中所有框架的即插即用工具(npm,另有适用于 LangChain/CrewAI Python 的 PyPI 包 langchain-py) |
wiki/ | GitHub wiki 的源文件(由 CI 同步) |
scripts/ | 测试、演示、运维工具 |
法律声明
- agent402.tools 上的托管实例依据其 服务条款(包括可接受使用政策——使用本服务,包括以编程方式使用,即表示接受这些条款)和 隐私政策提供。
- AI 网关流量(
/v1聊天、嵌入、图像、语音)还须遵守上游模型提供商的使用政策。用于违规内容的钱包会在结算前被封禁(WALLET_BLOCKLIST)。 - 服务器代码采用 AGPL-3.0 许可并按原样提供;每个已发布的 npm 包均采用 MIT 许可,并在其目录中附有自己的 LICENSE 文件:
agent402-mcp(mcp/)、agent402-client(client/)、agent402-tollbooth(tollbooth/)、agent402-openclaw(openclaw/)、agent402-agentkit(adapters/agentkit/)、elizaos-plugin-agent402(adapters/eliza/)和 facilitator(facilitator/)。GitHub 仓库级别的许可徽章显示的是服务器的 AGPL;适用于某个包的是其license字段和所在目录中的 LICENSE。按原样提供,不附带任何保证(参见 LICENSE 和 NOTICE)。“Agent402”和徽标是 Havok Holdings LLC 的商标——许可涵盖代码,不涵盖名称;分支必须更名(参见 TRADEMARKS.md)。 如果你自行托管,你就是运营方:你的部署、你的条款、你的合规责任—— Havok Holdings LLC 仅运营托管实例,不对第三方部署承担责任。
联系方式
- 电子邮件: [email protected]
- X / Twitter: @Agent402Tools
- GitHub: MikeyPetrillo/Agent402
参与贡献
欢迎提交 PR,添加实用工具、修复 Bug 或改进文档——请参阅 CONTRIBUTING.md。服务端采用 AGPL-3.0 许可证,每个已发布的软件包均采用 MIT 许可证(请参阅上文的 Legal)。由 Havok Holdings LLC 维护。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。