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

Model Context Protocol (Streamable HTTP)

POST
/mcp
Single-endpoint Streamable HTTP transport for modern MCP clients and AI agent platforms
(Manus, Cursor, Windsurf, ChatGPT Developer Mode, Claude Desktop bridge).
Fully stateless and compatible with Google API Gateway without requiring persistent SSE connections.
Supports standard MCP methods:
initialize: Protocol version and capabilities handshake.
tools/list, tools/call: Executes query_financial_docs, query_shipments, audit_revenue_leakage, get_dso_aging, get_corridor_profitability, get_tax_summary, get_route_info, get_fleet_utilization, get_dispatch_to_bill_metrics, get_cash_inflow_forecast, get_discounts_and_shrinkage_audit, get_financial_unit_economics, query_fleet_assets, get_active_fleet_configurations, audit_driver_compliance, and get_on_time_performance.
resources/list, resources/read: Reads live operational context (finance://dso-aging, operations://corridor-profitability, tax://cfdi-retentions-summary).
prompts/list, prompts/get: Retrieves strategic workflows (executive-cashflow-briefing, corridor-route-audit, sat-retentions-reconciliation).

Solicitud

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

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200
application/json
Successful MCP response containing JSON-RPC result.
Encabezados

Body

🟠400BadRequest
🟠401Unauthorized
🟠429TooManyRequests
🔴500InternalServerError
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.dufrei.com/mcp?apiKey=' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
        "protocolVersion": "2025-11-25",
        "capabilities": {},
        "clientInfo": {
            "name": "manus-agent",
            "version": "1.0.0"
        }
    }
}'
Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
    "jsonrpc": "2.0",
    "id": "string",
    "result": {},
    "error": {
        "code": -32600,
        "message": "Invalid Request",
        "data": {}
    }
}
Modificado en 2026-09-20 15:05:35
Anterior
Health Check
Siguiente
Initialize Legacy SSE Stream
Built with