Agent402

Servidor MCP auto-hospedável de código aberto com ~1.100 ferramentas determinísticas (busca na web, Chromium headless, PDFs, OCR, imagens, ~1.040 utilitários de CPU). Gratuito para auto-hospedar ou pagar por chamada via x402 (USDC na Base).

Documentação

Agent402.Tools - porta de entrada de busca + resposta, 500+ ferramentas, índice x402 aberto

O que torna diferente: Agent402 é open-source e auto-hospedável - e uma única integração dá ao comprador três primitivas gratuitas sobre todo o ecossistema x402:

  • Find - /api/find?q={task} resolve uma descrição de tarefa para as ferramentas mais adequadas (rota, preço, schema, exemplo pronto).
  • Route - POST /api/route é o neutral Smart Order Router: classifica ferramentas entre todos os vendedores x402 rastreados (auto-descobertos do Coinbase CDP Bazaar), ciente de saúde, com include=external para nos excluir.
  • Leaderboard - GET /api/leaderboard é o ranking público on-chain de cada vendedor x402 por volume liquidado em USDC na Base - chamadas atendidas, totalUsd, compradores únicos por vendedor. Pipeline: Bazaar → eth_getLogs → teto por chamada → agregação por payTo. Snapshot a cada hora.

Além do catálogo - 500+ ferramentas: busca/resposta como porta de entrada do MCP, depois 400+ ferramentas + 100+ pacotes de habilidades curados (fluxos de múltiplas ferramentas chamáveis como prompts MCP) - tudo executável por você mesmo, além de agent402-tollbooth - um portão aberto pay-per-crawl para o outro lado do x402.

Live npm npm npm CI License: AGPL-3.0 smithery badge

Adaptadores de framework (ferramentas plug-and-play para as principais stacks de agentes - pagamento automático por baixo): npm npm npm npm npm npm npm npm

500+ ferramentas - busca web ao vivo e respostas com citações como porta de entrada do MCP, depois 400+ ferramentas web prontas para uso + 100+ pacotes de habilidades com múltiplas ferramentas para seu agente de IA, a partir de um único servidor. Cada uma testada, precificada e liquidada on-chain; cada uma merece seu lugar. Renderização de navegador, busca web, PDFs, imagens, OCR, dados ao vivo de finanças/cripto/macro, SEC EDGAR, estatísticas determinísticas, previsões, e precificação de opções e títulos (Black-Scholes, YTM), compressão, e 200+ utilitários puros de CPU. Execute você mesmo gratuitamente em 30 segundos (MCP ou HTTP simples, sem chaves de API, sem cadastro), conecte-o ao Claude/ChatGPT/qualquer cliente MCP, e adicione suas próprias ferramentas em poucas linhas. Cada ferramenta é determinística - sem LLM no caminho de serviço - e re-testada contra seu próprio exemplo antes de cada lançamento.

Opcionalmente, o mesmo servidor pode cobrar por chamada via protocolo x402 (USDC na Base, Solana, Polygon, Arbitrum, Monad, Celo, Avalanche, Sei, Optimism, Stellar & Algorand, além de USDG na Robinhood Chain - 12 chains) - então a instância que você auto-hospeda gratuitamente também pode ser uma hospedada e monetizada. Essa parte é opt-in; por padrão tudo roda de graça.

🟢 Demo hospedada: agent402.tools · 📖 Wiki · 📦 npm · 🔌 MCP Registry · 🧩 Smithery

Execute você mesmo em 30 segundos

Escolha o que se encaixa melhor. Todos são gratuitos e não precisam de carteira:

1. Zero instalação - adicione o conector hospedado ao Claude (claude.ai → Settings → Connectors → Add custom connector):

https://agent402.tools/mcp

2. Um comando - execute o servidor MCP localmente (as ferramentas puras de CPU funcionam sem chave; ele paga o pequeno proof-of-work por você):

npx -y agent402-mcp
# in Claude Code:  claude mcp add agent402 -- npx -y agent402-mcp

