gold402-mcp
gold402-mcp
一个基于 gold-402 的 MCP 服务器——这是由 24K Labs 维护的精选 x402 目录。它为任何支持 MCP 的代理(Claude、Cursor,或任何支持 MCP 的工具)提供四个工具,用于查找 x402 服务,并在端点花钱之前对其进行检查。
状态:v0.1 — 已测试、已打包、尚未发布。 通过 stdio 运行。
工具
工具 | 功能 |
| 按自由文本和/或目录名称搜索。分页。每个答案都会说明实际搜索了多少条目。 |
| 全部 13 个分类及其真实的精选数量,以及其中有多少可在此处搜索。 |
| 按名称获取单个条目——URL、描述、分类、首次收录日期、永久列表页面。 |
| 实时探测任何 x402 端点,无论是否已收录。 一次未付费请求:它是否响应、是否为真正的 402、支付条款是什么、源站是否发布清单——以及它是否在我们的目录中。 |
| 付费,Base 上 0.001 USDC。 24K Labs 对单个资源的编辑评审,以及聚合的独立评分者评级。这是判断层——维护者看过它,并为其署名。 |
免费与付费
五个工具中有四个是免费的,并且保持免费——搜索、分类、条目查询和实时探测。无需密钥、无需钱包、无需账户。
gold402_verdict 是付费的:Base 上 0.001 USDC。 它是唯一一个付费工具,它购买的是免费探测明确不提供的东西——人工判断。有效的 402 证明门是通的;评审则是维护者表示它值得陌生人花钱。
此服务器从不持有钱包,也从不代你付款。 调用一次 gold402_verdict,不带 payment_signature,它会返回解码后的 x402 条款——价格、网络、资产、payTo、超时。用你自己的钱包签名,然后带上签名再次调用。资金从你直接到 24K Labs;此过程不在路径中。
gold402_check_endpoint 是维护者运行的门检查,现已可调用。它适用于不在目录中的端点,这正是重点:一个即将向陌生人付款的代理可以先询问。
Related MCP server: x402 Atlas
答案声称什么,以及不声称什么
收录意味着维护者探测过它,并且在评审时它正确响应了 x402 请求,我们会定期重新探测。它不是对提供方的审计、对可用性的保证,或对任何调用会成功的承诺。有效的 402 证明门是通的——而不是服务会交付。每个响应都带有 as_of 时间戳和来源上游。
不在目录中并不构成对服务的负面评价。这是一个精选列表,不是普查。
安装
uvx gold402-mcp # no install step
pip install gold402-mcp # then run: gold402-mcp从克隆安装:
python3 -m venv .venv && ./.venv/bin/pip install -e .
./.venv/bin/gold402-mcp客户端配置
Claude Desktop / Claude Code(claude_desktop_config.json 或 .mcp.json):
{
"mcpServers": {
"gold402": {
"command": "uvx",
"args": ["gold402-mcp"]
}
}
}更喜欢 pip?安装它,然后使用 "command": "gold402-mcp",不带参数。
数据源
https://24klabs.ai/directory.json — 公开、已发布、缓存 15 分钟。无需密钥、无需认证、无需抓取。如果获取失败且存在缓存副本,则提供缓存副本并披露其年龄,而不是隐藏。
覆盖率,如实说明。 该端点是刻意的预览:它包含完整的目录结构和真实的每分类数量,但仅包含最近收录的条目作为记录。24K Labs 不向匿名调用者批量提供完整数据集(原因)。因此,此服务器不会暗示它拥有它没有的东西:
每个响应都同时报告精选总数和实际搜索的条目数量;
没有预览记录的分类被报告为覆盖率限制,而不是空或不存在的分类;
对于预览之外的任何内容:浏览 https://24klabs.ai/directory,在
/api/v1/verify?resource=<url>查询单个资源,或使用gold402_check_endpoint,它适用于任何端点,无论是否已收录。
测试
./.venv/bin/python test_tools.py # tool-level, incl. error paths
./.venv/bin/python test_stdio.py # end-to-end over the real MCP protocol截至 2026-08-20,两者均通过,包括针对已安装的控制台脚本(干净的 venv,从构建的 wheel 进行 pip install)——而不仅仅是源文件。
Available Tools
5 toolsgold402_check_endpointARead-only
Live-probe ANY x402 endpoint — listed or not — before paying it. Sends one unpaid request and reports: whether it answered, the HTTP status, whether it returned a real 402 payment challenge, and the payment terms found (scheme, network, price, payTo, asset). Also checks the /.well-known/x402 manifest on the same origin. This is the same liveness-and-protocol check the gold-402 maintainers run at the door. It does NOT spend money and does NOT verify delivery — a valid 402 proves the door works, not that the service is good.
Inputs: params (required). Returns: result
gold402_get_entryARead-onlyIdempotent
Fetch a single gold-402 entry by name (exact match preferred, falls back to partial). Returns the full record including URL, description, shelf, the date it was first listed, and the permanent listing page.
Inputs: params (required). Returns: result
gold402_list_sectionsARead-onlyIdempotent
List the shelves (categories) of the gold-402 directory with an entry count for each. Use the returned section id as the 'section' filter in gold402_search.
Inputs: params (required). Returns: result
gold402_searchARead-onlyIdempotent
Search the gold-402 curated directory of x402 services, MCP servers, SDKs, facilitators and tools. Every entry was hand-probed by a maintainer and answered an x402 request correctly at the time of review. Filter by free text and/or shelf; supports pagination. Returns name, URL, description, shelf and the date first listed, with a provenance stamp.
Inputs: params (required). Returns: result
gold402_verdictARead-onlyIdempotent
PAID ($0.001 USDC on Base) — the 24K Labs editorial verdict for one x402 resource, plus aggregated independent rater grades, as JSON. This is the human judgement layer: a maintainer looked at this service and put a name behind it. Distinct from gold402_check_endpoint, which is FREE and only reports whether the door answered. Call once with no payment_signature to receive the exact payment terms; call again with the signature to settle. This server never holds a wallet — you pay 24K Labs directly from yours.
Inputs: params (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation: browsing shelves, searching entries, fetching one entry, live-probing an endpoint, and retrieving a paid verdict. The free technical probe and paid editorial verdict are explicitly differentiated, so there is no realistic confusion.
Most tools follow a consistent gold402_verb_noun pattern (gold402_list_sections, gold402_get_entry, gold402_check_endpoint, gold402_search). The one exception is gold402_verdict, which uses a noun instead of a verb, creating a minor but noticeable deviation.
Five tools is exactly right for this directory-style MCP server. Each tool earns its place: browse, search, detail, live verification, and paid human judgment. The scope is tight and no tool feels redundant.
The server covers the full user workflow: discover categories, search entries, retrieve full records, independently probe any endpoint, and optionally purchase an editorial verdict. The paid verdict flow with signature-based settlement is included, so there are no dead ends.
Maintenance
Related MCP Connectors
Meta-search MCP for x402 agent-payable services -- find paid APIs across every registry.
402xAgent is the check an agent calls before paying any x402 endpoint. It probes the endpoint's 402 without paying and returns a pay / skip / recheck verdict with a reason. Every check leaves a public receipt. It never pays the target.
Search 15K+ MCP services, A2A agents, and x402 APIs from 5 registries. Paid via x402 (USDC on Base).
Remote MCP utilities for agents: structured data, commerce checks, and x402 paid API discovery.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible agents to discover and call x402 paid services from a directory of over 2,000 APIs.Apache 2.0
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to search and verify machine-payable HTTP 402/x402 APIs using live probe data, providing ranked results by liveness, uptime, price, and trustworthiness.-

@vapi-network/mcpofficial
AlicenseNot gradedqualityBmaintenanceLets MCP clients discover x402 APIs, pay for calls from a local non-custodial wallet, and inspect balances and payment receipts.5,348Apache 2.0- AlicenseNot gradedqualityBmaintenanceExposes MCP tools that let an agent search a catalog, inspect a paid service's pricing, fetch it with payment handled automatically, and check its remaining budget and active spending limits. Payments are authorized against a signed mandate from the owner, so agents can buy API access over HTTP 402 without ever holding the owner's private key.250 npmMIT