Bolsa de Carga - Cargoffer

Servidor del Protocolo de Contexto del Modelo para la API de Cargoffer Bolsa de Carga (mercado de carga) — permite que agentes de IA y LLMs interactúen con el mercado de carga de Cargoffer.

GitHubPrueba este MCPPatrocinado

Documentación

Capa MCP operativa para operaciones del mercado de carga europeo

Un servidor MCP de mercado de carga que conecta agentes de IA (Claude Desktop, Cursor, Cline, Continue, etc.) con la API del mercado de carga Cargoffer Bolsa de Carga — permitiendo a los LLM buscar cargas, gestionar subastas, ofertar en fletes, rastrear entregas y generar cartas de porte CMR completamente a través de lenguaje natural.

¿Qué problema resuelve? Los intermediarios de carga y transportistas pasan horas actualizando sitios web de bolsas de carga, copiando datos entre pestañas y publicando manualmente actualizaciones de subastas. Este servidor MCP convierte todo el mercado de carga de Cargoffer en herramientas de IA invocables — un agente puede buscar cargas disponibles, crear subastas, aceptar ofertas, registrar camiones y generar documentos legales en un solo flujo conversacional.

¿Qué lo hace diferente? A diferencia de las bolsas de carga extraídas por scraping o las APIs de un solo propósito, esto expone el ciclo de vida completo del mercado como herramientas MCP estructuradas: subastas (11 herramientas), direcciones (4), remolques/camioneros (4), vehículos (4), entregas (6) y autenticación (2). El agente de IA no solo lee datos — puede realizar transacciones: publicar subastas, aceptar ofertas, generar PDFs de CMR. Es una capa operativa de lectura y escritura, no un panel de solo lectura.

¿Qué integración permite? Cualquier cliente compatible con MCP puede invocar más de 35 herramientas del mercado de carga para buscar cargas de flete, gestionar recursos de la empresa, participar en subastas y generar documentos de envío — todo a través de conversación en lenguaje natural con un LLM.

¿Qué significa "integración fácil" en concreto? Clona el repositorio, configura API_KEY=your-key, ejecuta node src/server.js y configura tu cliente MCP con un bloque JSON. Sin instalación de SDK, sin configuración de base de datos, sin trámites de OAuth. Tu agente de IA puede inmediatamente publicar y ofertar en cargas de la bolsa de carga europea.

Por qué existe este MCP

El mercado spot de carga europeo funciona a través de docenas de bolsas de carga incompatibles, cada una con su propio inicio de sesión, interfaz y formato de datos. Los despachadores revisan manualmente múltiples tableros, copian y pegan detalles de carga en hojas de cálculo y coordinan negociaciones por WhatsApp y correo electrónico. El proceso es lento, propenso a errores e invisible para la automatización.

Este servidor MCP expone la API de Cargoffer Bolsa de Carga — un mercado de carga europeo de transporte por carretera unificado — como herramientas LLM de primera clase. Permite a los agentes de IA buscar cargas disponibles, crear y publicar subastas, gestionar ofertas, registrar vehículos y conductores de la empresa, rastrear el estado de las entregas y generar cartas de porte CMR. Transforma un asistente de IA de una interfaz de chat en una mesa de carga operativa capaz de realizar automatización de documentos logísticos y transacciones de mercado.

Capacidades del Agente de IA

Capacidad	Qué puede hacer la IA
Monitoreo de cargas	Encontrar y filtrar subastas de carga activas en tiempo real
Gestión de ofertas	Enviar ofertas sobre cargas disponibles automáticamente
Operaciones de direcciones	Gestionar direcciones y ubicaciones de envío
Emparejamiento de flota	Emparejar vehículos y camioneros disponibles con cargas
Seguimiento de entregas	Rastrear el estado de entrega en todos los envíos

Capacidades MCP

