gold402-mcp
gold402-mcp
Ein MCP-Server über gold-402 – das kuratierte x402-Verzeichnis, gepflegt von 24K Labs. Bietet jedem MCP-fähigen Agenten (Claude, Cursor oder alles, was MCP spricht) vier Werkzeuge zum Finden von x402-Diensten und zum Prüfen eines Endpunkts, bevor er Geld dafür ausgibt.
Status: v0.1 – getestet, verpackt, noch nicht veröffentlicht. Läuft über stdio.
Werkzeuge
Werkzeug | Was es tut |
| Durchsuche das Regal nach Freitext und/oder Regalname. Paginiert. Jede Antwort gibt an, wie viele Einträge tatsächlich durchsucht wurden. |
| Alle 13 Regale mit ihren tatsächlichen kuratierten Zählungen und wie viele davon hier durchsuchbar sind. |
| Ein Eintrag nach Name – URL, Beschreibung, Regal, Datum der ersten Auflistung, permanente Auflistungsseite. |
| Teste jeden x402-Endpunkt live, ob gelistet oder nicht. Eine unbezahlte Anfrage: Antwortet er, ist es eine echte 402, wie lauten die Zahlungsbedingungen, veröffentlicht der Ursprung ein Manifest – und ob er in unserem Regal steht. |
| Bezahlt, $0,001 USDC auf Base. Das redaktionelle Urteil von 24K Labs für eine Ressource plus aggregierte Noten unabhängiger Bewerter. Die Urteilsebene – ein Betreuer hat es sich angesehen und seinen Namen dahintergesetzt. |
Kostenlos vs. bezahlt
Vier der fünf Werkzeuge sind kostenlos und bleiben kostenlos – Suche, Regale, Eintragssuche und der Live-Test. Kein Schlüssel, keine Wallet, kein Konto.
gold402_verdict ist bezahlt: $0,001 USDC auf Base. Es ist das einzige, und es kauft das, was der kostenlose Test explizit nicht liefert – ein menschliches Urteil. Eine gültige 402 beweist, dass die Tür funktioniert; das Urteil ist ein Betreuer, der sagt, dass es das Geld eines Fremden wert war.
Dieser Server hält nie eine Wallet und bezahlt nie in Ihrem Namen. Rufen Sie gold402_verdict einmal ohne payment_signature auf, und er gibt die dekodierten x402-Bedingungen zurück – Preis, Netzwerk, Asset, payTo, Timeout. Signieren Sie sie mit Ihrer eigenen Wallet und rufen Sie erneut mit der Signatur auf. Das Geld fließt von Ihnen zu 24K Labs; dieser Prozess ist nicht im Pfad.
gold402_check_endpoint ist die Türprüfung, die die Betreuer durchführen, jetzt aufrufbar. Es funktioniert mit Endpunkten, die nicht im Verzeichnis sind, genau darum geht es: Ein Agent, der im Begriff ist, einem Fremden zu zahlen, kann zuerst fragen.
Related MCP server: x402 Atlas
Was die Antworten behaupten und was nicht
Eine Auflistung bedeutet, dass ein Betreuer es getestet hat und es zum Zeitpunkt der Überprüfung eine x402-Anfrage korrekt beantwortet hat, und wir testen regelmäßig erneut. Es ist keine Prüfung des Anbieters, keine Garantie für Verfügbarkeit und kein Versprechen, dass ein Aufruf erfolgreich sein wird. Eine gültige 402 beweist, dass die Tür funktioniert – nicht, dass der Dienst liefert. Jede Antwort trägt einen as_of-Stempel und die Quelle, von der sie stammt.
Das Fehlen im Verzeichnis ist kein Urteil gegen einen Dienst. Es ist eine kuratierte Liste, keine Volkszählung.
Installation
uvx gold402-mcp # no install step
pip install gold402-mcp # then run: gold402-mcpAus einem Klon:
python3 -m venv .venv && ./.venv/bin/pip install -e .
./.venv/bin/gold402-mcpClient-Konfiguration
Claude Desktop / Claude Code (claude_desktop_config.json oder .mcp.json):
{
"mcpServers": {
"gold402": {
"command": "uvx",
"args": ["gold402-mcp"]
}
}
}Pip bevorzugt? Installieren Sie es, dann verwenden Sie "command": "gold402-mcp" ohne Argumente.
Datenquelle
https://24klabs.ai/directory.json – öffentlich, veröffentlicht, 15 Minuten gecacht. Kein Schlüssel, keine Authentifizierung, kein Scraping. Wenn der Abruf fehlschlägt und eine zwischengespeicherte Kopie existiert, wird die zwischengespeicherte Kopie ausgeliefert und ihr Alter offengelegt, nicht versteckt.
Abdeckung, klar ausgedrückt. Dieser Endpunkt ist eine bewusste Vorschau: Er enthält die vollständige Regalstruktur und die tatsächlichen Zählungen pro Regal, aber nur die zuletzt gelisteten Einträge als Datensätze. 24K Labs liefert den vollständigen Satz nicht in großen Mengen an anonyme Aufrufer (warum). Dieser Server impliziert also keine Reichweite, die er nicht hat:
jede Antwort meldet sowohl die kuratierte Gesamtzahl als auch, wie viele Einträge tatsächlich durchsucht wurden;
ein Regal ohne Vorschau-Datensätze wird als Abdeckungsgrenze gemeldet, nie als leeres oder nicht vorhandenes Regal;
für alles außerhalb der Vorschau: durchsuchen Sie https://24klabs.ai/directory, schlagen Sie eine Ressource unter
/api/v1/verify?resource=<url>nach oder verwenden Siegold402_check_endpoint, das mit jedem Endpunkt funktioniert, ob gelistet oder nicht.
Tests
./.venv/bin/python test_tools.py # tool-level, incl. error paths
./.venv/bin/python test_stdio.py # end-to-end over the real MCP protocolBeide bestehen ab dem 20.08.2026, auch gegen das installierte Konsolenskript (saubere venv, pip install aus dem gebauten Wheel) – nicht nur die Quelldatei.
Kuratiert von 24K Labs · Verzeichnis: 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 gradedqualityCmaintenanceLets MCP clients discover x402 APIs, pay for calls from a local non-custodial wallet, and inspect balances and payment receipts.5,042Apache 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.382 npmMIT