Agent Utilities MCP

35 APIs pré-pagas para HTML, JSON, dados de compras e configuração de agentes, com descoberta gratuita por meio de um adaptador MCP local em Node.js.

GitHubExperimente este MCPPatrocinado

Documentação

Agent Utilities MCP

Conecte um cliente MCP stdio local a 36 APIs utilitárias pagas para extração de HTML, validação de JSON, verificações de configuração de agentes e dados de produtos. Este adaptador licenciado sob MIT é executado localmente; a API hospedada é um serviço pago.

Catálogo de ferramentas · Guia de instalação · Preços · Políticas e suporte

Usuários do VS Code: abra o link de configuração e a configuração da chave privada. Instruções detalhadas estão incluídas neste repositório de origem.

Pague por chamada com USDC

Para agentes com saldo no Circle Gateway, um cliente USDC independente suporta pagamentos na mainnet da Base sem um pacote Stripe de $5. Baixe e visualize o exemplo. Ele fixa rede e contratos, limita cada chamada e salva solicitações assinadas de forma privada para recuperação. A visualização é offline; a preparação e o envio exigem comandos explícitos separados. A execução real gasta USDC real. Este cliente é separado do adaptador MCP financiado por Stripe e não está incluído no lançamento imutável MCPB 0.3.0.

Experimente o exemplo de compras sem conta

Clone este repositório e visualize o carrinho fornecido com Node.js 22+:

cd examples/cart
shasum -a 256 -c cart-workflow.mjs.sha256
node cart-workflow.mjs --preview cart-example.json

A visualização valida a entrada e imprime o plano de três etapas offline, sem chave de API, solicitação de rede ou cobrança. Ela não executa as ferramentas. A saída esperada incluída é um fixture local: strings de preço em alemão tornam-se valores decimais, patches protegidos atualizam o snapshot do carrinho fornecido e a reconciliação de custos retorna um total conhecido de €45,92. O imposto é desconhecido, então o total final permanece null.

Para executar essas três operações contra o serviço hospedado, defina AGENT_UTILITIES_API_KEY de forma privada no ambiente do seu processo e escolha explicitamente:

node cart-workflow.mjs --execute cart-example.json

A execução gasta créditos de serviço existentes. A receita impõe limites de preço por chamada totalizando no máximo $0,0013 (0,13 centavos) em suas três chamadas lógicas. Ela para se um preço descoberto for muito alto ou se um preço posterior exceder o limite autorizado. Etapas concluídas permanecem cobradas se uma etapa posterior falhar. Cada etapa retorna seu recibo de débito e informações de recuperação; não reexecute a receita inteira após uma resposta incerta. Leia as instruções da receita antes da execução. Este exemplo não compra créditos nem faz um pedido de comerciante.

A receita é um download independente separado, não parte do pacote MCPB imutável v0.3.0. Você também pode obtê-la na página de fluxo de trabalho. O comportamento de gastos do adaptador MCP genérico permanece conforme descrito abaixo.

Leia o material diretamente de um agente

Nenhuma conta ou chave é necessária para ler contratos, exemplos, preços e guias:

curl --fail --silent --show-error \
  https://agent-utilities.agent-utilities.workers.dev/v1/content/index?utm_source=github

Conteúdo JSON completo: esquemas de entrada/saída de ferramentas, solicitações de exemplo, cabeçalhos de execução, fluxos de trabalho e documentação.
Guia de texto completo: o mesmo material como texto simples.
Contrato de uma ferramenta: esquema de solicitação, exemplo, preço e URL de execução.
Fluxo de trabalho do carrinho: as etapas e o preço agregado atual.
OpenAPI: operações de ferramentas HTTP, cabeçalho opcional de limite de crédito e respostas de erro.

Esses endpoints GET públicos suportam leituras de navegador entre origens. A execução de ferramentas permanece paga. Clientes HTTP personalizados podem enviar X-Max-Credit-Micro-Usd para limitar um novo débito de crédito pré-pago; leia o quickstart para semântica de nova tentativa. O adaptador 0.3.0 limita cada nova chamada ao preço do catálogo na inicialização e exige suporte anunciado pelo servidor.

Prefere Python?

O cliente HTTP Python usa apenas bibliotecas padrão do Python 3.10+. Veja examples/python para visualização offline, descoberta gratuita e chamadas pagas explícitas com limites por chamada e identidades de nova tentativa estáveis. Nenhum processo Node ou MCP é necessário para esta rota. Ela é separada do pacote MCPB.

Instalação