3. Clone e hospede tudo (todas as 500+ ferramentas como API HTTP + MCP, modo gratuito, sem pagamentos):

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. Deploy com um clique no Railway (instância completa auto-hospedada - adiciona plugins opcionais Postgres + Redis para analytics + cache de respostas):

Deploy on Railway

Inicia direto do railway.toml + Dockerfile do repositório. Plugins opcionais são auto-detectados via env: adicione RedisREDIS_URL habilita o cache de respostas upstream (X-Cache: hit|miss), adicione PostgresDATABASE_URL habilita o dashboard público /api/analytics e a lista de espera do tollbooth. Nenhuma variável de env é necessária para iniciar em modo gratuito.

O que há no catálogo (500+ ferramentas)

Cada ferramenta merece seu lugar: determinística, testada contra seu próprio exemplo em cada execução de CI, precificada de acordo com o mercado, liquidada on-chain. CI mantém um piso de catálogo de 400 entradas e verifica a afirmação "500+" contra o catálogo em execução (scripts/sync-count.js --check). O catálogo cresce apenas quando uma ferramenta vale a pena ser chamada.

Exemplos
Navegador & webrender (headless Chromium, executa JS), screenshot, extract (artigo→markdown), meta
Busca ao vivo & respostassearch (índice web real), answer (resposta web com citações), variantes search-news/search-images/search-videos, search-suggest, multi-search
PDFs & mídiapdf-to-markdown, pdf-merge, pdf-extract-pages, pdf-rotate, images-to-pdf, audio-convert, audio-normalize (EBU R128, ffmpeg real)
Imagensimage-resize, image-convert, image-thumbnail, barcode-decode (jimp/zxing, CPU pura)
OCRimage-ocr (texto de qualquer imagem - CPU pura, sem modelo)
Geogeo-distance (haversine, CPU pura), geocode, reverse-geocode, place-search, geo-lookup
Dados ao vivofx-rate (ECB), barcode-lookup (Open Food Facts), gov-data (data.gov), weather-forecast/weather-alerts, earthquakes (USGS)
Finanças & criptostock-quote/stock-history/earnings-calendar (Yahoo), crypto-price/crypto-market/crypto-history/crypto-trending/crypto-global (CoinGecko)
Macro (FRED + mais)curva de juros, tesouro, fiscal, Fed funds, CPI, desemprego, regra de Sahm, ECB FX, World Bank, observações de lançamentos FRED em massa
SEC EDGARticker→CIK, lista de registros, texto 10-K/10-Q, XBRL frames, transações de insiders, participações 13F, calendário de IPOs, busca em texto completo
Verdade de rededns, dns-lookup, tls-cert, whois, http-check, robots-check, email-validate, ip-info
Cripto & pagamentosusdc-balance, tx-status, gas-estimate, ens-resolve, x402-quote, x402-verify, transfer-authorization - não-custodial, multi-chain (Base/Polygon/Arbitrum/Optimism/Ethereum)
Memória de agenteKV com TTL por carteira, contadores atômicos, concessões entre carteiras, log de auditoria com hash encadeado, recall por similaridade
Estatística & previsõesstats-summary, correlation, linear-regression, moving-average, outliers; forecast-naive, forecast-ses, forecast-holt, forecast-holt-winters + forecast-eval (backtest MAPE/RMSE)
Matemática financeirablack-scholes (precificação de opções + gregos), bond-price/bond-ytm, cagr, sharpe-ratio, annuity, npv/irr, compound-interest, loan-payment/amortization, break-even, effective-annual-rate (CPU pura, determinístico)
Compressãogzip/gunzip, brotli-compress/brotli-decompress, compress-compare (disputa de algoritmos, CPU pura via node:zlib)
Extração HTMLhtml-select (consulta CSS), html-table, html-strip, html-links, html-meta - contraparte determinística de extract
Operações de rededns-lookup, dns-propagation, spf-check/dmarc-check/dkim-lookup, email-deliverability; cert-transparency, http-headers (auditoria de segurança), tech-stack, asn-info (geo de IP)
Leituras de chainblock-number, chain-info, block-info, contract-code, erc721-owner, event-logs - leituras JSON-RPC sem chave com failover multi-endpoint em Ethereum/Base/Polygon/Arbitrum/Optimism, a partir de $0.001
Política SQLsql-guard ($0.004 - veredito pass/warn/block com riscos nomeados em uma instrução SQL, além de um certificado de execução Ed25519 quando uma chave de assinatura está configurada), sql-cert-verify ($0.001 - verifica esse certificado contra a instrução exata)
Confiança de vendedor x402seller-trust (GET /api/x402/seller-trust, $0.005) - um vendedor está indexado, seu manifest é parseável, quais chains ele anuncia, quantas chamadas liquidadas ele foi observado recebendo on-chain, e nosso próprio router gastaria dinheiro do comprador nele
200+ utilitários puros de CPUhashing, JWT, base58, JSON⇄CSV/YAML, token-count, text-chunk, json-validate, estatísticas de texto, matemática cron, validadores, conversões de unidades em 13 categorias (uma ferramenta paramétrica)

