gold402-mcp

Un servidor MCP sobre gold-402 — el directorio x402 curado mantenido por 24K Labs. Proporciona a cualquier agente compatible con MCP (Claude, Cursor, o cualquier cosa que hable MCP) cuatro herramientas para encontrar servicios x402 y para verificar un endpoint antes de gastar dinero en él.

Estado: v0.1 — probado, empaquetado, aún no publicado. Se ejecuta sobre stdio.

Herramientas

Gratis vs de pago

Cuatro de las cinco herramientas son gratuitas y seguirán siéndolo — búsqueda, estantes, consulta de entradas y verificación en vivo. Sin clave, sin cartera, sin cuenta.

gold402_verdict es de pago: 0,001 USDC en Base. Es la única que compra lo que la sonda gratuita no te da: un juicio humano. Un 402 válido demuestra que la puerta funciona; no que el servicio detrás valga la pena. gold402_verdict añade esa capa: un mantenedor lo ha revisado y pone su nombre detrás.

Este servidor no guarda carteras y nunca paga en tu nombre. Llama a gold402_verdict una vez sin payment_signature para obtener los términos x402 decodificados (precio, red, destino). Luego firma tú mismo la transacción y pásale la firma; el servidor solo la transmite.

gold402_check_endpoint es la comprobación de puerta que usan los mantenedores, ahora invocable. Funciona sobre endpoints que no están en el directorio: un agente que está a punto de pagar a un desconocido puede preguntar primero. No se envía dinero.

Related MCP server: Secant Agent Research

Lo que significa el listado — y lo que no

Un listado significa que un mantenedor lo probó y respondió correctamente a una solicitud x402 en el momento de la revisión, y lo re‑probamos periódicamente. No es una auditoría del servicio, ni una garantía de que funcionará, ni un respaldo. Una solicitud 402 válida demuestra que la puerta existe y pide pago; no demuestra que el servicio que hay detrás sea bueno, esté disponible o siga ahí mañana.

Por eso gold402_verdict es de pago y es la única herramienta con juicio: un humano miró el recurso y puso su nombre detrás.

Herramientas

Gratis vs de pago

Cuatro de las cinco herramientas son gratuitas y seguirán siéndolo: búsqueda, estanterías, consulta de entradas y comprobación de endpoints. Sin clave, sin cartera, sin cuenta.

gold402_verdict es de pago: $0,001 USDC en Base. Es la única, y compra lo que la comprobación gratuita no da: un veredicto humano editorial sobre si un recurso merece la pena.

uvx gold402-mcp            # no install step
pip install gold402-mcp    # then run: gold402-mcp

Instalación

python3 -m venv .venv && ./.venv/bin/pip install -e .
./.venv/bin/gold402-mcp

Uso

{
  "mcpServers": {
    "gold402": {
      "command": "uvx",
      "args": ["gold402-mcp"]
    }
  }
}

Fuente de datos

https://24klabs.ai/directory.json — público, publicado, sin clave, sin scraping. Si la descarga falla y existe una copia en caché, el servidor informa de la antigüedad de la caché y aun así la sirve.

Cobertura, claramente: el servidor solo ve lo que ese JSON público expone. No adivina y nunca inventa campos. Si un campo falta en la fuente, la respuesta de la herramienta lo dice. Eso es una característica, no un error.

./.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