AgentBodega MCP

AgentBodega MCP

Dê aos agentes um menu ao vivo de ferramentas pagas e prontas para x402 da AgentBodega.

Este servidor MCP permite que agentes descubram endpoints da AgentBodega, comparem preços, planejem a rota útil mais barata para uma tarefa, inspecionem entradas obrigatórias e formatos de resposta, e gerem chamadas HTTP x402 prontas para execução. Os agentes obtêm as instruções de compra para cada recurso sem adivinhar esquemas ou vasculhar documentações.

Este repositório público contém apenas o pacote AgentBodega MCP. A API hospedada da AgentBodega é executada separadamente em agentbodega.store.

O Que os Agentes Podem Encontrar

• Ferramentas de pesquisa e consulta de mídias sociais.
• Busca de listagens de imóveis.
• Verificações de status de serviço e status de nuvem.
• Auditorias de domínio, prontidão para lançamento e descobribilidade de agentes.
• Inspeção x402, empacotamento de diretórios e utilitários de artefatos hospedados.

O servidor MCP não executa chamadas pagas. Ele retorna o contrato do endpoint, exemplo de solicitação, requisitos de pagamento e trechos de código que um agente pode executar contra a API hospedada. O L402 é exposto como uma superfície adicional de descoberta e transferência de pagamento; os agentes devem tratá-lo apenas como descoberta, a menos que o documento L402 ao vivo relate um emissor configurado.

Instalação

npx @agentbodega/mcp

Clientes MCP remotos que suportam Streamable HTTP podem se conectar diretamente a:

https://agentbodega.store/mcp

Endpoint SSE:

https://agentbodega.store/mcp/sse

Ambiente opcional:

AGENTBODEGA_BASE_URL=https://agentbodega.store

Habilidade de agente autônoma:

curl -sS https://raw.githubusercontent.com/agentbodegastore/agentbodega/main/agent-skills/agentbodega/SKILL.md

Acesso à rede

Este pacote usa intencionalmente solicitações HTTPS de saída em tempo de execução para ler o catálogo ao vivo da AgentBodega, o documento de descoberta x402, o documento de descoberta L402 e o contrato OpenAPI. Ele não executa scripts de instalação, não abre shells, não agrupa dependências nem executa chamadas pagas. Por padrão, ele se conecta a https://agentbodega.store.

Claude Desktop

{
  "mcpServers": {
    "agentbodega": {
      "command": "npx",
      "args": ["-y", "@agentbodega/mcp"]
    }
  }
}

Ferramentas

• agentbodega_plan_task - use primeiro quando um agente tiver uma tarefa em linguagem natural e quiser que a AgentBodega escolha a rota útil mais barata. Ele chama o planejador gratuito /api/plan e retorna um endpoint recomendado, alternativas, entradas obrigatórias, exemplos e notas de transferência x402. Ele nunca executa chamadas pagas.
• agentbodega_search_catalog - use primeiro para encontrar o endpoint pago certo. Ele pesquisa o diretório ao vivo por texto, departamento/categoria/etiqueta e preço máximo em USD, e retorna resumos de endpoints com entradas obrigatórias e exemplos de solicitações. Ele nunca executa chamadas pagas.
• agentbodega_get_endpoint - use após a pesquisa quando você souber uma chave de endpoint, caminho, título ou URL completa. Ele retorna o contrato completo: método, URL, preço, entradas obrigatórias, esquemas, exemplo de solicitação, exemplo de saída e descrição longa. Ele não chama o endpoint.
• agentbodega_call_snippet - use após selecionar um endpoint para gerar solicitações curl e JavaScript prontas para edição com um espaço reservado X-PAYMENT e notas de verificação x402. Ele não busca um desafio, não paga nem executa.
• agentbodega_payment_guide - use quando um agente precisar do modelo de pagamento da AgentBodega antes de fazer chamadas HTTP pagas. Ele explica a descoberta x402, o status de transferência L402, a liquidação, a política de saldo somente em blockchain e o curl de desafio opcional.

Recursos

• agentbodega://catalog - catálogo ao vivo compacto.
• agentbodega://x402 - documento de descoberta x402 ao vivo.
• agentbodega://l402 - documento de descoberta L402 ao vivo.
• agentbodega://openapi - documento OpenAPI ao vivo.

Desenvolvimento

npm install
npm test