Também listado no Smithery como um pacote MCPB Node.js local. Seu download corresponde ao artefato GitHub v0.3.0. Conecte o adaptador para os esquemas e preços completos atuais das ferramentas; os metadados do diretório são um resumo de descoberta.

Para clientes que suportam pacotes MCPB, baixe agent-utilities-mcp-0.3.0.mcpb e sua soma de verificação do lançamento v0.3.0. Verifique a soma de verificação antes de importar o pacote pelas configurações de extensão do seu cliente. Ele contém o adaptador, manifesto e avisos de licença. O pacote não é assinado; a soma de verificação do lançamento estabelece consistência de arquivo, não uma assinatura independente. O esquema do pacote e a execução independente são testados; a instalação em cada cliente desktop não é verificada.

A configuração opcional de chave de API do Agent Utilities do pacote é marcada como sensível. Deixe-a vazia para descoberta gratuita, ou insira apenas sua chave de API para habilitar chamadas pagas. Node.js 22+ é necessário; use um runtime compatível fornecido pelo seu cliente ou instalado localmente. Se o seu cliente não puder importar arquivos MCPB, use a configuração manual abaixo.

Requer Node.js 22 ou mais recente. Baixe agent-utilities-mcp.mjs e seu arquivo .sha256 do guia de instalação e verifique o arquivo a partir de sua pasta:

shasum -a 256 -c agent-utilities-mcp.mjs.sha256

Alternativamente, clone este repositório e use seu agent-utilities-mcp.mjs incluído diretamente. Nenhum npm install é necessário para executar o pacote. O código-fonte está em src/; npm ci && npm run build o reconstrói. O pacote público é testado como um processo independente fora da árvore de dependências do aplicativo.

Para um cliente que usa o formato de configuração comum mcpServers:

{
  "mcpServers": {
    "agent-utilities": {
      "command": "node",
      "args": ["/absolute/path/agent-utilities-mcp.mjs"],
      "env": {
        "AGENT_UTILITIES_API_KEY": "YOUR_PRIVATE_API_KEY"
      }
    }
  }
}

Substitua o caminho do arquivo. Configure a chave de API de forma privada usando as configurações secretas do cliente onde suportado; nunca comprometa uma chave real ou cole-a em um prompt de agente. Use o caminho absoluto para Node se o cliente não puder encontrá-lo. Clientes MCP somente remotos não podem iniciar este adaptador stdio.

Omita a chave para descobrir ferramentas sem gastar créditos. Obtenha uma chave de API e uma chave de recuperação salva separadamente no workspace. Dê apenas a chave de API ao adaptador. O modo ao vivo vende créditos de serviço pré-pagos de $5 USD. Verifique o modo exibido antes de comprar.

O que ele faz

Busca as definições públicas de ferramentas e os preços atuais por chamada na inicialização.
Expõe as 36 ferramentas de serviço e um auxiliar de recuperação. O auxiliar de recuperação não é um produto adicional.
Envia chamadas autenticadas apenas para a origem fixa do Agent Utilities; redirecionamentos são rejeitados.
Gera um ID de solicitação de débito estável e tenta novamente uma troca HTTP falhada com corpo e ID idênticos.
Mantém identidades de solicitação e hashes de entrada na memória do processo, sem registrar entradas, resultados ou credenciais. O manuseio de dados remotos é descrito nas políticas de serviço.
Não compra créditos, não recarrega automaticamente, não acessa uma carteira nem aceita credenciais de recuperação.

Experimente uma tarefa útil como: "Use commerce_gtin_validate para verificar o código de barras 036000291452." Uma chamada bem-sucedida custa $0,0003. Os preços atuais das ferramentas variam de $0,0003 a $0,002; estes são preços experimentais, não fixos para sempre. Cada nova operação gasta créditos. A versão 0.3.0 limita cada novo débito ao preço descoberto na inicialização. Não há orçamento total de sessão; chamadas novas repetidas podem gastar o saldo disponível. Um preço de servidor mais alto retorna HTTP 412 em vez de aumentar o limite. Reinicie apenas após revisar os preços atualizados. Revise os preços e aprove os gastos no seu cliente.

Repita um resultado incerto

Resultados e desfechos incertos incluem um requestId. Chame agent_utilities_retry com esse ID, o nome original da ferramenta MCP e os argumentos originais:

{
  "requestId": "COPY_THE_RETURNED_REQUEST_ID",
  "name": "commerce_gtin_validate",
  "arguments": { "code": "036000291452" }
}

