ALalegra
Maestros

Ejecutar herramientas MCP

Endpoint principal del protocolo MCP (JSON-RPC 2.0). Soporta los métodos initialize, tools/list y tools/call.

Solo lectura: todas las herramientas son de consulta. El servidor rechaza cualquier herramienta cuyo nombre no contenga get, list o search. La única excepción es invoice_createInvoicesExportable, que genera una exportación descargable de facturas y no modifica datos.

Exposición según país: las herramientas que devuelve tools/list dependen del país de la empresa del token (por ejemplo, las herramientas SAT de México o DGI de Colombia solo aparecen en empresas de esos países).

Ejemplo cURL:

curl -X POST https://mcp.alegra.com/mcp \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
post/mcp

Request

  • Base URL
    https://mcp.alegra.com
  • URL
    https://mcp.alegra.com/mcp
  • Auth
    HTTP bearer

Headers

Authorizationstring required

Token de acceso OAuth 2.0 enviado como Bearer <token>. Requerido en todas las solicitudes.

Acceptstring

Tipos de respuesta aceptados. El servidor puede responder application/json o text/event-stream (streaming).

Mcp-Session-Idstring
Example:sess_abc123

ID de sesión MCP. Opcional en POST: enruta la solicitud a la misma sesión que la conexión inicial. Requerido para GET/DELETE.

Request body

jsonrpc'2.0' required

Versión de JSON-RPC

method'initialize' | 'tools/list' | 'tools/call' required

Método MCP a ejecutar

Response

Respuesta exitosa

jsonrpc'2.0'
resultobject

Resultado de la ejecución

Changes

No recorded changes to this operation across all 1 revision of this API.