1. 2. AI Agents & MCP
DUFREI API
  • Raíz
    • 1. Core & Health
      • Health Check
    • 2. AI Agents & MCP
      • Model Context Protocol (Streamable HTTP)
        POST
      • Initialize Legacy SSE Stream
        GET
      • Send Legacy MCP JSON-RPC Message
        POST
    • 3. Financial Documents
      • List Financial Documents
      • Cash Inflow Forecast & Customer Concentration (HHI)
      • Discounts, Demurrage & Shrinkage Recovery Audit
    • 4. Shipments & Fleet
      • List Shipments (Trips)
      • Audit Fleet Utilization and Productivity
      • Audit Dispatch-to-Bill and Invoicing Efficiency
      • Freight Financial Unit Economics ($/km, $/L)
    • 3. Financial & Invoices
      • SAT CFDI 4.0 Monthly Fiscal Ledger & Retention Reconciliation
    • 5. Scheduled Alerts
      • Schedule Alert Rules
  • Schemas
    • PaginationMeta
    • FinancialDocsResponse
    • ShipmentsResponse
    • FinancialSummary
    • TripSummary
    • ErrorResponse
    • CanceledRecord
    • PaymentRecord
    • FinancialDocument
    • MexicanAddress
    • ShipmentLeg
    • TripDocument
    • ScheduleAlertsRequest
    • ScheduleAlertsSuccessResponse
    • McpJsonRpcRequest
    • McpJsonRpcResponse
    • RouteCatalogDetails
    • FleetUtilizationResponse
    • DispatchToBillResponse
    • CashInflowForecastResponse
    • DiscountsAndShrinkageResponse
    • FinancialUnitEconomicsResponse
  1. 2. AI Agents & MCP

Send Legacy MCP JSON-RPC Message

POST
/messages
Sends a JSON-RPC 2.0 message to an active MCP session created via /sse.
Requires the sessionId query parameter provided by the /sse connection event.

Solicitud

Autorización
API Key
Agregar parámetro en header
x-api-key
Ejemplo:
x-api-key: ********************
or
Parámetros de consulta

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200
Message accepted and processed. Result is delivered asynchronously on /sse.
Esta respuesta no tiene un body.
🟠404
🟠400BadRequest
🟠401Unauthorized
🔴500InternalServerError
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://api.dufrei.com/messages?sessionId=' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "id": 101,
    "method": "tools/call",
    "params": {
        "name": "query_financial_docs",
        "arguments": {
            "limit": 5,
            "detail": "summary"
        }
    }
}'
Respuesta Ejemplo de Respuesta
404 - Ejemplo 1
{
    "error": {
        "code": 400,
        "message": "Invalid query parameter",
        "details": [
            "'limit' must be an integer between 1 and 100"
        ]
    }
}
Modificado en 2026-09-20 15:05:35
Anterior
Initialize Legacy SSE Stream
Siguiente
List Financial Documents
Built with