Schemas completos vivem em /openapi.json; um catálogo legível por máquina está em /api/pricing e /llms.txt. Não sabe qual ferramenta precisa? /api/find?q=<task> resolve uma descrição de tarefa para a ferramenta certa - rota, preço, schema e um exemplo pronto - para que um agente pule a etapa de "procurar uma ferramenta" que consome muitos tokens.

Gateway LLM compatível com OpenAI (/v1) - chat, embeddings & imagens, pague por chamada

Aponte qualquer SDK OpenAI para base_url = https://agent402.tools/v1 e pague por chamada em USDC via x402 - sem chave de API, sem cadastro, sem conta:

EndpointPreçoAtende
POST /v1/nano/chat/completions$0.003modelos nano - precificados para loops de agente de alta frequência
POST /v1/auto/chat/completions$0.01sem necessidade de modelo - roteamento determinístico avaliado por ranking (código / raciocínio / longo / geral), quality: fast | balanced | best opcional pelo mesmo preço, decisão divulgada via agent402_router
POST /v1/chat/completions$0.02modelos econômicos/intermediários (gpt-4o-mini, claude haiku, gemini flash, deepseek, llama…)
POST /v1/pro/chat/completions$0.10intermediários-frontier (gpt-4o, gpt-4.1, claude sonnet, gemini pro, grok)
POST /v1/premium/chat/completions$0.50frontier (gpt-5, o3/o4, claude opus)
POST /v1/embeddings$0.002embeddings OpenAI, lote de até 64 entradas - repetições idênticas são gratuitas (saída determinística, cache ligado por padrão)
POST /v1/images/generations$0.08geração de imagens (Gemini 2.5 Flash Image) - wire de imagens OpenAI, base64 inline na saída
POST /v1/audio/speech$0.06texto-para-fala, wire OpenAI audio.speech.create() - até 2.000 caracteres de entrada, mp3 bruto (padrão) ou bytes pcm na saída, cadeia de failover com seis modelos

Streaming (stream: true), passagem completa de tools/function-calling, cache de prompt opt-in nos níveis de chat (cache: true → repetições byte-idênticas gratuitas por 10 minutos), cadeias de failover upstream que terminam em um modelo comprovado por canary, e uma lista gratuita GET /v1/models com todos os modelos e seus níveis e limites. Um canary com dinheiro real compra de cada uma dessas superfícies diariamente - streaming, divulgação de roteamento e ambos os comportamentos de cache incluídos.

Duas ferramentas complementares fecham o ciclo: POST /api/route/execute ($0.01, com níveis execute-plus $0.05 e execute-max $0.55 para ferramentas mais caras) resolve uma descrição de tarefa para a melhor ferramenta e a executa em uma única chamada paga, incluindo, com include:"external", ferramentas vendidas por outros vendedores x402 (roteia apenas para vendedores com volume on-chain liquidado comprovado, paga a eles em seu nome na chain em que você pagou - Base ou Algorand - e retransmite o resultado; veja o guia Smart Order Router), e POST /api/my-usage ($0.005) retorna o histórico de compras da própria carteira pagante - sem parâmetro de carteira; o pagamento x402 é a identidade, então ninguém pode ler o perfil de outra carteira.

