Agent402
Servidor MCP autoalojable de código abierto con aproximadamente 1,100 herramientas deterministas (búsqueda web, Chromium sin interfaz gráfica, PDFs, OCR, imágenes, ~1,040 utilidades de CPU). Gratuito para autoalojar o pago por llamada mediante x402 (USDC en Base).
Documentación
Agent402: más de 500 herramientas, modelos medidos e informes terminados para agentes de IA
Disponible en agent402.tools.
La puerta de pago para agentes de IA: más de 500 herramientas, modelos medidos e informes terminados, pagados por llamada en USDC mediante x402 y MPP, o con tarjeta. Código abierto, autoalojable, nativo de MCP.
Operado por Havok Holdings LLC · En vivo · Por qué pagar aquí · Recibos · Estado · Seguridad · Empresa
Pruébalo en 30 segundos: claude mcp add agent402 -- npx -y agent402-mcp, o pega https://agent402.tools/mcp en cualquier cliente MCP. El nivel gratuito no necesita billetera. Guías de configuración verificadas para Cursor, VS Code, Windsurf, Cline, Roo Code, Codex CLI, Gemini CLI, Continue, ElizaOS y AgentCore: agent402.tools/guides/agent-hosts (enlaces cortos agent402.sh/<host>, p. ej. agent402.sh/cursor).
Quién paga: los agentes pagan por llamada (desde $0.001; los modelos se miden bajo un tope cotizado y se liquidan según el uso real); las personas compran informes terminados ($2 a $5) y monitores ($5 al mes) con tarjeta; los sitios cobran a los rastreadores con el peaje.
Qué es Agent402
Finanzas agénticas son agentes de software que pagan y cobran por su cuenta: descubren un servicio, pagan por solicitud desde una billetera mediante protocolos abiertos (x402, MPP), reciben un recibo verificable y ganan por solicitud a cambio. Agent402 es su capa aplicada — explicación: agent402.tools/agentic-finance · glosario.
Qué lo hace diferente: Agent402 es de código abierto y autoalojable — y una sola integración le da al comprador tres primitivas gratuitas en todo el ecosistema x402:
- Encontrar —
/api/find?q={task}resuelve una descripción de tarea a las herramientas que mejor coinciden (ruta, precio, esquema, ejemplo listo).- Enrutar —
POST /api/routees el Enrutador Inteligente de Órdenes neutral: clasifica herramientas entre todos los vendedores x402 rastreados (autodescubiertos desde Coinbase CDP Bazaar), consciente de la salud, coninclude=externalpara excluirnos. La respuesta devuelve las N mejores y llevamatchedpara cuántas se puntuaron.- Tabla de clasificación —
GET /api/leaderboardes el ranking público en cadena de vendedores x402 por volumen liquidado en USDC en Base — llamadas atendidas, totalUsd, compradores únicos por vendedor. Devuelve las N mejores, nunca toda la tabla (25 por defecto, 50 como tope;totalSellerslleva el recuento completo). Pipeline: Bazaar →eth_getLogs→ tope por llamada → agregar porpayTo. Instantánea por hora.Además, el catálogo — más de 500: búsqueda/respuesta como puerta de entrada MCP, luego más de 500 herramientas y paquetes de habilidades seleccionados (flujos de trabajo multitool invocables como prompts MCP) — todo ejecutable por ti mismo, además de
agent402-tollbooth— una puerta abierta de pago por rastreo para el otro lado de x402.Dos puertas, dos listas de precios. Los agentes pagan por llamada en USDC (x402 / MPP) o gratis mediante prueba de trabajo, y un informe terminado cuesta $0.60 a $2.00 de esa manera. Las personas pagan con tarjeta: los mismos informes en agent402.tools/reports (expediente de empresa, informe de fondo 13F, flujo de información privilegiada, resumen de mercado, investigación profunda, retiro de FDA, auditoría de dominio) cuestan $2 a $5, los monitores que se reejecutan ante cambios en /monitors cuestan $5 al mes, y los créditos prepagados en /credits son una clave
a402_que paga cada herramienta con tarjeta (Authorization: Bearer a402_…, debitada por llamada exitosa; compatible conagent402-mcpmedianteAGENT402_CREDITS_KEYyagent402-clientmediante{ creditsKey }). El precio con tarjeta incluye el procesamiento de pagos. Un agente que paga por llamada paga el precio de herramienta más bajo por el mismo informe.Dos canales de pago, una URL. Cada endpoint de pago acepta x402 (
PAYMENT-SIGNATURE, USDC en 12 cadenas) y MPP (Protocolo de Pagos Automatizados, el esquema de autenticación HTTP de seguimiento IETFPaymentcoescrito por Tempo y Stripe): el mismo 402 lleva ambos, un clientemppxpaga sin configuración adicional, y MPP liquida en Base y Celo (USDC), de forma nativa en Tempo (USDC.e o PathUSD mediante el relé de Tempo), o con tarjeta mediante MPP (Stripestripe/charge, ofrecido en rutas con precio de $0.50 o más cuando el operador lo configura). El mercado MPP lista cada vendedor MPP que podemos verificar en vivo. Detalles: Qué es MPP · liquidaciones MPP en vivo.
Adaptadores de frameworks (herramientas plug-and-play para las principales pilas de agentes — pago automático debajo):
Más de 500 — búsqueda web en vivo y respuestas citadas como puerta de entrada MCP, luego herramientas web listas para usar y paquetes de habilidades multitool para tu agente de IA, desde un solo servidor. Cada una probada, con precio y liquidada en cadena; cada una se gana su lugar. Renderizado de
navegador, búsqueda web, PDFs, imágenes, OCR, datos financieros/cripto/macro en vivo, SEC EDGAR, estadísticas deterministas, pronósticos y precios de opciones/bonos (Black-Scholes, YTM), compresión y más de 150 utilidades puras de CPU. Ejecútalo tú mismo gratis en 30 segundos (MCP o
HTTP simple, sin claves API, sin registro — el nivel gratuito y los pagos x402/MPP nunca
necesitan una clave; solo los créditos opcionales con tarjeta prepagada usan una clave portadora), conéctalo
a Claude/ChatGPT/cualquier cliente MCP y agrega tus propias herramientas en pocas líneas.
Cada herramienta de utilidad es determinista — sin LLM en la ruta de servicio — y
se vuelve a probar contra su propio ejemplo antes de cada lanzamiento. Las superficies
respaldadas por modelos son explícitas y tienen precio como tales: la puerta de enlace /v1 (medida bajo un
tope cotizado, o niveles fijos) y los productos de informes terminados (/v1/research, /v1/dossier, ... abajo).
Opcionalmente, el mismo servidor puede cobrar por llamada mediante el protocolo x402 (USDC en Base, Solana, Polygon, Arbitrum, Monad, Celo, Avalanche, Sei, Optimism, Stellar y Algorand, además de USDG en Robinhood Chain — 12 cadenas) — así que la instancia que autoalojas gratis también puede ser una alojada y monetizada. Esa parte es opcional; por defecto todo se ejecuta gratis.
🟢 Demo alojada: agent402.tools · 📖 Wiki · 📦 npm · 🔌 Registro MCP · 🧩 Smithery
Ejecútalo tú mismo en 30 segundos
Elige lo que mejor se adapte. Todo es gratis y no necesita billetera:
1. Sin instalación — agrega el conector alojado a Claude (claude.ai → Configuración → Conectores → Agregar conector personalizado):
https://agent402.tools/mcp
2. Un comando — ejecuta el servidor MCP localmente (las herramientas puras de CPU funcionan sin clave; paga la pequeña prueba de trabajo por ti):
npx -y agent402-mcp
# in Claude Code: claude mcp add agent402 -- npx -y agent402-mcp
3. Clona y aloja todo (las más de 500 herramientas como API HTTP + MCP, modo gratuito, sin pagos):
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. Implementación con un clic en Railway (instancia autoalojada completa — agrega complementos opcionales de Postgres + Redis para análisis + caché de respuestas):
Arranca directamente desde el railway.toml + Dockerfile del repositorio. Los complementos opcionales se detectan automáticamente mediante env: agrega Redis → REDIS_URL habilita el caché de respuestas ascendente (X-Cache: hit|miss), agrega Postgres → DATABASE_URL habilita el panel público /api/analytics y la lista de espera del peaje. No se requieren variables de entorno para arrancar en modo gratuito.
Paga por llamada desde una billetera
Cada ruta de pago responde 402 con una oferta x402 y desafíos MPP, para que cualquier cliente lo pague. Sin clave API, sin registro: la billetera es la cuenta.
MPP (USDC.e o PathUSD en Tempo, listado primero en el 402, o USDC en Base o Celo) con 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 (USDC en Base y otras cadenas) con @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");
Más: Pagar con MPP · Pagar con x402.
Qué hay en el catálogo (más de 500 herramientas)
Cada herramienta se gana su lugar: determinista, probada contra su propio ejemplo en cada ejecución de CI, con precio de mercado, liquidada en cadena. CI mantiene un mínimo de catálogo de 400 entradas y verifica la afirmación de "más de 500" contra el catálogo en ejecución (
scripts/sync-count.js --check). El catálogo crece solo cuando una herramienta vale la pena llamarla.
| Ejemplos | |
|---|---|
| Navegador y web | render (Chromium sin interfaz, ejecuta JS), screenshot, extract (artículo→markdown), meta |
| Búsqueda en vivo y respuestas | search (índice web real), search-lite (una muestra rápida de 5 resultados), answer (respuesta web con citas), search-news/search-images/search-videos variantes, search-suggest, multi-search |
| PDFs y medios | pdf-to-markdown, pdf-merge, pdf-extract-pages, pdf-rotate, images-to-pdf, audio-convert, audio-normalize (EBU R128, ffmpeg real) |
| Imágenes | image-resize, image-convert, image-thumbnail, barcode-decode (jimp/zxing, solo CPU) |
| OCR | image-ocr (texto de cualquier imagen - solo CPU, sin modelo) |
| Geo | geo-distance (haversine, solo CPU), geocode, reverse-geocode, place-search, geo-lookup |
| Datos en vivo | fx-rate (BCE), barcode-lookup (Open Food Facts), gov-data (data.gov), weather-forecast/weather-alerts, earthquakes (USGS) |
| Finanzas y cripto | stock-quote/stock-history (Databento, consolidación de cuatro mercados), crypto-price/crypto-market/crypto-history/crypto-trending/crypto-global (CoinGecko) |
| Derivados cripto y opciones | perp-markets, perp-funding, perp-funding-screener, perp-basis, perp-open-interest, perp-klines, perp-orderbook (perpetuos en vivo: precio mark/oráculo, funding, OI, velas, profundidad); options-summary, crypto-options-chain, options-ticker, options-volume (libro de opciones, IV y griegas, volumen de opciones onchain) - $0.001 a $0.005 por llamada, sin cuenta de exchange |
| DeFi y stablecoins | defi-yields (filtrar pools por cadena, proyecto, TVL y solo stablecoin), defi-yield-history, defi-protocols, defi-protocol, defi-chains, defi-chain-tvl-history, defi-fees, defi-dex-volume, stablecoins, stablecoin-supply-history - $0.001 a $0.003 por llamada |
| Inteligencia de tokens Solana | sol-token-safety (autoridades, liquidez, concentración de holders, calificado), sol-token-report (informe de riesgo completo), sol-token-holders, sol-token-pairs, sol-token-search, sol-trending, sol-price, sol-swap-quote, sol-token-lookup - la verificación de diligencia debida que un agente necesita antes de tocar un mint |
| Cobertura de mercado cripto | crypto-news, crypto-indicators (RSI, MACD, medias móviles, calculados aquí), crypto-market-pulse, coin-profile, coin-history, coin-ohlc, coin-market-chart-range, coin-categories, coin-price-by-contract (precio por DIRECCIÓN de token, sin necesidad de coin id), global-defi, exchanges, exchange-tickers, exchange-rates, coin-search, coins-list - más activos del mundo real tokenizados desde la misma clave de CoinGecko: rwa-list, rwa-markets, rwa-asset, rwa-issuers, rwa-issuer (acciones, ETFs y materias primas tokenizadas con datos de mercado onchain y los emisores detrás de ellos) |
| Datos de cadena indexados | asset-transfers (historial de transferencias filtrado), token-balances, token-allowance, tx-receipt (transferencias decodificadas), block-receipts, token-price-history - lecturas indexadas en las principales cadenas EVM, sin nodo y sin clave propia |
| Social 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 - búsqueda, feeds y métricas de engagement en el grafo social onchain |
| Rastreo de sitios | site-map (enumerar las URLs de un sitio) y site-crawl (rastreo en amplitud hasta markdown limpio, respetando robots, con presupuestos duros de página/profundidad/tiempo) - el par determinista detrás de cualquier tarea de "leer todo este sitio" |
| Macro (FRED y más) | curva de rendimiento, tesoro, fiscal, fondos federales, IPC, desempleo, regla de Sahm, FX del BCE, Banco Mundial, observaciones de publicaciones masivas de FRED |
| SEC EDGAR | ticker→CIK, lista de presentaciones, texto de 10-K/10-Q, marcos XBRL, transacciones de insiders, tenencias 13F, calendario de IPO, búsqueda de texto completo |
| Informes finalizados (citados) | research/research-pro/research-max (investigación profunda fundamentada), market-brief, dossier/dossier-max (diligencia debida de empresas), fund-report/fund-report-max (cartera 13F), domain-audit/domain-audit-pro (seguridad calificada + entregabilidad), recall-report (FDA), insider-report (flujo de Form 4), token-risk/token-risk-pro (riesgo de contrato on-chain), filing-report (última presentación SEC), token-brief (diligencia debida de mint Solana), ticker-pack (expediente + flujo de insiders + holders), ipo-report (resumen de S-1 + 424B4, determinista) - $0.05 a $2.00 por informe vía x402 / MPP, o $2 a $5 con tarjeta en /reports; consulta la tabla /v1 a continuación |
| Verdad de red | dns, dns-lookup, tls-cert, whois, http-check, robots-check, email-validate, ip-info |
| Cripto y pagos | usdc-balance, tx-status, gas-estimate, ens-resolve, x402-quote, x402-verify, transfer-authorization - no custodial, multicadena (Base/Polygon/Arbitrum/Optimism/Ethereum) |
| Memoria de agente | KV con clave de wallet + TTL, contadores atómicos, permisos entre wallets, registro de auditoría encadenado por hash, recuperación por similitud |
| Estadísticas y pronósticos | stats-summary, correlation, linear-regression, moving-average, outliers; forecast-naive, forecast-ses, forecast-holt, forecast-holt-winters + forecast-eval (backtest MAPE/RMSE) |
| Matemáticas financieras | black-scholes (valoración de opciones + griegas), bond-price/bond-ytm, cagr, sharpe-ratio, annuity, npv/irr, compound-interest, loan-payment/amortization, break-even, effective-annual-rate (solo CPU, determinista) |
| Compresión | gzip/gunzip, brotli-compress/brotli-decompress, compress-compare (comparativa de algoritmos, solo CPU vía node:zlib) |
| Extracción HTML | html-select (consulta CSS), html-table, html-strip, html-links, html-meta - contraparte determinista de extract |
| Operaciones de red | dns-lookup, dns-propagation, spf-check/dmarc-check/dkim-lookup, email-deliverability; cert-transparency, http-headers (auditoría de seguridad), tech-stack, asn-info (geo IP) |
| Lecturas de cadena | block-number, chain-info, block-info, contract-code, erc721-owner, event-logs - lecturas JSON-RPC sin clave con conmutación por error multi-endpoint en Ethereum/Base/Polygon/Arbitrum/Optimism, desde $0.001 |
| Política SQL | sql-guard ($0.004 - veredicto pasar/advertir/bloquear con riesgos nombrados en una declaración SQL, más un certificado de ejecución Ed25519 cuando se configura una clave de firma), sql-cert-verify ($0.001 - verifica ese certificado contra la declaración exacta) |
| Inteligencia de vendedor x402 | Tres niveles sobre la misma pregunta, del más barato al más caro. seller-trust (GET /api/x402/seller-trust, $0.005) - el campo de puerta del router campo por campo: indexado, análisis de manifiesto, cadenas anunciadas, llamadas liquidadas observadas, ¿gastaríamos dinero de comprador allí?. seller-dossier (POST /api/seller-dossier, $0.05) - el registro ensamblado: cada precio con su procedencia, wallets anunciadas contra las wallets realmente pagadas, evidencia de liquidación por fuente, el veredicto de despacho por cadena con su razón, y qué pasó cuando nuestro router le pagó. seller-payability (POST /api/seller-payability, $0.10) - compra una llamada real ahora mismo e informa cada tramo, incluido si el dominio EIP-712 del accept coincide con el token que nombra. Los dos primeros son lecturas offline de lo que ya sabemos; el tercero gasta USDC para averiguarlo |
| Más de 150 utilidades solo CPU | hashing, JWT, base58, JSON⇄CSV/YAML, token-count, text-chunk, json-validate, estadísticas de texto, matemática cron, validadores, conversiones de unidades en 13 categorías (una herramienta paramétrica) |
Los esquemas completos viven en /openapi.json; un
catálogo legible por máquina está en /api/pricing
y /llms.txt. ¿No sabes qué herramienta necesitas?
/api/find?q=<task> resuelve
una descripción de tarea a la herramienta correcta - ruta, precio, esquema y un ejemplo listo -
para que un agente se salte el paso de "buscar alrededor para encontrar una herramienta" que consume muchos tokens.
Puerta de enlace LLM (/v1) - chat, embeddings, rerank, imágenes, voz e informes finalizados, pago por llamada
Apunta cualquier SDK de OpenAI a base_url = https://agent402.tools/v1 y paga por llamada en
USDC vía x402 o MPP - sin clave API, sin registro, sin cuenta (o paga con tarjeta con una
clave de créditos prepagados, consulta Para humanos):
| Endpoint | Precio | Sirve |
|---|---|---|
POST /v1/nano/chat/completions | $0.003 | modelos nano - con precio para bucles de agente de alta frecuencia |
POST /v1/auto/chat/completions | $0.01 | sin necesidad de modelo - enrutamiento determinista evaluado por ranking (código / razonamiento / largo / general), quality: fast | balanced | best opcional al mismo precio, decisión divulgada vía agent402_router |
POST /v1/chat/completions | $0.02 | modelos económicos/medios (gpt-4o-mini, claude haiku, gemini flash, deepseek, llama…) |
POST /v1/pro/chat/completions | $0.10 | medio-frontera (gpt-4o, gpt-4.1, gpt-6 sol, claude sonnet, gemini pro, grok) |
POST /v1/premium/chat/completions | $0.50 | frontera (gpt-5 y gpt-6 astra, o3 y o4-mini, claude opus y claude fable 5.1) |
POST /v1/grounded/chat/completions | $0.03 | el router automático más una búsqueda web en vivo en cada llamada - las respuestas llevan anotaciones url_citation del wire de OpenAI; nunca se almacenan en caché |
POST /v1/{nano,auto,pro,premium}/messages, POST /v1/messages | precio de nivel | el wire de Messages de Anthropic en cada nivel (misma lista de permitidos, límites y conmutación por error que la ruta de chat); effort (bajo a máximo) es el control de profundidad en Claude 4.7+, Claude más antiguo toma thinking.budget_tokens |
POST /v1/{nano,auto,pro,premium}/responses, POST /v1/responses | precio de nivel | el wire de Responses de OpenAI en cada nivel (solo herramientas de función, sin estado de servidor) |
POST /v1/embeddings | $0.002 | embeddings de OpenAI, lote de hasta 64 entradas - repeticiones idénticas son gratis (salida determinista, caché activado por defecto) |
POST /v1/rerank | $0.002 | rerank compatible con Cohere ({query, documents[], top_n}), hasta 50 documentos, caché activado por defecto |
POST /v1/images/generations | $0.08 | generación de imágenes (FLUX.2 Pro, PNG 1024x1024) - wire de imágenes de OpenAI, salida base64 en línea |
POST /v1/images/fast | $0.02 | texto a imagen económico, mismo wire de imágenes de OpenAI, unos dos segundos por imagen |
POST /v1/images/pro | $0.05 | texto a imagen de mayor fidelidad, una imagen por llamada |
POST /v1/videos/generations | $0.20 | texto a video: un clip silencioso de 4 segundos en 720p, MP4 base64 en línea, 16:9 o 9:16 |
POST /v1/audio/speech | $0.06 | texto a voz, wire audio.speech.create() de OpenAI - hasta 2,000 caracteres de entrada, mp3 crudo (predeterminado) o bytes pcm de salida, cadena de conmutación por error de cinco modelos |
Streaming (stream: true), paso completo de herramientas/llamadas a funciones, un
caché de prompt opcional en los niveles de chat (cache: true → repeticiones byte-idénticas gratis durante
10 minutos), cadenas de conmutación por error ascendentes que terminan en un modelo probado con canario, y un
GET /v1/models gratuito que lista cada modelo con
su nivel y límites. Un canario con dinero real compra desde cada una de estas superficies
a diario - streaming, divulgación de enrutamiento y ambos comportamientos de caché incluidos.
Productos de informes finalizados viven en el mismo prefijo /v1: una llamada pagada devuelve
un informe completo y citado (JSON, con un apéndice de fuentes) en lugar de un turno de modelo
crudo. Cada informe se fundamenta en datos primarios que el servidor obtiene por sí mismo (presentaciones
EDGAR, openFDA, sondeos DNS/TLS, lecturas on-chain, una búsqueda web en vivo) antes de
la síntesis; ipo-report es completamente determinista (sin modelo en absoluto):
| Endpoint | Precio | Informe |
|---|---|---|
POST /v1/research · /v1/research/pro · /v1/research/max | $0.60 · $0.85 · $1.10 | informe de investigación profunda ({query}) - búsqueda múltiple fundamentada, reordenamiento, síntesis citada |
POST /v1/research/market-brief | $0.85 | informe breve de mercado / competencia ({query}) |
POST /v1/dossier · /v1/dossier/max | $0.85 · $1.10 | expediente de diligencia debida de empresa ({ticker}) - presentaciones, flujo de información privilegiada, web |
POST /v1/fund · /v1/fund/max | $0.60 · $0.85 | informe de cartera de fondos desde el último 13F ({manager}) - compras/ventas del último trimestre |
POST /v1/domain-audit · /v1/domain-audit/pro | $0.60 · $0.85 | auditoría de seguridad de dominio y entregabilidad con calificación ({domain}) |
POST /v1/recall-report | $0.60 | informe de retiros de la FDA, medicamentos/alimentos/dispositivos ({query}) |
POST /v1/insider-report | $0.60 | informe de flujo de información privilegiada desde presentaciones Form 4 analizadas ({ticker}) |
POST /v1/filing-report | $0.85 | lectura y resumen de la última presentación SEC con los datos que movieron el mercado ({ticker}) |
POST /v1/token-brief | $0.60 | informe breve de diligencia debida de tokens Solana a partir de evidencia en cadena y de mercado ({mint}) |
POST /v1/ticker-pack | $2.00 | un ticker, tres informes: expediente, flujo de información privilegiada y tenedores 13F |
POST /v1/token-risk · /v1/token-risk/pro | $0.60 · $0.85 | informe de riesgo de token y contrato a partir de evidencia en cadena ({address, chain}) |
POST /v1/ipo-report | $0.05 | resumen de pipeline de OPI, S-1 + 424B4 desde búsqueda de texto completo en EDGAR ({days, keyword}), determinista |
Los informes son solo para carteras (x402 / MPP / créditos prepagados, nunca prueba de trabajo) y tardan unos minutos en generarse. Los mismos informes se venden a personas con tarjeta en agent402.tools/reports por $2 a $5 según la profundidad. El precio con tarjeta incluye el procesamiento del pago; un agente que paga por llamada a través de x402 o MPP paga el precio de herramienta más bajo por el mismo informe.
Dos herramientas complementarias cierran el ciclo: POST /api/route/execute ($0.01, con
niveles de execute-plus $0.05 y execute-max $0.55 para herramientas más caras) resuelve una descripción de tarea a la
mejor herramienta y la ejecuta en una sola llamada pagada, incluyendo, con include:"external",
herramientas vendidas por otros vendedores x402 (enruta según volumen liquidado probado en cadena,
con una excepción: un vendedor de Solana sin historial aún solo se prueba
después de cada candidato probado, bajo un pequeño límite por llamada, y se marca
como no probado en el recibo - les paga en tu nombre en la cadena en la que pagaste -
Base o Algorand - y transmite el resultado; consulta la
guía de Smart Order Router), y
POST /api/my-usage ($0.005) devuelve el historial de compras de la cartera que paga -
sin parámetro de cartera; el pago x402 es la identidad, así que nadie puede
leer el perfil de otra cartera.
Para humanos: informes, monitores y créditos prepagados
El mismo catálogo tiene una puerta de entrada con pago con tarjeta (Stripe Checkout; el operador
la habilita con STRIPE_SECRET_KEY, de lo contrario estas páginas simplemente no se montan):
| Página | Qué obtienes |
|---|---|
| agent402.tools/reports | Compra cualquier informe terminado de la tabla anterior con tarjeta (POST /api/buy) por $2 a $5 (los niveles más profundos y el paquete de tickers están en el extremo superior de ese rango; precios actuales en la página), entregado en /r/<session> - sin cartera, sin cuenta. El precio con tarjeta incluye el procesamiento del pago; un agente que paga por llamada paga el precio de herramienta más bajo por el mismo informe. Un informe se genera solo contra una sesión pagada verificada por Stripe, una vez; una generación fallida se reembolsa automáticamente. |
| agent402.tools/monitors | Suscripciones de $5/mes que re-ejecutan un informe cuando algo cambia y te envían un correo: monitor de seguridad de dominio (re-sondeo diario gratuito, re-ejecución completa pagada ante un cambio de seguridad, un certificado dentro de 14 días de expiración, o cada 30 días), vigilancia de presentaciones SEC (nueva presentación), vigilancia de seguridad de tokens Solana (hechos de seguridad cambiados), vigilancia de 13F de fondos (nueva presentación), vigilancia de retiros FDA (nuevo número de retiro), vigilancia de flujo de información privilegiada (nuevo Form 4), vigilancia de pipeline de OPI (resumen semanal). Los informes llegan a /m/<id>; gestiona o cancela a través del Portal de Clientes de Stripe en /monitors/manage. |
| agent402.tools/credits | Créditos prepagados en paquetes de $20 / $50 / $100. Obtienes una clave a402_… (mostrada una vez en la página de agradecimiento y enviada por correo); envíala como Authorization: Bearer a402_… en cualquier ruta con precio y la llamada se paga desde el saldo - se debita solo en una respuesta exitosa, micro-dólares enteros para que los precios de sub-centavo sean exactos, nunca expira. GET /api/credits/balance (mismo encabezado) lee el saldo; un 402 con {reason, balanceUsd, topup} significa insuficiente. Las herramientas vinculadas a identidad (/api/memory*, my-usage) rechazan créditos porque el pago es la identidad allí; paga esas a través de un riel x402. |
La clave de créditos es entendida por los SDKs: agent402-mcp lee
AGENT402_CREDITS_KEY y agent402-client toma { creditsKey }, así que un agente
sin cartera aún puede llamar a cada herramienta solo para carteras con tarjeta.
Paquetes de habilidades - más de 70 flujos de trabajo multi-herramienta
Para trabajos que abarcan varias herramientas - "auditar un dominio", "diagnosticar entregabilidad",
"elaborar una serie temporal", "desenvolver un blob opaco" - Agent402 incluye
paquetes de habilidades curados: secuencias ordenadas y tipadas de llamadas a herramientas con una
plantilla de prompt lista para Claude. Se pueden llamar como prompts MCP (prompts/list → prompts/get { name, arguments })
o HTTP simple en GET /api/skill-packs/{slug}/prompt (cada slug está listado en el
índice JSON gratuito en /api/skill-packs.json).
Una consulta con forma de tarea a catalog.search (la herramienta de búsqueda del conector alojado; el nombre más antiguo search_tools aún funciona como alias) devuelve el paquete coincidente junto con herramientas individuales.
| Paquete destacado | Cadenas | Úsalo para |
|---|---|---|
security-audit | cert-transparency · dns-lookup · spf-check · dmarc-check · http-headers · tls-cert · tech-stack | Postura de seguridad de dominio |
trend-analysis | stock-history · fred-series · stats-summary · moving-average · linear-regression · outliers · correlation · forecast-eval | Análisis cuantitativo de cualquier serie temporal |
structured-scrape | extract · render · html-select · html-table · html-strip · html-links · html-meta | Árbol de decisión de scraping determinista |
decode-blob | jwt-decode · gunzip · brotli-decompress · base64 · hex · json-format · hash | Identificar y desenvolver cualquier cadena opaca |
forecasting-bake-off | stock-history · fred-series · forecast-eval · forecast-naive · forecast-ses · forecast-holt · forecast-holt-winters | Clasificar 4 pronosticadores por RMSE, elegir el ganador |
document-intel | pdf-info · pdf-to-markdown · pdf-extract-pages · image-ocr · barcode-decode · pdf-merge · images-to-pdf | Pipeline de PDF/OCR/código de barras |
status-snapshot | dns-lookup · http-check · http-headers · tls-cert · robots-check | Barrido de salud de servicio de una sola pasada |
Todos los 100+ paquetes en /skills · índice JSON en /api/skill-packs.json ·
en MCP los paquetes aparecen bajo prompts/list para que cualquier cliente compatible con MCP los recoja automáticamente.
Índice x402 - Encontrar · Enrutar · Clasificación
Agent402 es también la capa abierta de enrutamiento y clasificación para todo el
ecosistema x402: rastrea vendedores x402 públicos (el catálogo local + un
conjunto auto-descubierto del Coinbase CDP Bazaar,
actualizado cada hora) y los expone a través de tres superficies gratuitas - misma lógica que
/api/find: las primitivas de descubrimiento no deberían costar dinero.
| Superficie | Qué es |
|---|---|
GET /api/find?q={task} | Resolver una tarea a las herramientas que mejor coinciden (ruta, precio, esquema, ejemplo listo) |
POST /api/route | Smart Order Router: { query, top, include } → herramientas clasificadas entre vendedores (puntaje de coincidencia, luego salud, luego precio; un modelo de juicio luego mueve la lista que realmente hace la tarea al tope, la más barata entre las igualmente buenas, reportado en judged). include=external excluye a Agent402 mismo |
GET /api/leaderboard | Clasificación en cadena de vendedores x402 por volumen liquidado en USDC en Base (callsSettled, totalUsd, uniqueBuyers por vendedor). Solo Top N - 25 por defecto, tope de 50, totalSellers para el conteo completo. Pipeline: Bazaar → eth_getLogs → tope por llamada → agregado. Instantánea por hora |
/marketplace | Panel HTML público: cada vendedor, conteo de herramientas, red, última obtención, salud móvil |
GET /api/index | El índice de vendedores como JSON (totales, salud por vendedor/banderas enrutables). Paginado - una página de máximo 250, complete: false y un encabezado Link con rel="next" mientras queden más, sellerCount para el total. Un origen, sin paginar y con su historial de rastreo: ?seller=<host> |
/stellar · /algorand | Páginas de mercado por cadena: vendedores y herramientas que liquidan en ese riel específicamente |
# "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'
El despacho está etiquetado, nunca implícito: cada fila de /api/route y vendedor de /api/index
lleva routerDispatchEligible y routerDispatchReason (crawl_failed,
network_unknown, settlement_required, settlement_checked_at_pay_time,
eligible, ...); executeVia aparece solo en una fila que el enrutador pagará ahora
mismo (executeViaCallableNow: true), de lo contrario el nivel se mueve a
executeViaWhenEligible. routable es preparación de rastreo, nunca una promesa de pago.
Una ruta con precio de manifiesto también se lee en vivo una vez y luego semanalmente, para que las cadenas
que su 402 realmente ofrece lleguen a la fila incluso cuando el manifiesto del vendedor se retrasa.
Consciente de salud: los vendedores cuyos últimos rastreos fallaron se excluyen del enrutador (un comprador enrutado a un vendedor muerto pierde dinero). Los vendedores más saludables también desempatan con igual puntaje de coincidencia y precio, así que los vendedores inestables pero baratos pierden ante los confiables. Los vendedores completamente nuevos (sin historial aún) reciben el beneficio de la duda.
Ajuste juzgado: el puntaje léxico recompensa una lista cuyo nombre repite las palabras de la tarea, así que veinte rutas estrechas de un vendedor podrían superar a una herramienta general que hace el trabajo. Un modelo de juicio ahora lee una lista corta - como máximo dos filas por vendedor, más las mejores coincidencias del catálogo local - y mueve la lista que realmente hace la tarea al tope; cuando varias lo hacen igual de bien, la más barata gana. Nunca agrega un vendedor que la puerta de liquidación no admitió, puede decir "ninguno de estos" (route-execute entonces se niega antes de que se pague algo), y falla abierto al orden léxico. Las herramientas mismas aún no ejecutan ningún modelo; esto es solo cómo el enrutador elige.
Los operadores obtienen atribución de 3 rieles en el panel (/api/stats,
/__operator, con token - responde 404 sin el token de operador): tráfico USDC vs. prueba de trabajo vs.
sondeo de latido se cuentan por separado - y el riel de latido está restringido
a un token firmado con POW_SECRET (no un User-Agent falsificable), así que la vista
del operador refleja demanda externa real.
Para vendedores de API: /sell es la puerta de entrada -
lista una API existente que hable x402 en el índice gratis con
POST /api/index/register (enrutado por salud, 0%
comisión, autoservicio, sin registro), o instala agent402-tollbooth para
poner una puerta de pago por rastreo frente a un sitio que aún no es nativo de x402.
Desde código, el paquete npm agent402-client envuelve todo esto -
find() una herramienta, luego call() la, pagando automáticamente (una prueba de trabajo integrada
para herramientas gratuitas, tu cartera x402 para las pagadas), con caché y reintentos
idempotentes:
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" });
// no wallet? pay wallet-only tools by card with a prepaid credits key from /credits
const b = new Agent402({ creditsKey: "a402_..." });
Conecta a tu framework de agente (adaptadores sin dependencias)
Si ya estás en una de las pilas siguientes (OpenAI, Anthropic, el SDK de IA de Vercel, LangChain (JS o Python), LlamaIndex, Strands, Google ADK o el SDK de Agentes de OpenAI), omite la conexión: hay un paquete listo para usar que convierte el catálogo de Agent402 en objetos de herramienta nativos para tu framework, con el pago gestionado internamente (prueba de trabajo para herramientas gratuitas, x402+USDC cuando pasas un @x402/fetch):
| Pila | npm | Devuelve |
|---|---|---|
| Llamada de funciones de OpenAI (chat.completions / Assistants v2 / Responses) | agent402-openai-tools | tools[] para el parámetro tools: |
API de Mensajes de Anthropic (tool_use) | agent402-anthropic-tools | tools[] para el parámetro tools: |
SDK de IA de Vercel (streamText / generateText) | agent402-ai-sdk | Record<name, tool()> |
| LangChain JS / LangGraph | agent402-langchain | DynamicStructuredTool[] |
| LlamaIndex TS | agent402-llamaindex | FunctionTool[] |
| Agentes Strands (AWS Bedrock AgentCore) | agent402-strands | StrandsTool[] para new Agent({ tools }) |
| Google ADK (Kit de Desarrollo de Agentes) | agent402-google-adk | FunctionTool[] para agentes ADK |
| SDK de Agentes de OpenAI | agent402-openai-agents | Agent tools para @openai/agents |
| AgentKit de Coinbase (billeteras CDP, Privy, ZeroDev, viem) | agent402-agentkit | un ActionProvider para AgentKit.from({ actionProviders }) |
| LangChain Python / CrewAI | agent402-langchain (PyPI) | StructuredTool[] de Agent402Toolkit.get_tools() - cuatro meta-herramientas (buscar / enrutar / llamar / acerca de), no una por 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));
¿Ya eres usuario de Claude/MCP? agent402-mcp sigue siendo el mejor camino: pega https://agent402.tools/mcp en tu cliente. Los adaptadores son para integraciones directas de API donde MCP no está disponible. Fuentes: adapters/.
Agentes OpenClaw: incorpora skills/openclaw/agent402/SKILL.md: enseña a un agente OpenClaw a encontrar, pagar (x402 USDC en Base, otras once cadenas aceptadas, o prueba de trabajo gratuita) y llamar a cualquiera de las más de 500 herramientas y paquetes.
Añade tu propia herramienta (~15 líneas)
Una herramienta es solo un objeto en un array de kit. Colócalo en cualquier archivo de
src/tools/ (por ejemplo, añádelo a AGENT_TOOLS en src/tools/agent-kit.js)
y estará activa: enrutada, con esquema publicado, expuesta por MCP y cubierta por la
verificación de CI de "cada herramienta responde a su propio ejemplo":
{
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("") };
},
}
Ese es todo el contrato: handler(input) devuelve un objeto serializable en JSON
(o lanza un Error con .statusCode para un 4xx). Las herramientas de solo CPU son
automáticamente gratuitas mediante prueba de trabajo; las herramientas que acceden a la red o al disco permanecen
solo con billetera. Consulta CONTRIBUTING.md para el tutorial completo.
Opcional: cobra por llamada con x402
El mismo servidor puede exigir pago por llamada, útil si alojas una instancia
pública. Los pagos son la postura predeterminada: un npm start simple falla de forma segura,
saliendo a menos que WALLET_ADDRESS esté configurado: ejecutar sin pagos es la
opción explícita (FREE_MODE=true npm start). Para cobrar, configura WALLET_ADDRESS
- claves de facilitador de CDP (gratis en portal.cdp.coinbase.com)
y los agentes pagan en USDC en Base (o Solana, Polygon, Arbitrum, Monad, Celo, Avalanche, Sei, Optimism, Stellar,
Algorand, o USDG en Robinhood Chain mediante
PAYMENT_NETWORKS=…,robinhood+ROBINHOOD_FACILITATOR_URL) a través de clientes x402 estándar:
Cada 402 es válido bajo los propios esquemas de @x402/core (como máximo cinco etiquetas, verificadas por CI
en todas las rutas) y lleva un esquema de salida tipado dos veces: en la extensión de descubrimiento bazaar
y como accepts[0].outputSchema en el primer accept, de modo que un cliente que
lea el campo de la especificación vea la forma de la respuesta antes de pagar.
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://example.com/article" }),
});
Doble pila MPP. El muro de pago también habla MPP (Protocolo de Pagos entre Máquinas:
el esquema de autenticación HTTP Payment de seguimiento IETF de tempoxyz/mpp):
el mismo 402 lleva un desafío WWW-Authenticate: Payment, Authorization: Payment credentials settle, and settled responses return a Payment-Receipt.
MPP tiene dos métodos aquí: evm se liquida de forma idéntica a x402 (USDC EIP-3009,
mismo facilitador, mismo precio); tempo se liquida de forma nativa mediante
el propio relé de Tempo (TIP-1034/TIP-20, sin facilitador x402
involucrado): una ruta de liquidación genuinamente separada, configura TEMPO_API_KEY para
habilitarla. Un cliente mppx funciona
directamente para cualquiera de los dos métodos; configura MPP_SECRET_KEY para habilitar el shim en tu
propia instancia. Misma URL en ambos casos: el cliente del comprador elige el dialecto.
Los agentes sin billetera aún usan cada herramienta de solo CPU resolviendo una prueba de trabajo sha256 de un solo uso (en menos de un segundo; los servidores MCP lo hacen automáticamente). Detalles: wiki: Pagar con x402 · Pagar con MPP · Pagar con Compute.
Por qué pagar aquí: siete cosas que son diferentes
Cada afirmación enlaza a la superficie que la demuestra (la versión de una página: agent402.tools/why).
- Paga por lo que usó el modelo, con el límite citado primero. La puerta de enlace medida (
POST /v1/metered/chat/completions) cita cada 402 desde el propio cuerpo de la solicitud; una billetera que pagauptoliquida el uso real bajo ese límite, los descuentos del proveedor, como las lecturas de caché de prompt, se transmiten, y cada respuesta x402 o MPP liquidada lleva un recibo. - Una llamada fallida no se cobra, y la respuesta lo demuestra. La liquidación se ejecuta después del manejador y un estado de error la cancela, por lo que una respuesta sin recibo de pago, o un recibo marcado como
success:false, no movió dinero; un reintento con el mismoIdempotency-Keyy la misma credencial de pago reproduce la respuesta pagada en lugar de pagar de nuevo; el único caso residual (un recibo liquidado en una respuesta de error) es detectado por nuestra propia alarma y registrado como deuda en un libro de reembolsos, nunca cancelado en silencio. - Una clave compra todo. La misma billetera o clave de créditos paga cinco niveles de LLM en tres canales (chat de OpenAI, Responses de OpenAI, Mensajes de Anthropic), embeddings, rerank, imágenes, video, voz, transcripción, respuestas fundamentadas con citas, más de 500 herramientas, memoria vinculada a la billetera e informes terminados.
- No se requiere billetera. Créditos prepagados con tarjeta, tarjetas a través de MPP y pago con tarjeta para informes se sitúan junto a USDC o USDG en doce cadenas y MPP nativo en Tempo.
- Trabajo terminado, listo para usar. Dossiers, flujo de información privilegiada, tenencias 13F, informes de presentación, resúmenes de OPI, auditorías de dominio, riesgo de tokens, investigación profunda, resúmenes de mercado, vigilancia de retiros y un paquete de artículos de LinkedIn, fundamentados en fuentes primarias con un apéndice de datos; los monitores sondean diariamente de forma gratuita y vuelven a ejecutar el informe pagado cuando los hechos cambian.
- Compramos en tu nombre.
POST /api/route/executeresuelve una tarea al mejor vendedor del ecosistema, les paga desde nuestra billetera y transmite el resultado bajo un solo recibo. Los vendedores son enrutables con liquidación en cadena comprobada, con una excepción limitada para un vendedor de Solana sin historial bajo un pequeño límite por llamada. - Todo es verificable. Tiempo de actividad observado por dos sondas fuera de producción (
/status), un canario con dinero real a través de cada canal diariamente, transacciones publicadas por canal y vía (/revenue), código abierto y autoalojable. Las herramientas deterministas no ejecutan ningún modelo; las que lo hacen están nombradas (los niveles /v1, los productos de informes y las herramientas de imagen, voz, transcripción, embedding y respuesta de IA). El operador está identificado en cadena: Agent402 es el agente 94639 en el Registro de Identidad ERC-8004 en Base, que resuelve a/.well-known/agent-registration.json, con una tarjeta de agente A2A en/.well-known/agent-card.json.
Por qué es sólido
- Todo está probado: CI llama a las más de 500 herramientas con sus propios ejemplos
documentados y bloquea el lanzamiento ante cualquier fallo. Dos sondas independientes fuera
de producción observan la instancia en vivo (una cada 5 minutos, en infraestructura separada de
la otra), y lo que observan es público en
/status: donde un día sin observación se lee como "sin datos", nunca tiempo de actividad, porque una interrupción es exactamente cuando una sonda no puede informar. - Endurecido: protección SSRF en el momento de la conexión en cada herramienta de URL (seguro contra rebote de DNS), prueba de trabajo firmada/de un solo uso/limitada por slug, límites de velocidad por IP y cabeceras de seguridad. Consulta wiki: Modelo de Seguridad.
- Utilidades deterministas: ningún modelo en la ruta de servicio de las herramientas de utilidad, por lo que la misma entrada siempre da la misma salida, con esquemas OpenAPI completos.
- Ingresos auditables en cadena: cada llamada pagada se liquida en USDC a
agent402.base.eth(un nombre de Base que resuelve a la billetera receptora pública), verificable por cualquiera en Basescan; recuentos en vivo en/api/stats. - Licencia AGPL-3.0, amigable con el autoalojamiento: clónalo, elimina lo que no necesites, añade lo que necesites.
Agent402 en el ecosistema x402
x402 es un protocolo de pago abierto construido sobre HTTP 402 Payment Required para pagos por llamada entre máquinas en stablecoins (USDC).
La mayoría de los proyectos en el espacio son el protocolo + SDKs,
una plantilla de inicio o un facilitador de pagos. Agent402 es la capa aplicada:
un servidor x402 listo para ejecutar que ya habla el protocolo y trae más de 500
herramientas funcionales, para que no tengas que construir el catálogo tú mismo.
- ¿Quieres el protocolo o un SDK? → coinbase/x402.
- ¿Quieres un servidor que puedas ejecutar hoy que realmente haga cosas a través de x402 + MCP? → estás aquí.
- Autoalojable, determinista, gratuito mediante prueba de trabajo sin billetera y no custodial en las herramientas de pago (tu agente firma con su propia clave y no mantenemos ningún saldo de cripto por él; los créditos prepagados con tarjeta son un saldo retenido y se nombran como tal).
Listado en el Registro MCP oficial y descubrible en el Bazar x402 de Coinbase.
Funciona con AWS Bedrock AgentCore Payments directamente: AgentCore orquesta x402, que es el protocolo que Agent402 ya habla. Apunta la puerta de enlace de AgentCore a https://agent402.tools/mcp para las más de 500 herramientas, o usa agent402-strands para un subconjunto curado dentro de un agente Strands. Receta de cinco minutos: wiki: AWS Bedrock AgentCore.
Tollbooth: pago por rastreo para tu sitio (el otro lado de x402)
Cobra a los rastreadores de IA que visitan tu sitio. Los humanos navegan gratis; los bots conocidos reciben
402 Payment Required y pueden pagar en USDC a través de x402, o resolver una prueba de trabajo
gratuita. La respuesta abierta y nativa de cripto al pago por rastreo cerrado de Cloudflare:
sin bloqueo de CDN, sin Stripe, sin comerciante de registro, sin registro.
- Página del producto · precios · instalación en vivo: agent402.tools/tollbooth
- Tollbooth Cloud gestionado (Solo / Equipo / Agencia / Empresa): agent402.tools/tollbooth/cloud: únete a la lista de espera
- Ejecútalo tú mismo (MIT, npm):
npm i agent402-tollbooth·tollbooth/· tollbooth/README.md Se ejecuta como middleware de Express, middleware de Next.js / Vercel Edge, un Worker de Cloudflare, un proxy inverso o un plugin de WordPress (beta). Plantillas listas para usar entollbooth/deploy/. Un núcleo Web-Crypto impulsa todos ellos. Desde 0.9.x la puerta también habla MPP de forma nativa: entrégale tu middleware@x402/express(createTollbooth({ x402 })) y acuña desafíosWWW-Authenticate: Paymentevm a partir del mismo 402, o dale una clave de relay de Tempo (createTollbooth({ tempo: { apiKey, recipient, currency, splits } })) y liquida credenciales MPPtempo/chargeen Tempo con pagos divididos opcionales, sin ningún middleware x402. Desde 0.10.0 la compilación edge también habla MPP: consecret,payToy tu callbackverifyX402configurado, cada 402 lleva un desafíoWWW-Authenticate: Paymentjunto a la cotización x402, y una credencialAuthorization: Payment(vinculada por HMAC a ese desafío, sin expirar, acuñada para ese recurso exacto) se traduce aPAYMENT-SIGNATUREy se entrega al mismo verificador.
Mapa del repositorio
| Ruta | Qué es |
|---|---|
src/server.js | Aplicación Express + el catálogo de herramientas (rutas, precios, esquemas, descubrimiento) |
src/tools/ | Los kits de herramientas (web, PDF, medios, imágenes, datos en vivo, cripto/x402, 150+ utilidades puras de CPU) - añade herramientas aquí |
src/mcp-http.js | Conector MCP alojado (HTTP transmisible, nivel gratuito sin autenticación) |
src/pow.js | Nivel de prueba de trabajo (desafíos firmados, de un solo uso, con alcance de slug) |
src/payments.js | Cableado opcional de x402 v2: USDC en Base/Solana/Polygon/Arbitrum/Monad/Celo/Avalanche/Sei/Optimism/Stellar/Algorand + USDG en Robinhood Chain (12 cadenas), facilitador CDP, descubrimiento Bazaar |
src/mpp-shim.js, src/mpp-tempo.js, src/mpp-stripe.js | MPP en las mismas rutas: desafíos/credenciales Payment traducidos a x402 (evm), liquidación nativa de Tempo a través del relay de Tempo, y tarjetas Stripe sobre MPP |
src/x402-index.js | Índice x402 + Enrutador de Órdenes Inteligente: rastreo entre vendedores, autodescubrimiento, enrutamiento consciente de salud, páginas de mercado por cadena (/stellar, /algorand) |
src/sell.js | /sell - la puerta de entrada del vendedor: listado gratuito de autoservicio (POST /api/index/register) o agent402-tollbooth para pago por rastreo |
src/human-checkout.js | Puerta de entrada con tarjeta para los productos de informes: /reports (página en src/human-reports-page.js), POST /api/buy, entrega en /r/:sessionId (Stripe Checkout, generar una vez, reembolso automático en caso de fallo) |
src/stripe-subscriptions.js | /monitors - suscripciones de monitoreo por $5/mes (MONITOR_PRODUCTS: dominio, presentación, token, fondo, retiro, información privilegiada, IPO), webhook verificado por firma, Portal del Cliente |
src/monitor-scheduler.js | Cumplimiento para los monitores: sondeos diarios baratos, re-ejecuciones pagadas ante cambios, entrega por correo electrónico, informes en /m/:id |
src/credits.js | Créditos de tarjeta prepagados: /credits, claves de portador a402_, la puerta de autorizar-luego-cobrar frente a cada ruta con precio |
mcp/ | El paquete npm agent402-mcp (servidor MCP stdio) |
client/ | El SDK de comprador agent402-client (find() + call() con pago automático) |
tollbooth/ | La puerta de pago por rastreo agent402-tollbooth (Express / edge / proxy) |
adapters/ | Herramientas listas para usar para cada framework en la tabla de adaptadores anterior (npm, además de langchain-py en PyPI para LangChain/CrewAI Python) |
wiki/ | Fuente para la wiki de GitHub (sincronizada por CI) |
scripts/ | Pruebas, demos, herramientas de operaciones |
Legal
- La instancia alojada en agent402.tools se proporciona bajo sus Términos de Servicio (política de uso aceptable incluida - usar el servicio, incluso programáticamente, constituye aceptación) y Política de Privacidad.
- El tráfico de puerta de enlace de IA (
/v1chat, embeddings, imágenes, voz) está sujeto adicionalmente a las políticas de uso de los proveedores de modelos upstream. Las billeteras utilizadas para contenido prohibido se bloquean antes de la liquidación (WALLET_BLOCKLIST). - El código del servidor tiene licencia AGPL-3.0 y se proporciona tal cual; cada paquete npm publicado es MIT con su propio archivo LICENSE en su directorio:
agent402-mcp(mcp/),agent402-client(client/),agent402-tollbooth(tollbooth/),agent402-openclaw(openclaw/),agent402-agentkit(adapters/agentkit/),elizaos-plugin-agent402(adapters/eliza/) y el facilitador (facilitator/). La insignia de licencia a nivel de repositorio de GitHub informa el AGPL del servidor; el campolicensede un paquete y el LICENSE de su directorio son lo que se aplica a ese paquete. Se proporciona tal cual, sin garantía (ver LICENSE y NOTICE). "Agent402" y el logotipo son marcas comerciales de Havok Holdings LLC - la licencia cubre el código, no el nombre; las bifurcaciones deben renombrar (ver TRADEMARKS.md). Si auto-alojas, tú eres el operador: tu implementación, tus términos, tu cumplimiento - Havok Holdings LLC opera solo la instancia alojada y no es responsable de implementaciones de terceros.
Contacto
- Correo electrónico: mike@agent402.tools
- X / Twitter: @Agent402Tools
- GitHub: MikeyPetrillo/Agent402
Contribuciones
Los PRs que añaden herramientas útiles, corrigen errores o mejoran la documentación son muy bienvenidos - ver CONTRIBUTING.md. Servidor AGPL-3.0, cada paquete publicado MIT (ver Legal arriba). Mantenido por Havok Holdings LLC.