⚓ ShippingRates MCP Server

Containerfracht-Intelligenz für KI-Agenten – Demurrage & Detention, lokale Gebühren, Inlandstransport, CFS-Tarife. Pay-per-Request mit USDC über x402.

Kurzstart

Füge ShippingRates zu Claude Desktop, Cursor oder einem anderen MCP-kompatiblen Client hinzu:

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

Das war's. 9 Tools automatisch entdeckt. 3 kostenlos + 6 kostenpflichtig über x402.

Related MCP server: boo-x402-mcp

Neuerungen in v2.1.0

• Zwei-Ketten-Zahlungen — Base Mainnet (EVM) + Solana Mainnet

• Gestaffelte Preisgestaltung — 0,03 bis 0,25 $ pro Aufruf, je nach Datenkomplexität

• PayAI Facilitator — Kostenlos, kein API-Schlüssel für die Zahlungsabwicklung erforderlich

• 23/23 Endpunkte verifiziert — Vollständiger Produktions-Health-Check bestanden

• 2.547+ Datensätze über 14 Datenbanktabellen

• Serverkarte unter /.well-known/mcp/server-card.json zur automatischen Erkennung

• Live-Analytics-Dashboard mit Echtzeit-Zahlungsverfolgung

• Gelistet in Offiziellem MCP Registry, Smithery, Glama, mcp.so, x402scan

Tools

Kostenpflichtig (USDC über x402)

Kostenlos

Zahlung

ShippingRates verwendet das x402-Protokoll – den nativen Zahlungsstandard des Internets für KI-Agenten.

• Währung: USDC (Stablecoin, immer 1,00 $)

• Netzwerke: Base Mainnet (EVM) + Solana Mainnet

• Facilitator: PayAI – kostenlos, kein API-Schlüssel erforderlich

• Abrechnung: Sofort (~200 ms)

• Keine API-Schlüssel, keine Konten, keine Abonnements

Dein Agent sendet eine Anfrage → erhält HTTP 402 mit Zahlungsbedingungen → signiert die USDC-Zahlung → wiederholt mit Nachweis → erhält Daten. Alles automatisch von den x402-Clientbibliotheken verarbeitet.

Unterstützte x402-Clientbibliotheken

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

• Python: x402-Paket (httpx / requests)

• Go: x402-Go-Modul

Zahlungs-Wallets

Datenabdeckung

API-Zugriff

Für die direkte API-Integration (ohne MCP):

Beispiel: D&D-Berechnung

# 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}'

Beispielantwort (D&D-Berechnung)

{
  "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
}

Beispielantwort (D&D-Vergleich)

{
  "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
}

Architektur

┌─────────────────────────────────────────────────────┐
│                   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   │
                          └──────────────────────────┘

• MCP-Server — TypeScript, @modelcontextprotocol/sdk, Streamable-HTTP-Transport

• API-Server — TypeScript, Express.js, x402 v2 SDK mit PayAI Facilitator

• Datenbank — SQLite mit Daten aus offiziellen Reederei-Tarif-PDFs

• Infrastruktur — PM2-Prozessmanager, Cloudflare-Tunnel, Neustart-sicher

Anwendungsfälle

• Spediteure, die Strafkosten vor der Buchung schätzen

• KI-Agenten, die Container-Abholpläne optimieren, um D&D-Gebühren zu minimieren

• Logistikunternehmen, die Reedereien vergleichen, um die günstigste Option zu finden

• Handelsfinanzierung, die Kostenrisiken bei Importvorgängen bewertet

• Lieferkettenplattformen, die Echtzeit-D&D-Daten integrieren

Erkennung & Verzeichnisse

ShippingRates ist gelistet in:

Über uns

Erstellt von SmartBiz AI — KI-Lösungen für die kommerzielle Schifffahrt, mit Sitz in Mumbai, Indien.

ShippingRates ist die weltweit erste x402-native Schifffahrtsdaten-API, die speziell für KI-Agenten und autonomen Handel entwickelt wurde.

Links

• 🌐 Website

• 📖 Vollständige API-Dokumentation

• 🔍 x402-Erkennung

• ⚡ x402-Protokoll

• 🤖 MCP-Spezifikation

• 📊 API-Statistiken

Lizenz

Dieses Repository enthält ausschließlich Dokumentation und Verbindungskonfiguration. Der ShippingRates-API- und MCP-Server sind kommerzielle Dienste, die von SmartBiz AI betrieben werden.

Die Nutzung der API unterliegt der Pay-per-Request-Preisgestaltung über das x402-Protokoll.