Dentro de dez minutos, uma solicitação concluída retorna o resultado salvo sem outro débito. Na versão 0.3.0, o auxiliar de recuperação envia um limite zero: uma solicitação que nunca chegou ao serviço é rejeitada sem uma nova reserva. Isso não cancela uma reserva anterior nem reembolsa uma cobrança. A nova tentativa automática de transporte de uma nova chamada mantém seu limite original diferente de zero e ainda pode executar essa operação autorizada uma vez. Não gere um novo ID nem altere a entrada para recuperar um resultado incerto. Identidades de solicitação expiradas não podem fazer outro débito. Reutilizar um ID de solicitação MCP dentro de um processo também mantém sua identidade de débito original.

Após um reinício de processo, você precisa do ID de solicitação retornado e da entrada original para recuperação. Se o processo morreu antes de seu cliente receber o ID, inspecione o saldo ou entre em contato com o suporte antes de repetir a operação. Nenhum histórico durável local de entrada ou resultado é armazenado. Cada processo retém até 5.000 identidades de solicitação MCP e então recusa novas chamadas até reiniciar; conclua a recuperação pendente primeiro.

Limites de serviço

O lançamento permite 1.000 novas chamadas pagas por dia em todo o serviço. As entradas são limitadas a 128 KiB incluindo sobrecarga de protocolo. As ferramentas de rede são restritas aos hosts mostrados no catálogo; elas não são um navegador web geral. As verificações de segurança são heurísticas. Resultados bem-sucedidos são criptografados para recuperação de nova tentativa de dez minutos, com tombstones de solicitação retidos por um dia. Veja as políticas para detalhes de retenção e reembolso.

Testes automatizados verificam a recuperação de resposta perdida contra um ledger de crédito Cloudflare local. Eles não estabelecem demanda do cliente nem comprovam uma compra de cliente real. Validação de diretório e descoberta gratuita de ferramentas não são vendas.

Licença

Código do adaptador: MIT. Dependências incluídas: veja THIRD-PARTY-NOTICES.txt. A licença cobre o adaptador, não o acesso gratuito às APIs hospedadas.

Escolha pacotes inteiros para uma tarefa de compras

O planejador de pacotes encontra o subtotal mínimo de itens para uma quantidade necessária de itens intercambiáveis usando limites de pacote explícitos. Doze itens podem custar $15,98 como dois pacotes de seis a $7,99, mesmo quando um pacote de dez a $11,99 tem um preço unitário menor. A operação custa $0,0008 em créditos pré-pagos. Frete, impostos, cupons e equivalência de produtos estão fora de sua otimização.

Chame commerce_pack_plan via MCP, ou use o cliente Python com o ID de ferramenta commerce.pack-plan e um limite explícito de 800 micro-dólares. Inspecione o contrato JSON gratuito antes de executar. O fluxo de trabalho trabalhado explica limites de estoque e como as contagens de pacotes mapeiam na reconciliação do carrinho. O adaptador descobre esta ferramenta do serviço; novas ferramentas não exigem substituir o adaptador.

Experimente o exemplo de planejamento de pacotes em Python com seus três casos de amostra. Execute python3 pack_plan_example.py de examples/python, ou selecione --scenario limited-stock / --scenario insufficient-stock. O padrão é uma exibição offline de fixtures fixos; ele não envia solicitação nem calcula uma nova resposta. Adicionar --execute autoriza explicitamente uma chamada hospedada limitada a $0,0008 usando créditos existentes. Um resultado inviável válido também é cobrável. Veja o guia Python para somas de verificação, limites de entrada e recuperação antes de executar. Cada nova execução cria um novo ID; não reexecute para recuperar um resultado pago incerto.

Atualizando da versão 0.2.1

Instale 0.3.0 para limites de preço por chamada e novas tentativas manuais somente de recuperação. A versão 0.2.1 não aplica essas proteções do adaptador. Os bytes existentes do lançamento 0.2.1 permanecem disponíveis e inalterados; atualizar exige substituir o adaptador instalado. O limite por chamada não limita o número de novas chamadas nem fornece um orçamento total de sessão.

Compare totais de checkout entregues

A receita Python de biblioteca padrão em examples/python/compare_carts.py compara snapshots de checkout de comerciante fornecidos usando uma reconciliação limitada por carrinho. A visualização padrão é offline; a execução requer --execute e créditos existentes. Ela classifica totais completos, mantém empates e se recusa a nomear um vencedor geral quando qualquer carrinho tem frete, impostos ou taxas desconhecidos. O limite padrão de dois carrinhos é $0,001. Veja o guia de comparação para entradas de amostra, somas de verificação, orçamentos explícitos e recuperação.