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 편집 평결과 집계된 독립 평가자 등급. 판단 레이어 — 유지 관리자가 살펴보고 이름을 붙였습니다. |
무료 vs 유료
다섯 가지 도구 중 네 가지는 무료이며 계속 무료입니다 — 검색, 선반, 항목 조회, 실시간 프로브. 키, 지갑, 계정이 필요 없습니다.
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, 빌드된 휠에서 pip install)에 대해서도 통과합니다 — 소스 파일뿐만 아니라.
24K Labs가 선별 · 디렉터리: https://github.com/Haustorium12/gold-402
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