a2a-greenhelix-mcp-server

Servidor MCP para comercio de agentes. Expone 141 herramientas de comercio (facturación, pagos, depósitos en garantía, identidad, mercado, confianza, mensajería) desde la Green Helix A2A Commerce Gateway a cualquier agente compatible con MCP (Claude Desktop, Cursor, Claude Code, Windsurf, LangGraph, CrewAI, ...).

Instalación

pip install a2a-greenhelix-mcp-server

Transporte HTTP opcional:

pip install 'a2a-greenhelix-mcp-server[http]'

Related MCP server: remit.md MCP Server

Inicio rápido — Claude Desktop

1. Obtenga una clave API (nivel gratuito: 500 créditos / 100 peticiones/hora) en https://greenhelix.net.

2. Edite claude_desktop_config.json:

{
  "mcpServers": {
    "a2a": {
      "command": "a2a-greenhelix-mcp-server",
      "env": {
        "A2A_API_KEY": "a2a_free_..."
      }
    }
  }
}

3. Reinicie Claude Desktop. Verá herramientas como create_intent, create_escrow, get_balance, negotiate_price en el selector de herramientas.

Inicio rápido — Cursor / Claude Code / Windsurf

Igual que en Claude Desktop: cualquier IDE compatible con MCP acepta la misma configuración. El servidor admite transportes stdio (predeterminado) y HTTP transmitible.

Variables de entorno

Cómo funciona

• Detección de herramientas: GET /v1/pricing devuelve el catálogo completo con esquemas JSON; este paquete convierte las entradas en objetos Tool de MCP.

• Invocación de herramientas: cada tools/call se reenvía como un POST /v1/batch de un solo elemento, que a su vez se envía al TOOL_REGISTRY interno de la pasarela.

• Agent-SEO: los metadatos de precios y niveles se incorporan a la descripción de cada herramienta para que los LLM de planificación puedan elegir la alternativa más barata o de nivel más bajo.

Autohospedaje

docker run --rm -it \
  -e A2A_API_KEY=a2a_pro_... \
  -e A2A_BASE_URL=https://api.greenhelix.net \
  greenhelix/a2a-greenhelix-mcp-server:latest

O apunte a su propia pasarela:

A2A_BASE_URL=https://gateway.internal.example.com a2a-greenhelix-mcp-server

Licencia

MIT. Consulte LICENSE.