ForgeMesh Utility Grid

ForgeMesh Utility Grid MCP

Um produto da ForgeMesh Labs.

Pesquise e use mais de 400 APIs práticas sem carregar centenas de ferramentas no seu agente. O Utility Grid expõe sete ferramentas MCP compactas para OCR, processamento de imagem e áudio, extração web, matemática, conversões, geodados e muito mais. A descoberta do catálogo é gratuita; a execução da API é paga por chamada em USDC na Base através do x402. Não é necessária conta ou chave de API.

Em vez de expor uma ferramenta MCP por rota (inviável nesta escala e crescente), este servidor expõe um punhado de meta-ferramentas: navegue/pesquise no catálogo ao vivo, obtenha a especificação exata de chamada de uma rota e, em seguida, chame qualquer rota genericamente. Novas rotas no serviço upstream aparecem automaticamente — nada aqui é codificado para o catálogo atual.

Início rápido (Claude Desktop / Claude Code / qualquer cliente MCP)

{
  "mcpServers": {
    "utility-grid": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/utility-grid-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

WALLET_PRIVATE_KEY só é necessário para as 3 ferramentas pagas. A descoberta funciona sem carteira alguma — pule o bloco env inteiramente para navegar e planejar chamadas gratuitamente.

Ferramentas

Ferramenta	Custo	O que faz
list_tools	grátis	Cada rota com seu preço ao vivo, além de um resumo por categoria — uma simples busca de GET /menu, sem carteira
list_capabilities	grátis	Visão geral da categoria com contagens de rotas, ou todas as rotas em uma categoria
search_capabilities	grátis	Pesquisa por palavras-chave em todo o caminho, id e descrição de cada rota
get_endpoint_spec	grátis	Preço exato de uma rota, esquema de entrada e exemplos trabalhados de requisição/resposta
call_endpoint	$0,001-$0,05	Chame qualquer rota por caminho + corpo JSON — lida com o fluxo de pagamento x402 automaticamente
daily_402	$0,001	O Daily 402: um endpoint em destaque de toda a frota ForgeMesh, rotacionado por data UTC
agent_service_directory	$0,05	Registro de todos os serviços x402 da ForgeMesh — categoria, contagem de rotas, faixa de preço

Categorias no catálogo (ilustrativo, não exaustivo)

geo (aeroportos, códigos postais, geocodificação, clima), consultas (dicionário, Bíblia, informações de países, feriados), matemática (estatísticas, matrizes, equações, geometria), utilitários (códigos QR, hash, UUIDs, parsing de telefone), visão (OCR, legendagem de imagens, remoção de fundo), áudio (TTS, transcrição, conversão de formato), tempo (fusos horários, cron, sol/lua), espaço (NASA APOD, asteroides, clima solar), web (extração de conteúdo, verificações de robots.txt/Content-Signal), registro (catálogo da frota, destaque diário), documentos (manipulação de PDF), texto (detecção de idioma, legibilidade), economia (taxas de câmbio, calculadoras financeiras), ciência, desenvolvedor, domínios, ia e diversão (fortunas, xadrez, curiosidades).

Chame list_capabilities sem argumentos para o detalhamento atual ao vivo — o catálogo cresce com o tempo e este README ficará desatualizado; a ferramenta não ficará.

Fluxo típico

1. search_capabilities({ query: "background removal" }) — grátis, encontra /remove-background
2. get_endpoint_spec({ path: "remove-background" }) — grátis, mostra o esquema de entrada exato e o preço
3. call_endpoint({ path: "remove-background", body: { image_url: "https://..." } }) — pago, faz o fluxo x402 e retorna o resultado

Ou vá direto para call_endpoint se você já conhece a rota e o formato de entrada.

Como o pagamento funciona

Sem cadastro, sem chave de API, sem assinatura. call_endpoint, daily_402 e agent_service_directory cada um aciona o mesmo fluxo: a primeira requisição retorna um desafio HTTP 402, este servidor MCP assina uma autorização de pagamento USDC (EIP-3009) na Base e tenta novamente, e o resultado chega na mesma resposta — incluindo detalhes de liquidação em _payment quando disponíveis.

API direta

Prefere HTTP puro? A superfície completa legível por agentes:

• https://x402.forgemesh.io/llms.txt — resumo de uma página para agentes
• https://x402.forgemesh.io/openapi.json — OpenAPI 3.1 com metadados de pagamento x402, esquemas de entrada completos e exemplos trabalhados para cada rota (é isso que list_capabilities/search_capabilities/get_endpoint_spec leem, ao vivo, a cada chamada)
• https://x402.forgemesh.io/.well-known/x402.json — manifesto de descoberta x402

Cards patrocinados (Lulu Ads)

list_tools é uma simples busca de GET https://x402.forgemesh.io/menu. A ForgeMesh anexa um card divulgado da Lulu Ads a essa resposta gratuita no lado do servidor, como um campo de dados rotulado simples — nunca texto que o modelo possa ler como instrução:

"sponsored": { "label": "Sponsored", "text": "...", "url": "https://..." }

Este pacote não inclui credenciais de anúncios e não faz chamadas à rede de anúncios; ele repassa o campo intacto. Ferramentas pagas nunca carregam um card. Remova-o com delete result.sponsored.

FAQ

Preciso de conta ou chave de API? Não. Os pagamentos x402 são a única credencial, e apenas para as 3 ferramentas pagas.

Qual rede e token? USDC na mainnet da Base (eip155:8453).

Isso quebrará quando o catálogo upstream mudar? Não — list_capabilities, search_capabilities e get_endpoint_spec leem /openapi.json ao vivo (com cache em memória por 5 minutos). call_endpoint nunca precisa de um esquema codificado; ele apenas encaminha seu corpo JSON.

---

Construído pela ForgeMesh Labs · Alimentado pelo protocolo x402 · Licença MIT