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, cominclude=externalpara 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 porpayTo. 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.
Adaptadores de framework (ferramentas plug-and-play para as principais stacks de agentes - pagamento automático por baixo):
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):
Inicia direto do railway.toml + Dockerfile do repositório. Plugins opcionais são auto-detectados via env: adicione Redis → REDIS_URL habilita o cache de respostas upstream (X-Cache: hit|miss), adicione Postgres → DATABASE_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 & web | render (headless Chromium, executa JS), screenshot, extract (artigo→markdown), meta |
| Busca ao vivo & respostas | search (índice web real), answer (resposta web com citações), variantes search-news/search-images/search-videos, search-suggest, multi-search |
| PDFs & mídia | pdf-to-markdown, pdf-merge, pdf-extract-pages, pdf-rotate, images-to-pdf, audio-convert, audio-normalize (EBU R128, ffmpeg real) |
| Imagens | image-resize, image-convert, image-thumbnail, barcode-decode (jimp/zxing, CPU pura) |
| OCR | image-ocr (texto de qualquer imagem - CPU pura, sem modelo) |
| Geo | geo-distance (haversine, CPU pura), geocode, reverse-geocode, place-search, geo-lookup |
| Dados ao vivo | fx-rate (ECB), barcode-lookup (Open Food Facts), gov-data (data.gov), weather-forecast/weather-alerts, earthquakes (USGS) |
| Finanças & cripto | stock-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 EDGAR | ticker→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 rede | dns, dns-lookup, tls-cert, whois, http-check, robots-check, email-validate, ip-info |
| Cripto & pagamentos | usdc-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 agente | KV com TTL por carteira, contadores atômicos, concessões entre carteiras, log de auditoria com hash encadeado, recall por similaridade |
| Estatística & previsões | stats-summary, correlation, linear-regression, moving-average, outliers; forecast-naive, forecast-ses, forecast-holt, forecast-holt-winters + forecast-eval (backtest MAPE/RMSE) |
| Matemática financeira | black-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ão | gzip/gunzip, brotli-compress/brotli-decompress, compress-compare (disputa de algoritmos, CPU pura via node:zlib) |
| Extração HTML | html-select (consulta CSS), html-table, html-strip, html-links, html-meta - contraparte determinística de extract |
| Operações de rede | dns-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 chain | block-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 SQL | sql-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 x402 | seller-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 CPU | hashing, 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:
| Endpoint | Preço | Atende |
|---|---|---|
POST /v1/nano/chat/completions | $0.003 | modelos nano - precificados para loops de agente de alta frequência |
POST /v1/auto/chat/completions | $0.01 | sem 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.02 | modelos econômicos/intermediários (gpt-4o-mini, claude haiku, gemini flash, deepseek, llama…) |
POST /v1/pro/chat/completions | $0.10 | intermediários-frontier (gpt-4o, gpt-4.1, claude sonnet, gemini pro, grok) |
POST /v1/premium/chat/completions | $0.50 | frontier (gpt-5, o3/o4, claude opus) |
POST /v1/embeddings | $0.002 | embeddings 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.08 | geração de imagens (Gemini 2.5 Flash Image) - wire de imagens OpenAI, base64 inline na saída |
POST /v1/audio/speech | $0.06 | texto-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/list → prompts/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 destaque | Cadeias | Use para |
|---|---|---|
security-audit | cert-transparency · dns-lookup · spf-check · dmarc-check · http-headers · tls-cert · tech-stack | Postura de segurança de domínio |
trend-analysis | stock-history · fred-series · stats-summary · moving-average · linear-regression · outliers · correlation · forecast-eval | Análise quantitativa de qualquer série temporal |
structured-scrape | extract · render · html-select · html-table · html-strip · html-links · html-meta | Árvore de decisão determinística para scraping |
decode-blob | jwt-decode · gunzip · brotli-decompress · base64 · hex · json-format · hash | Identificar e descascar qualquer string opaca |
forecasting-bake-off | stock-history · fred-series · forecast-eval · forecast-naive · forecast-ses · forecast-holt · forecast-holt-winters | Classificar 4 previsores por RMSE, escolher o vencedor |
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 | Varredura única de saúde do serviço |
webhook-debug | json-format · jwt-decode · hmac · json-validate · time-convert · redact · extract-entities | Triagem 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ície | O quê |
|---|---|
GET /api/find?q={task} | Resolve uma tarefa para as ferramentas mais adequadas (rota, preço, esquema, exemplo pronto) |
POST /api/route | Roteador 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/leaderboard | Classificaçã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 |
/marketplace | Painel HTML público: cada vendedor, contagem de ferramentas, rede, última busca, saúde contínua |
GET /api/index | Snapshot JSON dos mesmos dados (totais, saúde por vendedor/indicadores de roteamento) |
/stellar · /algorand | Pá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):
| Stack | npm | Retorna |
|---|---|---|
| OpenAI function-calling (chat.completions / Assistants v2 / Responses) | agent402-openai-tools | tools[] para o parâmetro tools: |
Anthropic Messages API (tool_use) | agent402-anthropic-tools | tools[] para o parâmetro tools: |
Vercel AI SDK (streamText / generateText) | agent402-ai-sdk | Record<name, tool()> |
| LangChain JS / LangGraph | agent402-langchain | DynamicStructuredTool[] |
| LlamaIndex TS | agent402-llamaindex | FunctionTool[] |
| Strands Agents (AWS Bedrock AgentCore) | agent402-strands | StrandsTool[] para new Agent({ tools }) |
| Google ADK (Agent Development Kit) | agent402-google-adk | FunctionTool[] para agentes ADK |
| OpenAI Agents SDK | agent402-openai-agents | Agent tools para @openai/agents |
| LangChain Python / CrewAI | agent402-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.
- Página do produto · preços · instalação ao vivo: agent402.tools/tollbooth
- Tollbooth Cloud gerenciado (Solo / Team / Agency / Enterprise): agent402.tools/tollbooth/cloud - entre na lista de espera
- Execute você mesmo (MIT, npm):
npm i agent402-tollbooth·tollbooth/· tollbooth/README.md
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
| Caminho | O que |
|---|---|
src/server.js | App 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.js | Conector MCP hospedado (HTTP streamable, camada gratuita sem autenticação) |
src/pow.js | Camada de proof-of-work (challenges assinados, de uso único, escopados por slug) |
src/payments.js | Integraçã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 (
/v1chat, 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
- E-mail: mike@agent402.tools
- X / Twitter: @Agent402Tools
- GitHub: MikeyPetrillo/Agent402
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.