Pacotes de habilidades - 100+ fluxos de múltiplas ferramentas

Para tarefas que abrangem várias ferramentas - "auditar um domínio", "diagnosticar entregabilidade", "trabalhar uma série temporal", "descascar um blob opaco" - o Agent402 oferece pacotes de habilidades curados: sequências ordenadas e tipadas de chamadas de ferramentas com um modelo de prompt pronto para Claude. Chamáveis como prompts MCP (prompts/listprompts/get { name, arguments }) ou HTTP simples em GET /api/skill-packs/{slug}/prompt (cada slug está listado no índice JSON gratuito em /api/skill-packs.json). Uma consulta em formato de tarefa para search_tools retorna o pacote correspondente junto com ferramentas individuais.

Pacote em destaqueCadeiasUse para
security-auditcert-transparency · dns-lookup · spf-check · dmarc-check · http-headers · tls-cert · tech-stackPostura de segurança de domínio
trend-analysisstock-history · fred-series · stats-summary · moving-average · linear-regression · outliers · correlation · forecast-evalAnálise quantitativa de qualquer série temporal
structured-scrapeextract · render · html-select · html-table · html-strip · html-links · html-metaÁrvore de decisão determinística para scraping
decode-blobjwt-decode · gunzip · brotli-decompress · base64 · hex · json-format · hashIdentificar e descascar qualquer string opaca
forecasting-bake-offstock-history · fred-series · forecast-eval · forecast-naive · forecast-ses · forecast-holt · forecast-holt-wintersClassificar 4 previsores por RMSE, escolher o vencedor
document-intelpdf-info · pdf-to-markdown · pdf-extract-pages · image-ocr · barcode-decode · pdf-merge · images-to-pdfPipeline de PDF/OCR/código de barras
status-snapshotdns-lookup · http-check · http-headers · tls-cert · robots-checkVarredura única de saúde do serviço
webhook-debugjson-format · jwt-decode · hmac · json-validate · time-convert · redact · extract-entitiesTriagem de payload de webhook

Todos os 100+ pacotes em /skills · índice JSON em /api/skill-packs.json · no MCP, os pacotes aparecem sob prompts/list para que qualquer cliente compatível com MCP os detecte automaticamente.

Índice x402 - Encontre · Roteie · Ranking

O Agent402 também é a camada aberta de roteamento + classificação para todo o ecossistema x402: ele rastreia vendedores x402 públicos (o catálogo local + um conjunto descoberto automaticamente do Coinbase CDP Bazaar, atualizado a cada hora) e os expõe por meio de três superfícies gratuitas - mesma lógica do /api/find: primitivas de descoberta não devem custar dinheiro.

SuperfícieO quê
GET /api/find?q={task}Resolve uma tarefa para as ferramentas mais adequadas (rota, preço, esquema, exemplo pronto)
POST /api/routeRoteador Inteligente de Pedidos: { query, top, include } → ferramentas classificadas entre vendedores (pontuação de correspondência, depois saúde, depois preço). include=external exclui o próprio Agent402
GET /api/leaderboardClassificação on-chain de cada vendedor x402 por volume liquidado em USDC na Base (callsSettled, totalUsd, uniqueBuyers por vendedor). Pipeline: Bazaar → eth_getLogs → teto por chamada → agregado. Snapshot horário
/marketplacePainel HTML público: cada vendedor, contagem de ferramentas, rede, última busca, saúde contínua
GET /api/indexSnapshot JSON dos mesmos dados (totais, saúde por vendedor/indicadores de roteamento)
/stellar · /algorandPáginas de marketplace por rede: vendedores e ferramentas que liquidam especificamente nessa trilha
# "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'

