AgentBodega MCP

AgentBodega MCP

Dales a los agentes un menú en vivo de herramientas de pago listas para x402 de AgentBodega.

Este servidor MCP permite a los agentes descubrir endpoints de AgentBodega, comparar precios, planificar la ruta útil más económica para una tarea, inspeccionar los insumos requeridos y los formatos de respuesta, y generar llamadas HTTP x402 listas para ejecutar. Los agentes obtienen las instrucciones de compra para cada recurso sin adivinar esquemas ni extraer documentación.

Este repositorio público contiene únicamente el paquete AgentBodega MCP. La API alojada de AgentBodega se ejecuta por separado en agentbodega.store.

Lo que los agentes pueden encontrar

• Búsquedas en redes sociales y herramientas de investigación.
• Búsqueda de listados de bienes raíces.
• Estado del servicio y verificaciones de estado de la nube.
• Auditorías de dominio, preparación para el lanzamiento y descubribilidad de agentes.
• Inspección de x402, empaquetado de directorios y utilidades de artefactos alojados.

El servidor MCP no ejecuta llamadas de pago. Devuelve el contrato del endpoint, ejemplo de solicitud, requisitos de pago y fragmentos que un agente puede ejecutar contra la API alojada. L402 se expone como una superficie adicional de descubrimiento y transferencia de pago; los agentes deben tratarlo solo como descubrimiento a menos que el documento L402 en vivo reporte un emisor configurado.

Instalación

npx @agentbodega/mcp

Los clientes MCP remotos que admiten Streamable HTTP pueden conectarse directamente a:

https://agentbodega.store/mcp

Endpoint SSE:

https://agentbodega.store/mcp/sse

Entorno opcional:

AGENTBODEGA_BASE_URL=https://agentbodega.store

Habilidad de agente independiente:

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

Acceso a la red

Este paquete utiliza intencionalmente solicitudes HTTPS salientes en tiempo de ejecución para leer el catálogo en vivo de AgentBodega, el documento de descubrimiento x402, el documento de descubrimiento L402 y el contrato OpenAPI. No ejecuta scripts de instalación, no abre shells, no agrupa dependencias ni ejecuta llamadas de pago. Por defecto se conecta a https://agentbodega.store.

Claude Desktop

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

Herramientas

• agentbodega_plan_task - úsala primero cuando un agente tenga una tarea en lenguaje natural y quiera que AgentBodega elija la ruta útil más económica. Llama al planificador gratuito /api/plan y devuelve un endpoint recomendado, alternativas, insumos requeridos, ejemplos y notas de transferencia x402. Nunca ejecuta llamadas de pago.
• agentbodega_search_catalog - úsala primero para encontrar el endpoint de pago correcto. Busca en el directorio en vivo por texto, departamento/categoría/etiqueta y precio máximo en USD, y luego devuelve resúmenes de endpoints con insumos requeridos y solicitudes de ejemplo. Nunca ejecuta llamadas de pago.
• agentbodega_get_endpoint - úsala después de la búsqueda cuando conozcas una clave de endpoint, ruta, título o URL completa. Devuelve el contrato completo: método, URL, precio, insumos requeridos, esquemas, solicitud de ejemplo, salida de ejemplo y descripción larga. No llama al endpoint.
• agentbodega_call_snippet - úsala después de seleccionar un endpoint para generar solicitudes curl y JavaScript listas para editar con un marcador de posición X-PAYMENT y notas de verificación x402. No obtiene un desafío, no paga ni ejecuta.
• agentbodega_payment_guide - úsala cuando un agente necesite el modelo de pago de AgentBodega antes de realizar llamadas HTTP de pago. Explica el descubrimiento x402, el estado de transferencia L402, la liquidación, la política de saldo solo en blockchain y el curl de desafío opcional.

Recursos

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

Desarrollo

npm install
npm test