{
  "markdown": "# ShippingRates MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nOcean container shipping intelligence for AI agents — real carrier tariff data, detention & demurrage, freight rates, vessel schedules, and total landed cost across 6 major carriers.\n\n**Remote MCP endpoint:** `https://mcp.shippingrates.org/mcp`\n\n## Overview\n\nShippingRates gives AI agents access to structured, carrier-sourced data for container shipping decisions — D&D slab breakdowns, local port charges, inland haulage rates, freight rates, vessel schedules, port congestion, and full landed cost calculations.\n\n**Carriers covered:** Maersk · Hapag-Lloyd · MSC · COSCO · ONE · CMA CGM\n\n## Quickstart\n\nConnect any MCP-compatible client to the remote endpoint:\n\n```json\n{\n  \"mcpServers\": {\n    \"shippingrates\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.shippingrates.org/mcp\"]\n    }\n  }\n}\n```\n\n> Paid tools require an x402 USDC payment on Base or Solana. Free tools work without any payment.\n\n## Tools (24 total)\n\n### Free (no payment required)\n\n| Tool | Description |\n|------|-------------|\n| `shippingrates_stats` | Database statistics — record counts, carrier coverage, last updated |\n| `shippingrates_lines` | List all shipping lines with country-level breakdowns |\n| `shippingrates_search` | Cross-data keyword search across ports, carriers, charges |\n| `shippingrates_fx` | Live exchange rates (USD base) |\n\n### Paid (x402 USDC micropayments)\n\n| Tool | Price | Description |\n|------|-------|-------------|\n| `dd_calculate` | $0.10 | D&D slab breakdown by carrier, port, container type, and days over free time |\n| `dd_compare` | $0.25 | Cross-carrier D&D comparison at the same port |\n| `local_charges` | $0.05 | THC, documentation, seal, and BL fees by port and carrier |\n| `inland_search` | $0.03 | Search inland routes by origin/destination |\n| `inland_haulage` | $0.05 | Trucking and rail rates (12 origins, 72 destinations) |\n| `inland_compare` | $0.08 | Compare inland rates across carriers |\n| `cfs_tariffs` | $0.05 | CFS handling tariffs (APM Terminals — INMAA, INMUN) |\n| `port` | $0.01 | Port lookup by UN/LOCODE |\n| `transit` | $0.02 | Port-to-port transit times |\n| `transit_schedules` | $0.03 | Transit schedules with carrier service codes and frequency |\n| `rates` | $0.03 | Ocean spot freight rates with low/mid/high and trend |\n| `surcharges` | $0.02 | BAF, CAF, PSS surcharges by carrier |\n| `congestion` | $0.02 | Port congestion metrics and historical wait times |\n| `congestion_news` | $0.02 | Real-time shipping disruption news from 7 sources |\n| `reliability` | $0.02 | Schedule reliability (on-time %) by carrier |\n| `vessel_schedule` | $0.02 | Upcoming vessel calls at a port with ETA/ETD |\n| `regulatory` | $0.01 | Regulatory updates by country |\n| `total_cost` | $0.15 | Full landed cost: freight + surcharges + local charges + D&D |\n| `facilities` | $0.02 | India ICD/CFS facility directory |\n| `risk_score` | $0.10 | Composite route risk assessment (0–100 score) |\n\n## Example: Calculate D&D for a shipment\n\n```\nWhat are the detention and demurrage charges for a 20ft dry container at Nhava Sheva \n(INNSA) on Maersk if it's been 10 days over free time?\n```\n\nThe `dd_calculate` tool returns a slab-by-slab breakdown with daily rates, total accrued, and free time details — sourced directly from Maersk's published tariff.\n\n## Payment\n\nPaid tools use the [x402 protocol](https://x402.org) — a standard for HTTP micropayments. When an agent calls a paid tool:\n\n1. The server responds `402 Payment Required` with a USDC payment details\n2. The agent pays via Base Mainnet or Solana (USDC)\n3. The agent retries with an `X-PAYMENT` header\n4. Data is returned\n\nPayment amounts range from $0.01 to $0.25 per call. No subscriptions, no API keys needed for basic access.\n\n## Free Tier\n\nThe API also offers a free tier: 25 API requests/month via `api.shippingrates.org`. Sign up at [shippingrates.org](https://shippingrates.org).\n\n## Dashboard\n\nHuman-facing dashboard at [app.shippingrates.org](https://app.shippingrates.org) with D&D calculator, carrier comparator, inland routes explorer, vessel schedules, and rate calculator.\n\n## Links\n\n- **Homepage:** https://shippingrates.org\n- **API Docs:** https://api.shippingrates.org/docs\n- **MCP Endpoint:** https://mcp.shippingrates.org/mcp\n- **x402 Discovery:** https://api.shippingrates.org/.well-known/x402.json\n- **Agent Discovery:** https://api.shippingrates.org/.well-known/agents.json\n- **OpenAPI Spec:** https://api.shippingrates.org/openapi.json\n\n## License\n\nMIT\n",
  "bytes": 4612,
  "sha": "d5fbbee0dfcabcccc26eba02dcde65a58c6ec95e8dbad15177bcb38195d48c06",
  "repo_slug": "vinaybhosle/shippingrates-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_vinaybhosle_shippingrates_mcp__8c3dc5c3/readme"
}