⚓ ShippingRates MCP Server

Inteligencia de transporte de contenedores para agentes de IA — demurrage y detention, cargos locales, transporte terrestre, tarifas CFS. Pago por solicitud con USDC mediante x402.

Inicio rápido

Añade ShippingRates a Claude Desktop, Cursor o cualquier cliente compatible con MCP:

{
  "mcpServers": {
    "shippingrates": {
      "url": "https://mcp.shippingrates.org/mcp"
    }
  }
}

Eso es todo. 9 herramientas autodescubiertas. 3 gratuitas + 6 de pago mediante x402.

Related MCP server: dyoe-agent-tools-mcp

Novedades en v2.1.0

• Pagos en dos cadenas — Base Mainnet (EVM) + Solana Mainnet

• Precios escalonados — $0.03 a $0.25 por llamada según la complejidad de los datos

• Facilitador PayAI — Gratuito, no se requiere clave API para el procesamiento de pagos

• 23/23 endpoints verificados — Comprobación de salud de producción completa superada

• Más de 2,547 registros en 14 tablas de base de datos

• Tarjeta de servidor en /.well-known/mcp/server-card.json para autodescubrimiento

• Panel de análisis en vivo con seguimiento de pagos en tiempo real

• Listado en Registro Oficial de MCP, Smithery, Glama, mcp.so, x402scan

Herramientas

De pago (USDC mediante x402)

Grauitas

n| Herramienta | Descripción | | ---------------- | ------------------------------------------------------------- | | list_lines | Listar las 6 líneas navieras con contaje de registros por país | n| get_stats | Estadísticas de base de datos — registros, cobertura, precios, última actualización | n| health_check | Estado del servidor, versión, configuración de red |

Pago

ShippingRates utiliza el protocolo x402 — el estándar nativo de pago en internet para agentes de IA.

• Moneda: USDC (stablecoin, siempre $1.00)

• Redes: Base Mainnet (EVM) + Solana Mainnet

• Facilitador: PayAI — gratuto, sin clave API requerida

• Liquidación: Instantánea (~200ms)

• Sin claves API, sin cuentas, sin suscripciones

Tu agente envía una solicitud → recibe HTTP 402 con términos de pago → firma pago USDC → reintenta con prueba → recibe datos. Todo manejado automáticamente por las biblitecas cliente x402.

Biblotecas de cliente x402 soportadas

• TypeScript: @x402/fetch o @x402/axios

• Python: paquete x402 (httpx / requests)

• Go: módulo Go x402 n

Billeteros de pago

Cobertura de datos

| Métrica | Valor | n| ------------------- | --------------------------------------------------------------------------- | | Líneas navieras | 6 — Maersk, MSC, CMA-CGM, Hapag-Lloyd, ONE, COSCO | n| Registros | Más de 2,547 entradas tarifarias verifcadas en 14 tbalas | n| Países | 9 — IN, AE, SG, CN, MY, LK, PK, BD, TH | n| Tipos de contenedores | 20DV, 40DV, 40HC, 20RF, 40RF, 20OT, 40OT, 20FR, 40FR | n| Calidad de datos | 100% verifcada manualmente desde PDFs oficiales de las navieras | | Tablas de datos | dd_tarifas, cargos_locales, transporte_terrestre, tarifas_CFS, puertos y más |

Acceso a API

Para integración directa con API (sin MCP):

| Recruso | URL | n| ----------------- | ---------------------------------------------------------------- | n| Base API | https://api.shippingrates.org | n| Documentación completa | https://api.shippingrates.org/llms-full.txt | n| LLMs.txt | https://api.shippingrates.org/llms.txt | n| Descubrimiento x402| https://api.shippingrates.org/.well-known/x402.json | n| Servidor MCP | https://mcp.shippingrates.org/mcp | n| Tarjeta del servidor MCP | https://mcp.shippingrates.org/.well-known/mcp/server-card.json | n| Comprobación de salud | https://api.shippingrates.org/health | n

Ejemplo: Cálculo de D&D

# Free endpoint — no payment needed
curl https://api.shippingrates.org/api/stats