Más de 35 herramientas MCP en 6 dominios funcionales — subastas, direcciones, remolques, vehículos, entregas, autenticación
Ciclo de vida completo de subastas — crear, publicar, listar, actualizar, eliminar, aceptar ofertas, gestionar favoritos
Gestión de libreta de direcciones — ubicaciones reutilizables de la empresa (recogida, entrega, depósito)
Registro de remolques/camioneros — gestionar capacidad de flota y asignaciones de conductores
Gestión de vehículos — registrar camiones con dimensiones, capacidad de carga y certificaciones
Seguimiento de entregas — listar entregas, obtener detalles, descargar PDFs de CMR, enviar mensajes de entrega
Generación de cartas de porte CMR — firmar y bloquear contratos de carga directamente desde los registros de entrega
Autenticación basada en JWT — el servidor gestiona los tokens de inicio de sesión de forma transparente
JSON-RPC 2.0 sobre HTTP — transporte MCP estándar
Cero dependencias de ejecución más allá de Node.js 18+ — sin Docker, sin base de datos, sin paso de compilación

Herramientas

Subastas (11 herramientas)

Listar subastas activas, obtener/crear/actualizar/eliminar subastas, publicar subasta, aceptar oferta, firmar con CMR, gestionar favoritos.

|| Herramienta | Descripción | |------|-------------| | bolsa_auctions_active | Listar subastas de carga activas | | bolsa_auctions_get | Obtener detalles de subasta por ID | | bolsa_auctions_create | Crear una nueva subasta | | bolsa_auctions_update | Actualizar una subasta existente | | bolsa_auctions_delete | Eliminar una subasta | | bolsa_auctions_publish | Publicar subasta en el mercado | | bolsa_auctions_accept_bid | Aceptar una oferta en una subasta | | bolsa_auctions_sign_cmr | Firmar carta de porte CMR para subasta | | bolsa_auctions_favorites | Gestionar subastas favoritas |

Países (1 herramienta)

Validar qué países están habilitados para operaciones de mercado antes de buscar.

|| Herramienta | Descripción | |------|-------------| | bolsa_countries_enabled | Listar países habilitados para búsqueda |

Direcciones (4 herramientas)

Herramienta	Descripción
`bolsa_addresses_list`	Listar todas las direcciones
`bolsa_addresses_create`	Crear una nueva dirección
`bolsa_addresses_update`	Actualizar una dirección
`bolsa_addresses_delete`	Eliminar una dirección

Remolques / Camioneros (4 herramientas)

Herramienta	Descripción
`bolsa_trailers_list`	Listar todos los remolques
`bolsa_trailers_create`	Registrar nuevo remolque
`bolsa_trailers_update`	Actualizar información del remolque
`bolsa_trailers_delete`	Eliminar un remolque

Vehículos (4 herramientas)

Herramienta	Descripción
`bolsa_vehicles_list`	Listar todos los vehículos
`bolsa_vehicles_create`	Añadir un nuevo vehículo
`bolsa_vehicles_update`	Actualizar detalles del vehículo
`bolsa_vehicles_delete`	Eliminar un vehículo

Entregas (6 herramientas)

Herramienta	Descripción
`bolsa_deliveries_list`	Listar todas las entregas
`bolsa_deliveries_get`	Obtener detalles de entrega
`bolsa_deliveries_download_cmr`	Descargar PDF de CMR
`bolsa_deliveries_send_message`	Enviar mensaje de entrega

Autenticación (2 herramientas)

Herramienta	Descripción
`bolsa_auth_login`	Autenticar y recibir token JWT
`bolsa_auth_register`	Registrar una nueva cuenta

Estructura de directorios

bolsa_de_carga-mcp/
├── package.json            # Node.js 18+, ES module, bolsa-de-carga-mcp
├── .env.example            # Environment variable template
├── src/
│   └── server.js           # MCP server entry point (35+ tools, JSON-RPC 2.0)
└── README.md

Autenticación

Para usar este servidor MCP, necesitas una clave API de la plataforma Bolsa de Carga.

Registro: https://cia.cargoffer.com

Crea una cuenta y obtén tu clave API desde la configuración de tu perfil. Luego configura:

export API_KEY="your-api-key"

O en la configuración de tu cliente MCP:

{
  "mcpServers": {
    "bolsa-de-carga": {
      "command": "...",
      "env": {
        "API_KEY": "your-api-key-from-cia"
      }
    }
  }
}

Inicio rápido