Ciente da saúde: vendedores cujas últimas varreduras falharam são excluídos do roteador (um comprador roteado para um vendedor morto desperdiça dinheiro). Vendedores mais saudáveis também desempatam em igualdade de pontuação de correspondência e preço, então vendedores instáveis mas baratos perdem para os confiáveis. Vendedores novos (sem histórico ainda) recebem o benefício da dúvida.

Operadores obtêm atribuição de 3 trilhas no painel (/api/stats, /__operator, protegido por token - responde 404 sem o token do operador): tráfego USDC vs. proof-of-work vs. sonda de heartbeat são contados separadamente - e a trilha de heartbeat é controlada por um token assinado por POW_SECRET (não um User-Agent falsificável), para que a visão do operador reflita a demanda externa real.

Para vendedores de API: /sell é a porta de entrada - liste uma API existente que fala x402 no índice gratuitamente com POST /api/index/register (roteado por saúde, 0% de taxa, autoatendimento, sem cadastro), ou instale agent402-tollbooth para colocar um portão de pagamento por varredura na frente de um site que ainda não é nativo de x402.

Do código, o pacote npm agent402-client encapsula tudo isso - find() uma ferramenta, depois call() ela, pagando automaticamente (um proof-of-work embutido para ferramentas gratuitas, sua carteira x402 para as pagas), com cache e tentativas 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" });

Conecte-se ao seu framework de agentes (adaptadores sem dependências)

Se você já está em uma das stacks abaixo - OpenAI, Anthropic, Vercel AI SDK, LangChain (JS ou Python), LlamaIndex, Strands, Google ADK ou OpenAI Agents SDK - pule a configuração: há um pacote plug-and-play que transforma o catálogo do Agent402 em objetos de ferramenta nativos para o seu framework, com pagamento tratado por baixo (proof-of-work para ferramentas gratuitas, x402+USDC quando você passa um @x402/fetch):

StacknpmRetorna
OpenAI function-calling (chat.completions / Assistants v2 / Responses)agent402-openai-toolstools[] para o parâmetro tools:
Anthropic Messages API (tool_use)agent402-anthropic-toolstools[] para o parâmetro tools:
Vercel AI SDK (streamText / generateText)agent402-ai-sdkRecord<name, tool()>
LangChain JS / LangGraphagent402-langchainDynamicStructuredTool[]
LlamaIndex TSagent402-llamaindexFunctionTool[]
Strands Agents (AWS Bedrock AgentCore)agent402-strandsStrandsTool[] para new Agent({ tools })
Google ADK (Agent Development Kit)agent402-google-adkFunctionTool[] para agentes ADK
OpenAI Agents SDKagent402-openai-agentsAgent tools para @openai/agents
LangChain Python / CrewAIagent402-langchain (PyPI)StructuredTool[] de Agent402Toolkit.get_tools() - quatro meta-ferramentas (find / route / call / about), não uma 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));

Já é usuário de Claude/MCP? agent402-mcp ainda é o melhor caminho - cole https://agent402.tools/mcp no seu cliente. Os adaptadores são para integrações diretas de API onde o MCP não está disponível. Fontes: adapters/.

Agentes OpenClaw: adicione skills/openclaw/agent402/SKILL.md - ensina um agente OpenClaw a encontrar, pagar (x402 USDC na Base, outras onze redes aceitas, ou proof-of-work gratuito) e chamar qualquer uma das 400+ ferramentas (ou 100+ pacotes).

Adicione sua própria ferramenta (~15 linhas)

Uma ferramenta é apenas um objeto em um array de kit. Coloque isso em qualquer arquivo em src/tools/ (por exemplo, anexe a AGENT_TOOLS em src/tools/agent-kit.js) e ela estará ativa - roteada, com esquema publicado, exposta via MCP e coberta pela verificação de CI "toda ferramenta responde ao seu próprio exemplo":

{
  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("") };
  },
}

Esse é o contrato completo: handler(input) retorna um objeto serializável em JSON (ou lança um Error com .statusCode para um 4xx). Ferramentas puramente de CPU são automaticamente gratuitas via proof-of-work; ferramentas que acessam rede ou disco permanecem apenas com carteira. Veja CONTRIBUTING.md para o passo a passo completo.

