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: 500+ ferramentas, modelos medidos e relatórios prontos para agentes de IA
Disponível em agent402.tools.
A porta paga para agentes de IA: 500+ ferramentas, modelos medidos e relatórios prontos, pagos por chamada em USDC via x402 e MPP, ou por cartão. Código aberto, auto-hospedável, nativo MCP.
Operado por Havok Holdings LLC · Ao vivo · Por que pagar aqui · Recibos · Status · Segurança · Empresa
Experimente em 30 segundos: claude mcp add agent402 -- npx -y agent402-mcp, ou cole https://agent402.tools/mcp em qualquer cliente MCP. O nível gratuito não exige carteira. Blocos de configuração verificados para Cursor, VS Code, Windsurf, Cline, Roo Code, Codex CLI, Gemini CLI, Continue, ElizaOS e AgentCore: agent402.tools/guides/agent-hosts (atalhos agent402.sh/<host>, ex.: agent402.sh/cursor).
Quem paga: agentes pagam por chamada (a partir de $0,001; modelos medidos sob um teto cotado e liquidados pelo uso real); pessoas compram relatórios prontos ($2 a $5) e monitores ($5 por mês) por cartão; sites cobram de rastreadores com o pedágio.
O que é o Agent402
Finanças Agênticas são agentes de software pagando e recebendo por conta própria: descobrindo um serviço, pagando por requisição a partir de uma carteira por protocolos abertos (x402, MPP), recebendo um recibo verificável e ganhando por requisição em troca. O Agent402 é sua camada aplicada - explicador: agent402.tools/agentic-finance · glossário.
O que o torna diferente: o Agent402 é código aberto e auto-hospedável - e uma única integração dá ao comprador três primitivas gratuitas em todo o ecossistema x402:
- Encontrar -
/api/find?q={task}resolve uma descrição de tarefa para as ferramentas mais adequadas (rota, preço, esquema, exemplo pronto).- Roteirizar -
POST /api/routeé o Roteador Inteligente de Ordens neutro: classifica ferramentas entre todos os vendedores x402 rastreados (descobertos automaticamente no Coinbase CDP Bazaar), ciente de saúde, cominclude=externalpara nos excluir. A resposta retorna os N principais e carregamatchedpara quantos foram pontuados.- Ranking -
GET /api/leaderboardé o ranking público on-chain de vendedores x402 por volume liquidado em USDC na Base - chamadas atendidas, totalUsd, compradores únicos por vendedor. Retorna os N principais, nunca o quadro completo (25 por padrão, 50 o teto;totalSellerscarrega a contagem total). Pipeline: Bazaar →eth_getLogs→ teto por chamada → agregar porpayTo. Snapshot por hora.Além do catálogo - 500+ forte: busca/resposta como porta de entrada MCP, depois 500+ ferramentas e pacotes de habilidades selecionados (fluxos de trabalho com múltiplas ferramentas chamáveis como prompts MCP) - tudo executável por você mesmo, além de
agent402-tollbooth- um portão aberto de pagamento por rastreamento para o outro lado do x402.Duas portas, duas tabelas de preços. Agentes pagam por chamada em USDC (x402 / MPP) ou gratuitamente via prova de trabalho, e um relatório pronto custa $0,60 a $2,00 dessa forma. Pessoas pagam por cartão: os mesmos relatórios em agent402.tools/reports (dossiê de empresa, relatório de fundo 13F, fluxo de insiders, briefing de mercado, pesquisa aprofundada, recall da FDA, auditoria de domínio) custam $2 a $5, monitores que reexecutam em mudanças em /monitors custam $5 por mês, e créditos pré-pagos em /credits são uma chave
a402_que paga toda ferramenta por cartão (Authorization: Bearer a402_…, debitado por chamada bem-sucedida; suportado poragent402-mcpviaAGENT402_CREDITS_KEYeagent402-clientvia{ creditsKey }). O preço por cartão inclui processamento de pagamento. Um agente pagando por chamada paga o preço de ferramenta mais baixo pelo mesmo relatório.Dois canais de pagamento, uma URL. Todo endpoint pago aceita x402 (
PAYMENT-SIGNATURE, USDC em 12 cadeias) e MPP (Machine Payments Protocol, o esquema de autenticação HTTPPaymentem trilha IETF coautorado por Tempo e Stripe): o mesmo 402 carrega ambos, um clientemppxpaga imediatamente, e MPP liquida na Base e Celo (USDC), nativamente no Tempo (USDC.e ou PathUSD via relay do Tempo), ou por cartão via MPP (Stripestripe/charge, oferecido em rotas precificadas a partir de $0,50 quando o operador configura). O marketplace MPP lista todo vendedor MPP que conseguimos verificar ao vivo. Detalhes: O que é MPP · liquidações MPP ao vivo.
Adaptadores de framework (ferramentas plug-and-play para as principais pilhas de agentes - pagamento automático por baixo):
500+ forte - busca web ao vivo e respostas citadas como porta de entrada MCP, depois ferramentas web prontas para uso e pacotes de habilidades com múltiplas ferramentas para seu agente de IA, 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 financeiros/cripto/macro ao vivo, SEC EDGAR, estatísticas determinísticas, previsão e precificação de opções/títulos (Black-Scholes, YTM), compressão e 150+ utilitários puros de CPU. Execute você mesmo gratuitamente em 30 segundos (MCP ou
HTTP simples, sem chaves de API, sem cadastro - o nível gratuito e pagamentos x402/MPP nunca
precisam de chave; apenas os créditos pré-pagos opcionais por cartão usam uma chave bearer), conecte-o
ao Claude/ChatGPT/qualquer cliente MCP e adicione suas próprias ferramentas em poucas linhas.
Toda ferramenta utilitária é determinística - sem LLM no caminho de serviço - e
retestada contra seu próprio exemplo antes de cada lançamento. As superfícies baseadas em modelo
são explícitas e precificadas como tal: o gateway /v1 (medido sob um
teto cotado, ou níveis fixos) e os produtos de relatório prontos (/v1/research, /v1/dossier, ... abaixo).
Opcionalmente, o mesmo servidor pode cobrar por chamada via protocolo x402 (USDC na Base, Solana, Polygon, Arbitrum, Monad, Celo, Avalanche, Sei, Optimism, Stellar e Algorand, além de USDG na Robinhood Chain - 12 cadeias) - então a instância que você auto-hospeda gratuitamente também pode ser uma hospedada e monetizada. Essa parte é opcional; por padrão, tudo roda gratuitamente.
🟢 Demo hospedada: agent402.tools · 📖 Wiki · 📦 npm · 🔌 Registro MCP · 🧩 Smithery
Execute você mesmo em 30 segundos
Escolha o que melhor se adequar. Todos são gratuitos e não precisam de carteira:
1. Zero instalação - adicione o conector hospedado ao Claude (claude.ai → Configurações → Conectores → Adicionar conector personalizado):
https://agent402.tools/mcp
2. Um comando - execute o servidor MCP localmente (as ferramentas puras de CPU funcionam sem chave; ele paga a pequena prova de trabalho 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. Implantação com um clique no Railway (instância completa auto-hospedada - adiciona plugins opcionais de Postgres + Redis para análise + cache de resposta):
Inicia direto do railway.toml + Dockerfile do repositório. Plugins opcionais são detectados automaticamente via env: adicione Redis → REDIS_URL habilita o cache de resposta upstream (X-Cache: hit|miss), adicione Postgres → DATABASE_URL habilita o painel público /api/analytics e a lista de espera do pedágio. Nenhuma variável de env é necessária para iniciar em modo gratuito.
Pague por chamada a partir de uma carteira
Toda rota paga responde 402 com uma oferta x402 e desafios MPP, então qualquer cliente paga. Sem chave de API, sem cadastro: a carteira é a conta.
MPP (USDC.e ou PathUSD no Tempo, listado primeiro no 402, ou USDC na Base ou Celo) com 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 na Base e outras cadeias) com @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");
Mais: Pagando com MPP · Pagando com x402.
O que há no catálogo (500+ ferramentas)
Toda ferramenta merece seu lugar: determinística, testada contra seu próprio exemplo em cada execução de CI, precificada para o mercado, liquidada on-chain. CI mantém um piso de catálogo de 400 entradas e verifica a alegaçã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 e web | render (Chromium headless, executa JS), screenshot, extract (artigo→markdown), meta |
| Busca ao vivo e respostas | search (índice web real), search-lite (uma amostra rápida de 5 resultados), answer (resposta web com citações), variantes search-news/search-images/search-videos, search-suggest, multi-search |
| PDFs e 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 puro) |
| OCR | image-ocr (texto extraído de qualquer imagem - CPU puro, sem modelo) |
| Geo | geo-distance (haversine, CPU puro), geocode, reverse-geocode, place-search, geo-lookup |
| Dados ao vivo | fx-rate (BCE), barcode-lookup (Open Food Facts), gov-data (data.gov), weather-forecast/weather-alerts, earthquakes (USGS) |
| Finanças e cripto | stock-quote/stock-history (Databento, consolidação de quatro mercados), crypto-price/crypto-market/crypto-history/crypto-trending/crypto-global (CoinGecko) |
| Derivativos de cripto e opções | perp-markets, perp-funding, perp-funding-screener, perp-basis, perp-open-interest, perp-klines, perp-orderbook (perpetuos ao vivo: preço mark/oráculo, funding, OI, candles, profundidade); options-summary, crypto-options-chain, options-ticker, options-volume (livro de opções, IV e gregos, volume de opções on-chain) - US$ 0,001 a US$ 0,005 por chamada, sem conta em exchange |
| DeFi e stablecoins | defi-yields (filtra pools por rede, projeto, TVL e somente stablecoin), defi-yield-history, defi-protocols, defi-protocol, defi-chains, defi-chain-tvl-history, defi-fees, defi-dex-volume, stablecoins, stablecoin-supply-history - US$ 0,001 a US$ 0,003 por chamada |
| Inteligência de tokens Solana | sol-token-safety (autoridades, liquidez, concentração de detentores, classificado), sol-token-report (relatório completo de risco), sol-token-holders, sol-token-pairs, sol-token-search, sol-trending, sol-price, sol-swap-quote, sol-token-lookup - a etapa de due diligence que um agente precisa antes de tocar em uma mint |
| Cobertura do mercado cripto | crypto-news, crypto-indicators (RSI, MACD, médias móveis, calculados aqui), crypto-market-pulse, coin-profile, coin-history, coin-ohlc, coin-market-chart-range, coin-categories, coin-price-by-contract (preço por ENDEREÇO de token, sem necessidade de coin id), global-defi, exchanges, exchange-tickers, exchange-rates, coin-search, coins-list - além de ativos do mundo real tokenizados com a mesma chave CoinGecko: rwa-list, rwa-markets, rwa-asset, rwa-issuers, rwa-issuer (ações, ETFs e commodities tokenizados com dados de mercado on-chain e os emissores por trás deles) |
| Dados de cadeia indexados | asset-transfers (histórico de transferências filtrado), token-balances, token-allowance, tx-receipt (transferências decodificadas), block-receipts, token-price-history - leituras indexadas nas principais cadeias EVM, sem nó e sem chave próprios |
| 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 - busca, feeds e métricas de engajamento no grafo social on-chain |
| Rastreamento de sites | site-map (enumera as URLs de um site) e site-crawl (rastreamento em largura até markdown limpo, respeitando robots, com limites rígidos de página/profundidade/tempo) - o par determinístico por trás de qualquer tarefa de "ler este site inteiro" |
| Macro (FRED + mais) | curva de juros, tesouro, fiscal, Fed funds, CPI, desemprego, regra de Sahm, FX BCE, Banco Mundial, observações em lote do FRED |
| SEC EDGAR | ticker→CIK, lista de arquivamentos, texto de 10-K/10-Q, frames XBRL, transações de insiders, participações 13F, calendário de IPOs, busca em texto completo |
| Relatórios prontos (citados) | research/research-pro/research-max (pesquisa aprofundada fundamentada), market-brief, dossier/dossier-max (due diligence de empresas), fund-report/fund-report-max (portfólio 13F), domain-audit/domain-audit-pro (segurança classificada + entregabilidade), recall-report (FDA), insider-report (fluxo de Form 4), token-risk/token-risk-pro (risco de contrato on-chain), filing-report (último arquivamento SEC), token-brief (due diligence de mint Solana), ticker-pack (dossiê + fluxo de insiders + detentores), ipo-report (resumo de S-1 + 424B4, determinístico) - US$ 0,05 a US$ 2,00 por relatório via x402 / MPP, ou US$ 2 a US$ 5 por cartão em /reports; veja a tabela /v1 abaixo |
| Verdade de rede | dns, dns-lookup, tls-cert, whois, http-check, robots-check, email-validate, ip-info |
| Cripto e pagamentos | usdc-balance, tx-status, gas-estimate, ens-resolve, x402-quote, x402-verify, transfer-authorization - não custodial, multi-cadeia (Base/Polygon/Arbitrum/Optimism/Ethereum) |
| Memória de agente | KV com chave de carteira + TTL, contadores atômicos, concessões entre carteiras, log de auditoria com hash encadeado, recall por similaridade |
| Estatísticas e previsão | 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 puro, determinístico) |
| Compressão | gzip/gunzip, brotli-compress/brotli-decompress, compress-compare (disputa de algoritmos, CPU puro via node:zlib) |
| Extração de 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 cadeia | 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 US$ 0,001 |
| Política SQL | sql-guard (US$ 0,004 - veredito passar/avisar/bloquear 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 (US$ 0,001 - verifica esse certificado contra a instrução exata) |
| Inteligência de vendedor x402 | Três níveis na mesma pergunta, do mais barato ao mais caro. seller-trust (GET /api/x402/seller-trust, US$ 0,005) - o campo de gate do roteador, campo por campo: indexado, manifest parseado, cadeias anunciadas, chamadas liquidadas observadas, gastaríamos dinheiro de comprador lá. seller-dossier (POST /api/seller-dossier, US$ 0,05) - o registro montado: cada preço com sua proveniência, carteiras anunciadas contra as carteiras realmente pagas, evidência de liquidação por fonte, o veredito de despacho por cadeia com seu motivo, e o que aconteceu nas vezes em que nosso roteador pagou. seller-payability (POST /api/seller-payability, US$ 0,10) - compra uma chamada real agora e relata cada etapa, incluindo se o domínio EIP-712 do accept corresponde ao token que ele nomeia. Os dois primeiros são leituras offline do que já sabemos; o terceiro gasta USDC para descobrir |
| Mais de 150 utilitários de CPU puro | hashing, JWT, base58, JSON⇄CSV/YAML, token-count, text-chunk, json-validate, estatísticas de texto, matemática de cron, validadores, conversões de unidades em 13 categorias (uma ferramenta paramétrica) |
Esquemas completos estão em /openapi.json; um
catálogo legível por máquina está em /api/pricing
e /llms.txt. Não sabe qual ferramenta você precisa?
/api/find?q=<task> resolve
uma descrição de tarefa para a ferramenta certa - rota, preço, esquema e um exemplo pronto -
para que um agente pule a etapa pesada em tokens de "procurar ao redor para encontrar uma ferramenta".
Gateway LLM (/v1) - chat, embeddings, rerank, imagens, fala e relatórios prontos, pague por chamada
Aponte qualquer SDK OpenAI para base_url = https://agent402.tools/v1 e pague por chamada em
USDC via x402 ou MPP - sem chave de API, sem cadastro, sem conta (ou pague por cartão com uma
chave de créditos pré-pagos, veja Para humanos):
| Endpoint | Preço | Atende |
|---|---|---|
POST /v1/nano/chat/completions | US$ 0,003 | modelos nano - precificados para loops de agente de alta frequência |
POST /v1/auto/chat/completions | US$ 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 | US$ 0,02 | modelos de orçamento/médios (gpt-4o-mini, claude haiku, gemini flash, deepseek, llama…) |
POST /v1/pro/chat/completions | US$ 0,10 | meio-fronteira (gpt-4o, gpt-4.1, gpt-6 sol, claude sonnet, gemini pro, grok) |
POST /v1/premium/chat/completions | US$ 0,50 | fronteira (gpt-5 e gpt-6 astra, o3 e o4-mini, claude opus e claude fable 5.1) |
POST /v1/grounded/chat/completions | US$ 0,03 | o roteador automático mais uma busca web ao vivo em cada chamada - respostas carregam anotações url_citation no wire OpenAI; nunca em cache |
POST /v1/{nano,auto,pro,premium}/messages, POST /v1/messages | preço do nível | o wire Anthropic Messages em cada nível (mesma allowlist, limites e failover da rota de chat); effort (baixo a máximo) é o controle de profundidade no Claude 4.7+, Claude mais antigo aceita thinking.budget_tokens |
POST /v1/{nano,auto,pro,premium}/responses, POST /v1/responses | preço do nível | o wire OpenAI Responses em cada nível (apenas ferramentas de função, sem estado de servidor) |
POST /v1/embeddings | US$ 0,002 | embeddings OpenAI, lote de até 64 entradas - repetições idênticas são gratuitas (saída determinística, cache ativado por padrão) |
POST /v1/rerank | US$ 0,002 | rerank compatível com Cohere ({query, documents[], top_n}), até 50 documentos, cache ativado por padrão |
POST /v1/images/generations | US$ 0,08 | geração de imagens (FLUX.2 Pro, 1024x1024 PNG) - wire OpenAI images, saída base64 inline |
POST /v1/images/fast | US$ 0,02 | texto-para-imagem de orçamento, mesmo wire OpenAI images, cerca de dois segundos por imagem |
POST /v1/images/pro | US$ 0,05 | texto-para-imagem de maior fidelidade, uma imagem por chamada |
POST /v1/videos/generations | US$ 0,20 | texto-para-vídeo: um clipe silencioso de 4 segundos em 720p, MP4 base64 inline, 16:9 ou 9:16 |
POST /v1/audio/speech | US$ 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 de cinco modelos |
Streaming (stream: true), passagem completa de ferramentas/chamadas de função, um
cache de prompt opcional 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 canário, e uma
lista gratuita GET /v1/models com cada modelo e
seu nível e limites. Um canário com dinheiro real compra de cada uma dessas superfícies
diariamente - streaming, divulgação de roteamento e ambos os comportamentos de cache incluídos.
Produtos de relatórios prontos vivem no mesmo prefixo /v1: uma chamada paga retorna
um relatório completo e citado (JSON, com apêndice de fontes) em vez de uma resposta bruta de
modelo. Cada relatório é fundamentado em dados primários que o servidor busca por conta própria (arquivamentos
EDGAR, openFDA, sondas DNS/TLS, leituras on-chain, uma busca web ao vivo) antes da
síntese; ipo-report é totalmente determinístico (sem modelo algum):
| Endpoint | Preço | Relatório |
|---|---|---|
POST /v1/research · /v1/research/pro · /v1/research/max | $0,60 · $0,85 · $1,10 | relatório de pesquisa aprofundada ({query}) - multi-busca fundamentada, reordenação, síntese com citações |
POST /v1/research/market-brief | $0,85 | briefing de mercado / concorrentes ({query}) |
POST /v1/dossier · /v1/dossier/max | $0,85 · $1,10 | dossiê de due diligence de empresa ({ticker}) - registros, fluxo de insiders, web |
POST /v1/fund · /v1/fund/max | $0,60 · $0,85 | relatório de portfólio de fundos a partir do 13F mais recente ({manager}) - compras/vendas no último trimestre |
POST /v1/domain-audit · /v1/domain-audit/pro | $0,60 · $0,85 | auditoria classificada de segurança de domínio + entregabilidade ({domain}) |
POST /v1/recall-report | $0,60 | relatório de recall da FDA, medicamento/alimento/dispositivo ({query}) |
POST /v1/insider-report | $0,60 | relatório de fluxo de insiders a partir de registros Form 4 processados ({ticker}) |
POST /v1/filing-report | $0,85 | leitura e resumo do registro SEC mais recente com os fatos que moveram o mercado ({ticker}) |
POST /v1/token-brief | $0,60 | briefing de due diligence de token Solana a partir de evidências on-chain e de mercado ({mint}) |
POST /v1/ticker-pack | $2,00 | um ticker, três relatórios: dossiê, fluxo de insiders e detentores 13F |
POST /v1/token-risk · /v1/token-risk/pro | $0,60 · $0,85 | relatório de risco de token e contrato a partir de evidências on-chain ({address, chain}) |
POST /v1/ipo-report | $0,05 | resumo do pipeline de IPOs, S-1 + 424B4 via busca em texto completo do EDGAR ({days, keyword}), determinístico |
Os relatórios são exclusivos para carteiras (x402 / MPP / créditos pré-pagos, nunca proof-of-work) e levam alguns minutos para serem gerados. Os mesmos relatórios são vendidos a pessoas por cartão em agent402.tools/reports por $2 a $5, dependendo da profundidade. O preço no cartão inclui processamento de pagamento; um agente pagando por chamada via x402 ou MPP paga o preço de ferramenta mais baixo pelo mesmo relatório.
Duas ferramentas complementares fecham o ciclo: POST /api/route/execute ($0,01, com
camadas execute-plus de $0,05 e execute-max de $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 (ela roteia com base em volume liquidado on-chain comprovado,
com uma exceção - um vendedor Solana sem histórico ainda é tentado apenas
depois de todos os candidatos comprovados, sob um pequeno teto por chamada, e sinalizado
como não comprovado no recibo - paga a eles em seu nome na chain em que você pagou -
Base ou Algorand - e retransmite o resultado; veja o
guia do 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.
Para humanos: relatórios, monitores e créditos pré-pagos
O mesmo catálogo tem uma porta de entrada para pagamento com cartão (Stripe Checkout; o operador
a habilita com STRIPE_SECRET_KEY, caso contrário essas páginas simplesmente não são montadas):
| Página | O que você recebe |
|---|---|
| agent402.tools/reports | Compre qualquer relatório finalizado da tabela acima com cartão (POST /api/buy) por $2 a $5 (as camadas mais profundas e o pacote de tickers ficam no topo dessa faixa; preços atuais na página), entregue em /r/<session> - sem carteira, sem conta. O preço no cartão inclui processamento de pagamento; um agente pagando por chamada paga o preço de ferramenta mais baixo pelo mesmo relatório. Um relatório é gerado apenas contra uma sessão paga verificada pelo Stripe, uma vez; uma geração com falha é reembolsada automaticamente. |
| agent402.tools/monitors | Assinaturas de $5/mês que reexecutam um relatório quando algo muda e enviam por e-mail: monitor de segurança de domínio (re-sonda diária gratuita, reexecução paga completa em mudança de segurança, um certificado dentro de 14 dias do vencimento, ou a cada 30 dias), vigilância de registros SEC (novo registro), vigilância de segurança de token Solana (fatos de segurança alterados), vigilância de 13F de fundos (novo registro), vigilância de recall da FDA (novo número de recall), vigilância de fluxo de insiders (novo Form 4), vigilância do pipeline de IPOs (resumo semanal). Relatórios chegam em /m/<id>; gerencie ou cancele pelo Stripe Customer Portal em /monitors/manage. |
| agent402.tools/credits | Créditos pré-pagos em pacotes de $20 / $50 / $100. Você recebe uma chave a402_… (mostrada uma vez na página de agradecimento e enviada por e-mail); envie-a como Authorization: Bearer a402_… em qualquer rota com preço e a chamada é paga pelo saldo - debitada apenas em resposta bem-sucedida, micro-dólares inteiros para que preços abaixo de centavos sejam exatos, nunca expira. GET /api/credits/balance (mesmo cabeçalho) lê o saldo; um 402 com {reason, balanceUsd, topup} significa saldo insuficiente. Ferramentas vinculadas a identidade (/api/memory*, my-usage) recusam créditos porque o pagamento é a identidade ali; pague essas via trilho x402. |
A chave de créditos é compreendida pelos SDKs: agent402-mcp lê
AGENT402_CREDITS_KEY e agent402-client aceita { creditsKey }, então um agente
sem carteira ainda pode chamar toda ferramenta exclusiva para carteira com cartão.
Pacotes de habilidades - 70+ fluxos de trabalho com múltiplas ferramentas
Para trabalhos que abrangem várias ferramentas - "auditar um domínio", "diagnosticar entregabilidade",
"elaborar uma série temporal", "desvendar 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 catalog.search (a ferramenta de busca do conector hospedado; o nome mais antigo search_tools ainda funciona como alias) retorna o pacote correspondente junto com ferramentas individuais.
| Pacote em destaque | Chains | 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 em qualquer série temporal |
structured-scrape | extract · render · html-select · html-table · html-strip · html-links · html-meta | Árvore de decisão de scraping determinística |
decode-blob | jwt-decode · gunzip · brotli-decompress · base64 · hex · json-format · hash | Identificar e desvendar 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 de serviço |
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 de
/api/find: primitivas de descoberta não deveriam custar dinheiro.
| Superfície | O que é |
|---|---|
GET /api/find?q={task} | Resolver uma tarefa para as ferramentas com melhor correspondência (rota, preço, schema, exemplo pronto) |
POST /api/route | Smart Order Router: { query, top, include } → ferramentas classificadas entre vendedores (pontuação de correspondência, depois saúde, depois preço; um modelo de julgamento então move a listagem que realmente faz a tarefa para o topo, a mais barata entre igualmente boas, reportada em judged). include=external exclui o próprio Agent402 |
GET /api/leaderboard | Classificação on-chain de vendedores x402 por volume liquidado em USDC na Base (callsSettled, totalUsd, uniqueBuyers por vendedor). Apenas Top N - 25 padrão, teto de 50, totalSellers para a contagem completa. Pipeline: Bazaar → eth_getLogs → teto por chamada → agregação. Snapshot a cada hora |
/marketplace | Dashboard HTML público: cada vendedor, contagem de ferramentas, rede, última busca, saúde contínua |
GET /api/index | O índice de vendedores como JSON (totais, sinalizadores de saúde/roteável por vendedor). Paginado - uma página de no máximo 250, complete: false e um cabeçalho Link com rel="next" enquanto houver mais, sellerCount para o total. Uma origem, sem paginação e com seu histórico de rastreamento: ?seller=<host> |
/stellar · /algorand | Páginas de marketplace por chain: vendedores e ferramentas liquidando nesse trilho especificamente |
# "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'
O despacho é rotulado, nunca implícito: cada linha de /api/route e vendedor de /api/index
carrega routerDispatchEligible e routerDispatchReason (crawl_failed,
network_unknown, settlement_required, settlement_checked_at_pay_time,
eligible, ...); executeVia aparece apenas em uma linha que o roteador pagará agora
(executeViaCallableNow: true), caso contrário a camada muda para
executeViaWhenEligible. routable é prontidão de rastreamento, nunca uma promessa de pagamento.
Uma rota com preço no manifesto também é lida ao vivo uma vez e depois semanalmente, para que as chains
que seu 402 realmente oferece cheguem à linha mesmo quando o manifesto do vendedor está atrasado.
Ciente da saúde: vendedores cujas últimas buscas 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 pontuação de correspondência e preço iguais, então vendedores instáveis-mas-baratos perdem para confiáveis. Vendedores totalmente novos (sem histórico ainda) recebem o benefício da dúvida.
Adequação julgada: a pontuação lexical recompensa uma listagem cujo nome repete as palavras da tarefa, então vinte rotas estreitas de um vendedor podem superar uma ferramenta geral que faz o trabalho. Um modelo de julgamento agora lê uma lista curta - no máximo duas linhas por vendedor, mais as melhores correspondências do catálogo local - e move a listagem que realmente faz a tarefa para o topo; quando várias fazem igualmente bem, a mais barata vence. Ele nunca adiciona um vendedor que o portão de liquidação não admitiu, pode dizer "nenhum desses" (route-execute então recusa antes que qualquer coisa seja paga), e falha aberto para a ordem lexical. As próprias ferramentas ainda não executam modelo; isso é apenas como o roteador escolhe.
Operadores obtêm atribuição de 3 trilhos no dashboard (/api/stats,
/__operator, com token - responde 404 sem o token do operador): tráfego USDC vs. proof-of-work vs.
sonda de heartbeat são contados separadamente - e o trilho de heartbeat é limitado
por um token assinado por POW_SECRET (não um User-Agent falsificável), então a visão
do operador reflete 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 rastreamento na frente de um site que ainda não é nativo 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 novas 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" });
// no wallet? pay wallet-only tools by card with a prepaid credits key from /credits
const b = new Agent402({ creditsKey: "a402_..." });
Conecte ao seu framework de agente (adaptadores sem dependências)
Se você já está em uma das stacks abaixo - OpenAI, Anthropic, o Vercel AI SDK, LangChain (JS ou Python), LlamaIndex, Strands, Google ADK, ou o OpenAI Agents SDK - pule a configuração: existe um pacote drop-in que transforma o catálogo do Agent402 em objetos de ferramenta nativos para o seu framework, com pagamento tratado por baixo dos panos (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 |
| Coinbase AgentKit (CDP, Privy, ZeroDev, carteiras viem) | agent402-agentkit | um ActionProvider para AgentKit.from({ actionProviders }) |
| 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 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 chains aceitas, ou proof-of-work gratuito) e chamar qualquer uma das 500+ ferramentas e 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 schema publicado, exposta via MCP e coberta pelo
check 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
somente 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 puro falha fechado,
saindo a menos que WALLET_ADDRESS esteja definido - rodar sem pagamentos é o
opt-in explícito (FREE_MODE=true npm start). Para cobrar, defina WALLET_ADDRESS
- chaves de 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:
Cada 402 é válido sob os próprios schemas de @x402/core (no máximo cinco tags, verificados por CI
em todas as rotas) e carrega um schema de saída tipado duas vezes: na extensão de descoberta bazaar
e como accepts[0].outputSchema no primeiro accept, para que um cliente que
leia o campo da spec veja a forma da resposta 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" }),
});
MPP dual-stack. O paywall também fala MPP (Machine Payments Protocol -
o esquema de auth HTTP Payment em trilha IETF de tempoxyz/mpp):
o mesmo 402 carrega um desafio WWW-Authenticate: Payment, Authorization: Payment credentials settle, and settled responses return a Payment-Receipt.
MPP tem dois métodos aqui: evm liquida de forma idêntica ao x402 (EIP-3009 USDC,
mesmo facilitador, mesmo preço); tempo liquida nativamente via
relay próprio do Tempo (TIP-1034/TIP-20, sem facilitador x402
envolvido) - um caminho de liquidação genuinamente separado, defina TEMPO_API_KEY para
ativá-lo. Um cliente mppx funciona
pronto para qualquer um dos métodos; defina MPP_SECRET_KEY para ativar o shim na sua
própria instância. Mesma URL de qualquer forma - o cliente do comprador escolhe o dialeto.
Agentes sem carteira ainda usam toda ferramenta 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 MPP · Pagando com Compute.
Por que pagar aqui - sete coisas que são diferentes
Cada afirmação aponta para a superfície que a prova (a versão de uma página: agent402.tools/why).
- Pague pelo que o modelo usou, com o teto cotado primeiro. O gateway medido (
POST /v1/metered/chat/completions) cotiza cada 402 a partir do próprio corpo da requisição; uma carteira pagandouptoliquida o uso real sob esse teto, descontos de provedor como leituras de prompt-cache são repassados, e cada resposta x402 ou MPP liquidada carrega um recibo. - Uma chamada com falha não é cobrada, e a resposta prova isso. A liquidação roda após o handler e um status de erro a cancela, então uma resposta sem recibo de pagamento, ou um recibo marcado como
success:false, não moveu dinheiro; uma nova tentativa com o mesmoIdempotency-Keye a mesma credencial de pagamento reproduz a resposta paga em vez de pagar de novo; o único caso residual (um recibo liquidado em uma resposta de erro) é detectado pelo nosso próprio alarme e registrado como dívida em um ledger de reembolso, nunca baixado silenciosamente. - Uma chave compra tudo. A mesma carteira ou chave de créditos paga por cinco níveis de LLM em três wires (OpenAI chat, OpenAI Responses, Anthropic Messages), embeddings, rerank, imagens, vídeo, fala, transcrição, respostas fundamentadas com citações, 500+ ferramentas, memória chaveada por carteira e relatórios finalizados.
- Nenhuma carteira necessária. Créditos pré-pagos por cartão, cartões via MPP e checkout por cartão para relatórios ficam ao lado de USDC ou USDG em doze chains e MPP nativo no Tempo.
- Trabalho finalizado, pronto para usar. Dossiês, fluxo insider, participações 13F, relatórios de arquivamento, digests de IPO, auditorias de domínio, risco de token, pesquisa profunda, briefs de mercado, monitoramento de recall e um pacote de artigos para LinkedIn, fundamentados em fontes primárias com apêndice de dados; monitores sondam diariamente de graça e re-executam o relatório pago quando os fatos mudam.
- Compramos em seu nome.
POST /api/route/executeresolve uma tarefa para o melhor vendedor no ecossistema, paga a eles da nossa carteira e retransmite o resultado sob um único recibo. Vendedores são roteáveis em liquidação on-chain comprovada, com uma exceção limitada para um vendedor Solana sem histórico sob um pequeno teto por chamada. - Tudo é verificável. Uptime observado por duas sondas fora da produção (
/status), uma canário com dinheiro real através de cada trilho diariamente, transações publicadas por trilho e wire (/revenue), código aberto e auto-hospedável. As ferramentas determinísticas não rodam modelo; as que rodam são nomeadas (os níveis /v1, os produtos de relatório e as ferramentas de imagem, fala, transcrição, embedding e resposta de IA). O operador é identificado on-chain: Agent402 é o agente 94639 no ERC-8004 Identity Registry na Base, resolvendo para/.well-known/agent-registration.json, com um cartão de agente A2A em/.well-known/agent-card.json.
Por que é sólido
- Tudo é testado - CI chama todas as 500+ ferramentas com seus próprios exemplos
documentados e bloqueia o release 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 elas observam é público em
/status- onde um dia sem observação lê "sem dados", nunca uptime, porque uma queda é 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.
- Utilitários determinísticos - nenhum modelo no caminho de serviço das ferramentas utilitárias, então a mesma entrada sempre dá a mesma saída, com schemas OpenAPI completos.
- Receita auditável, on-chain - toda chamada paga liquida em USDC para
agent402.base.eth(um nome na Base resolvendo para a carteira receptora pública) - verificável por qualquer pessoa no Basescan; contagens ao vivo em/api/stats. - Licenciado AGPL-3.0, amigável a auto-hospedagem - clone, remova o que não precisa, adicione o que precisar.
Agent402 no ecossistema x402
x402 é um protocolo de pagamento aberto construído sobre HTTP 402 Payment Required para pagamentos máquina-a-máquina, pay-per-call em stablecoins (USDC).
A maioria dos projetos no espaço é protocolo + SDKs,
um template inicial ou um facilitador de pagamento. Agent402 é a camada aplicada -
um servidor x402 pronto para rodar que já fala o protocolo e entrega 500+
ferramentas funcionais, para que você não precise construir o catálogo sozinho.
- Quer o protocolo ou um SDK? → coinbase/x402.
- Quer um servidor que você pode rodar hoje que realmente faz 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 a própria chave e não mantemos saldo de cripto para ele; créditos pré-pagos por cartão são um saldo retido e são nomeados como tal).
Listado no Registro MCP oficial e descobrível no x402 Bazaar da Coinbase.
Funciona com AWS Bedrock AgentCore Payments pronto para uso - AgentCore orquestra x402, que é o protocolo que o Agent402 já fala. Aponte o AgentCore Gateway 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 - pay-per-crawl para seu site (o outro lado do x402)
Cobre crawlers de IA que acessam seu site. Humanos navegam de graça; 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
- Rode você mesmo (MIT, npm):
npm i agent402-tollbooth·tollbooth/· tollbooth/README.md Roda como middleware Express, middleware Edge do Next.js / Vercel, um Worker do Cloudflare, um proxy reverso ou um plugin WordPress (beta). Modelos prontos para uso emtollbooth/deploy/. Um núcleo Web-Crypto alimenta todos eles. Desde 0.9.x o gateway também fala MPP nativamente: entregue a ele seu middleware@x402/express(createTollbooth({ x402 })) e ele gera desafiosWWW-Authenticate: Paymentevm a partir do mesmo 402, ou forneça uma chave de relay Tempo (createTollbooth({ tempo: { apiKey, recipient, currency, splits } })) e ele liquida credenciais MPPtempo/chargeno Tempo com pagamentos divididos opcionais, sem nenhum middleware x402. Desde 0.10.0 o build edge também fala MPP: comsecret,payToe seu callbackverifyX402configurado, cada 402 carrega um desafioWWW-Authenticate: Paymentao lado da cotação x402, e uma credencialAuthorization: Payment(vinculada por HMAC a esse desafio, não expirada, cunhada para exatamente esse recurso) é traduzida paraPAYMENT-SIGNATUREe entregue ao mesmo verificador.
Mapa do repositório
| Caminho | O quê |
|---|---|
src/server.js | Aplicativo Express + o catálogo de ferramentas (rotas, preços, schemas, descoberta) |
src/tools/ | Os kits de ferramentas (web, PDF, mídia, imagens, dados ao vivo, cripto/x402, 150+ 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 prova de trabalho (desafios assinados, de uso único, com escopo por slug) |
src/payments.js | Integração opcional x402 v2: USDC em Base/Solana/Polygon/Arbitrum/Monad/Celo/Avalanche/Sei/Optimism/Stellar/Algorand + USDG na Robinhood Chain (12 redes), facilitador CDP, descoberta Bazaar |
src/mpp-shim.js, src/mpp-tempo.js, src/mpp-stripe.js | MPP nas mesmas rotas: desafios/credenciais Payment traduzidos para x402 (evm), liquidação nativa via relay do Tempo, e cartões Stripe via MPP |
src/x402-index.js | Índice x402 + Roteador Inteligente de Ordens: rastreamento entre vendedores, descoberta automática, roteamento ciente de saúde, páginas de marketplace por rede (/stellar, /algorand) |
src/sell.js | /sell - a porta de entrada do vendedor: listagem gratuita de autoatendimento (POST /api/index/register) ou agent402-tollbooth para pagamento por rastreamento |
src/human-checkout.js | Porta de entrada de cartão para os produtos de relatório: /reports (página em src/human-reports-page.js), POST /api/buy, entrega em /r/:sessionId (Stripe Checkout, geração única, reembolso automático em falha) |
src/stripe-subscriptions.js | /monitors - assinaturas de monitoramento por US$ 5/mês (MONITOR_PRODUCTS: domínio, registro, token, fundo, recall, insider, ipo), webhook com verificação de assinatura, Portal do Cliente |
src/monitor-scheduler.js | Cumprimento dos monitores: sondas diárias baratas, re-execuções pagas em mudanças, entrega por e-mail, relatórios em /m/:id |
src/credits.js | Créditos de cartão pré-pagos: chaves de portador /credits, a402_, o gateway autorizar-depois-debitar na frente de cada rota precificada |
mcp/ | O pacote npm agent402-mcp (servidor MCP stdio) |
client/ | O SDK do comprador agent402-client (find() + call() com pagamento automático) |
tollbooth/ | O gateway de pagamento por rastreamento 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 wiki do GitHub (sincronizado por CI) |
scripts/ | Testes, demos, ferramentas de operações |
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 do gateway 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 e fornecido como está; cada pacote npm publicado é MIT com seu próprio arquivo LICENSE em seu diretório:
agent402-mcp(mcp/),agent402-client(client/),agent402-tollbooth(tollbooth/),agent402-openclaw(openclaw/),agent402-agentkit(adapters/agentkit/),elizaos-plugin-agent402(adapters/eliza/) e o facilitador (facilitator/). O selo de licença no nível do repositório do GitHub reporta o AGPL do servidor; o campolicensede um pacote e o LICENSE de seu diretório são o que se aplica a esse pacote. 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ê auto-hospedar, 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
Contribuindo
PRs que adicionam ferramentas úteis, corrigem bugs ou melhoram a documentação são muito bem-vindos - veja CONTRIBUTING.md. Servidor AGPL-3.0, cada pacote publicado MIT (veja Legal acima). Mantido por Havok Holdings LLC.