# Clone
git clone https://github.com/cargoffer/bolsa_de_carga-mcp.git
cd bolsa_de_carga-mcp

# Configure with your API key
export API_KEY="your-api-key"

# Run
node src/server.js

El servidor se inicia en http://localhost:3000 con un endpoint JSON-RPC 2.0.

Instalación

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "bolsa-de-carga": {
      "command": "node",
      "args": ["/path/to/bolsa_de_carga-mcp/src/server.js"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

En Cursor Settings → Features → MCP Servers → Add New:

Name:   bolsa-de-carga
Type:   command
Command: node /path/to/bolsa_de_carga-mcp/src/server.js
Env:    API_KEY=your-api-key

HTTP directo (para integraciones personalizadas)

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "bolsa_auctions_active",
    "params": {"limit": 10}
  }'

Protocolo MCP en acción

Buscar subastas de carga activas:

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "bolsa_auctions_active",
    "params": {
      "limit": 10,
      "from": "Madrid",
      "to": "Barcelona"
    }
  }'

Respuesta:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": 200,
    "data": {
      "docs": [
        {
          "serviceCode": "MADBCNnT4FN",
          "from": { "city": "Madrid", "country": "ES" },
          "to": { "city": "Barcelona", "country": "ES" },
          "goods": { "description": "General cargo", "weight": 1000 },
          "status": "active"
        }
      ]
    }
  }
}

Crear y publicar una nueva subasta de carga:

curl -X POST http://localhost:3000 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "bolsa_auctions_create",
    "params": {
      "fromAddressId": "addr_123",
      "toAddressId": "addr_456",
      "goods": {
        "description": "Industrial machinery",
        "weight": 5000,
        "palletCount": 4
      },
      "pickupDate": "2026-06-01",
      "deliveryDate": "2026-06-03"
    }
  }'

Ejemplos de prompts para agentes de IA

"Muéstrame todas las cargas activas de Madrid a Barcelona de menos de 10 toneladas."

"Crea una nueva subasta para un envío de maquinaria de 5 toneladas de Valencia a Sevilla, recogida el próximo lunes."

"Acepta la oferta más alta en la subasta MADBCNnT4FN y genera la carta de porte CMR."

"Registra un nuevo camión con capacidad de 24 toneladas y remolque refrigerado en nuestra flota."

"Lista todas las entregas pendientes de firma CMR y descarga sus PDFs de carta de porte."

"¿Cuál es nuestra tasa de victorias en subastas este mes? Muéstrame subastas cerradas vs. activas."

Variables de entorno

Variable	Descripción	Valor por defecto
`API_KEY`	Clave API de Cargoffer (requerida para producción)	-
`API_URL`	URL base de la API	`https://api.pro.cargoffer.com`
`PORT`	Puerto del servidor	`3000`

Desarrollo local

# Use local backend
API_URL=http://localhost:8090 API_KEY=your-key node src/server.js

# Or copy .env.example
cp .env.example .env
# Edit .env with your values
node src/server.js

El archivo .env.example contiene la plantilla:

API_KEY=your-key
API_URL=https://api.pro.cargoffer.com
PORT=3000

Endpoints de la API

Endpoint	Método	Descripción
`/health`	GET	Verificación de salud
`/tools`	GET	Listar herramientas disponibles
`/`	POST	Endpoint JSON-RPC 2.0

Etiquetas semánticas

freight marketplace MCP load board API MCP server Model Context Protocol European road transport logistics document automation Bolsa de Carga freight auction load board truck brokerage CMR waybill freight matching AI agents LLM tools supply chain spot market Cargoffer trucking freight logistics Spain cargo easy MCP integration

Obtención de una clave API

Contacta con Cargoffer para obtener una clave API para uso en producción:

Correo electrónico: cto@cargoffer.com
O solicítala a través de tu panel de Cargoffer

Licencia

MIT — consulta el archivo LICENSE para más detalles.

Enlaces

Repositorio: github.com/cargoffer/bolsa_de_carga-mcp
Incidencias: github.com/cargoffer/bolsa_de_carga-mcp/issues
Protocolo MCP: modelcontextprotocol.io