Opcional: cobre por chamada com x402

O mesmo servidor pode exigir pagamento por chamada - útil se você hospedar uma instância pública. Pagamentos são a postura padrão: um npm start simples falha fechado, saindo a menos que WALLET_ADDRESS esteja definido - rodar sem pagamentos é a opção explícita (FREE_MODE=true npm start). Para cobrar, defina WALLET_ADDRESS + chaves do facilitador CDP (gratuitas em portal.cdp.coinbase.com) e os agentes pagam em USDC na Base (ou Solana, Polygon, Arbitrum, Monad, Celo, Avalanche, Sei, Optimism, Stellar, Algorand - ou USDG na Robinhood Chain via PAYMENT_NETWORKS=…,robinhood + ROBINHOOD_FACILITATOR_URL) via clientes x402 padrão:

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" }),
});

MPP dual-stack. O paywall também fala MPP (Machine Payments Protocol - o esquema de autenticação HTTP Payment em trilha IETF de tempoxyz/mpp): o mesmo 402 carrega um desafio WWW-Authenticate: Payment, credenciais Authorization: Payment liquidam de forma idêntica (EIP-3009 USDC, mesmo facilitador, mesmo preço), e respostas liquidadas retornam um Payment-Receipt. Um cliente mppx funciona imediatamente; defina MPP_SECRET_KEY para habilitá-lo na sua própria instância. Mesma URL de qualquer forma - o cliente do comprador escolhe o dialeto.

Agentes sem carteira ainda usam todas as ferramentas puramente de CPU resolvendo um proof-of-work sha256 de uso único (sub-segundo; os servidores MCP fazem isso automaticamente). Detalhes: wiki: Pagando com x402 · Pagando com Compute.

Por que é sólido

  • Tudo é testado - a CI chama todas as 500+ ferramentas com seus próprios exemplos documentados e bloqueia o lançamento em qualquer falha. Duas sondas independentes fora da produção observam a instância ao vivo (uma a cada 5 minutos, em infraestrutura separada da outra), e o que observam é público em /status - onde um dia sem observação lê "sem dados", nunca uptime, porque uma interrupção é exatamente quando uma sonda não consegue reportar.
  • Endurecido - proteção SSRF no momento da conexão em toda ferramenta de URL (seguro contra DNS-rebind), proof-of-work assinado/uso único/escopo por slug, limites de taxa por IP e cabeçalhos de segurança. Veja wiki: Modelo de Segurança.
  • Determinístico - nenhum modelo no caminho de serviço, então a mesma entrada sempre produz a mesma saída, com esquemas OpenAPI completos.
  • Receita auditável e on-chain - cada chamada paga liquida em USDC para agent402.base.eth (um nome Base que resolve para a carteira receptora pública) - verificável por qualquer pessoa no Basescan; contagens ao vivo em /api/stats.
  • Licenciado sob AGPL-3.0, amigável para auto-hospedagem - clone, remova o que não precisa, adicione o que quiser.

Agent402 no ecossistema x402

x402 é um protocolo de pagamento aberto construído sobre HTTP 402 Payment Required para pagamentos máquina-a-máquina, pagamento por chamada em stablecoins (USDC). A maioria dos projetos no espaço são o protocolo + SDKs, um template inicial ou um facilitador de pagamento. Agent402 é a camada aplicada - um servidor x402 pronto para executar que já fala o protocolo e oferece 500+ ferramentas funcionais, para que você não precise construir o catálogo do zero.

  • Quer o protocolo ou um SDK?coinbase/x402.
  • Quer um servidor que possa executar hoje e que realmente faça coisas via x402 + MCP? → você está aqui.
  • Auto-hospedável, determinístico, gratuito via proof-of-work sem carteira e não custodial nas ferramentas de pagamento (seu agente assina com sua própria chave - o Agent402 nunca detém fundos).

Listado no Registro MCP oficial e detectável no x402 Bazaar da Coinbase.