# Paid endpoint — returns HTTP 402 with payment instructions
curl -X POST https://api.shippingrates.org/api/dd/calculate \
  -H "Content-Type: application/json" \
  -d '{"line": "maersk", "country": "IN", "container_type": "40HC", "days": 14}'

Ejemplo de respuesta (Cálculo de D&D)

{
  "line": "maersk",
  "country": "IN",
  "container_type": "40HC",
  "days": 14,
  "free_days": 4,
  "currency": "USD",
  "slabs": [
    { "from": 5, "to": 7, "rate_per_day": 7.5, "days": 3, "cost": 22.5 },
    { "from": 8, "to": 14, "rate_per_day": 15, "days": 7, "cost": 105 }
  ],
  "total_cost": 127.5
}

Ejemplo de respuesta (Comparación de D&D)

{
  "country": "IN",
  "container_type": "40HC",
  "days": 14,
  "comparisons": [
    { "line": "maersk", "total_cost": 127.5, "free_days": 4, "currency": "USD" },
    { "line": "msc", "total_cost": 150.0, "free_days": 3, "currency": "USD" },
    { "line": "cosco", "total_cost": 95.0, "free_days": 7, "currency": "USD" }
  ],
  "cheapest": "cosco",
  "savings_vs_most_expensive": 55.0
}

Arquitectura

┌─────────────────────────────────────────────────────┐
│                   AI Agent / Client                  │
│            (Claude, Cursor, ChatGPT, etc.)           │
└──────────────┬──────────────────────┬───────────────┘
               │ MCP                  │ HTTP + x402
               ▼                      ▼
┌──────────────────────┐  ┌──────────────────────────┐
│  MCP Server v1.1.0   │  │    API Server v2.1.0     │
│  mcp.shippingrates   │──│  api.shippingrates.org   │
│  .org:3480           │  │  :3402                   │
└──────────────────────┘  └────────────┬─────────────┘
                                       │
                          ┌────────────▼─────────────┐
                          │  Shipping Intelligence DB │
                          │  SQLite — 14 tables       │
                          │  2,547+ verified records   │
                          └──────────────────────────┘

• Servidor MCP — TypeScript, @modelcontextprotocol/sdk, transporte HTTP Streamable

• Servidor API — TypeScript, Express.js, SDK x402 v2 con facilitador PayAI

• Base de datos — SQLite con datos de PDFs tarifarios oficiales de navieras

• Infraestructura — Gestor de procesos PM2, Túnel Cloudflre, a prueba de reinicios

Casos de uso

• Agentes de carga estimando costos de penalización antes de reservar

• Agentes de IA optimizando horarios de recogida de contenedores para minimizar cargos D&D

• Empresas logísticas comparando navieras para encontrar la opción más barata

• Financiamiento comercial evaluando riesgo de costos en operaciones de importación

• Plataformas de cadena de suministro integrando datos D&D en tiempo real

Descubrimiento y directorios

ShippingRates está listado en:

| Directorio | Estado | n| ----------------------------------------------------------------- | --------------------------------------------------------- | n| Registro Oficial MCP | ✅ Activo — io.github.vinaybhosle/shippingrates-mcp-server | n| Smithery | ✅ Enviado | n| Glama | ✅ Enviado | n| mcp.so | ✅ Enviado | n| x402scan | ✅ Indexado — 6 recusos autodescubiertos |

Acerca de

Construido por SmartBiz AI — soluciones de IA para el transporte marítimo comercial, con sede en Mumbai, India.

ShippingRates es la primera API de datos de envío nativa de x402 en el mundo, diseñada específicamente para agentes de IA y comercio autónomo.

Enlces

n* 🌐 Sitio web

• 📖 Documentación completa de API

• 🔍 Descubrimiento x402

• ⚡ Protocolo x402

• 🤖 Especificación MCP

• 📊 Estadísticas de API

Licencia

Este repositorio contiene solo documentación y configuración de conexión. La API de ShippingRates y el servidor MCP son servicios comerciales operados por SmartBiz AI.

El uso de la API se rige por el precio de pago por solicitud mediante el protocolo x402.