Funciona com AWS Bedrock AgentCore Payments imediatamente - o AgentCore orquestra x402, que é o protocolo que o Agent402 já fala. Aponte o Gateway do AgentCore para https://agent402.tools/mcp para todas as 500+ ferramentas, ou use agent402-strands para um subconjunto curado dentro de um agente Strands. Receita de cinco minutos: wiki: AWS Bedrock AgentCore.

Tollbooth - pagamento por varredura para seu site (o outro lado do x402)

Cobre crawlers de IA que acessam seu site. Humanos navegam grátis; bots conhecidos recebem 402 Payment Required e podem pagar em USDC via x402 - ou resolver um proof-of-work gratuito. A resposta aberta e cripto-nativa ao pay-per-crawl fechado da Cloudflare: sem lock-in de CDN, sem Stripe, sem merchant-of-record, sem cadastro.

Funciona como middleware Express, middleware Next.js / Vercel Edge, Cloudflare Worker, proxy reverso ou plugin WordPress (beta). Modelos prontos para uso em tollbooth/deploy/. Um único núcleo Web-Crypto alimenta todos eles.

Mapa do repositório

CaminhoO que
src/server.jsApp Express + o catálogo de ferramentas (rotas, preços, schemas, discovery)
src/tools/Os kits de ferramentas (web, PDF, mídia, imagens, dados ao vivo, crypto/x402, 200+ utilitários puros de CPU) - adicione ferramentas aqui
src/mcp-http.jsConector MCP hospedado (HTTP streamable, camada gratuita sem autenticação)
src/pow.jsCamada de proof-of-work (challenges assinados, de uso único, escopados por slug)
src/payments.jsIntegração opcional x402 v2: USDC em Base/Solana/Polygon/Arbitrum/Monad/Celo/Avalanche/Sei/Optimism/Stellar/Algorand + USDG em Robinhood Chain (12 chains), facilitador CDP, discovery Bazaar
src/x402-index.jsÍndice x402 + Smart Order Router: crawl entre vendedores, auto-discovery, roteamento ciente de saúde, páginas de marketplace por chain (/stellar, /algorand)
src/sell.js/sell - a porta de entrada do vendedor: listagem gratuita self-serve (POST /api/index/register) ou agent402-tollbooth para pay-per-crawl
mcp/O pacote npm agent402-mcp (servidor MCP stdio)
client/O SDK do comprador agent402-client (find() + call() com pagamento automático)
tollbooth/O gate pay-per-crawl agent402-tollbooth (Express / edge / proxy)
adapters/Ferramentas prontas para cada framework na tabela de adaptadores acima (npm, além de langchain-py no PyPI para LangChain/CrewAI Python)
wiki/Fonte para o GitHub wiki (sincronizado por CI)
scripts/Testes, demos, ferramentas de operação

Legal

  • A instância hospedada em agent402.tools é fornecida sob seus Termos de Serviço (política de uso aceitável incluída - usar o serviço, inclusive programaticamente, constitui aceitação) e Política de Privacidade.
  • O tráfego de gateways de IA (/v1 chat, embeddings, imagens, fala) está adicionalmente sujeito às políticas de uso dos provedores de modelos upstream. Carteiras usadas para conteúdo proibido são bloqueadas antes da liquidação (WALLET_BLOCKLIST).
  • O código do servidor é licenciado sob AGPL-3.0 (o SDK do cliente, o conector MCP e os pacotes tollbooth são MIT) e fornecido como está, sem garantia (veja LICENSE e NOTICE). "Agent402" e o logotipo são marcas registradas da Havok Holdings LLC - a licença cobre o código, não o nome; forks devem renomear (veja TRADEMARKS.md). Se você fizer self-host, você é o operador: sua implantação, seus termos, sua conformidade - a Havok Holdings LLC opera apenas a instância hospedada e não é responsável por implantações de terceiros.

Contato

Contribuição

PRs que adicionam ferramentas úteis, corrigem bugs ou melhoram a documentação são muito bem-vindos - veja CONTRIBUTING.md. Licenciado sob AGPL-3.0 (pacotes MIT). Mantido pela Havok Holdings LLC.