{
  "markdown": "# ⚓ ShippingRates MCP Server\n\n> Container shipping intelligence for AI agents — demurrage & detention, local charges, inland haulage, CFS tariffs. Pay-per-request with USDC via x402.\n\n[![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)\n[![x402](https://img.shields.io/badge/x402-USDC%20Payments-green)](https://x402.org)\n[![Networks](https://img.shields.io/badge/Networks-Base%20%2B%20Solana-purple)]()\n[![Version](https://img.shields.io/badge/version-2.1.0-orange)]()\n[![Status](https://img.shields.io/badge/status-Production-brightgreen)]()\n\n## Quick Start\n\nAdd ShippingRates to Claude Desktop, Cursor, or any MCP-compatible client:\n\n```json\n{\n  \"mcpServers\": {\n    \"shippingrates\": {\n      \"url\": \"https://mcp.shippingrates.org/mcp\"\n    }\n  }\n}\n```\n\nThat's it. 9 tools auto-discovered. 3 free + 6 paid via x402.\n\n## What's New in v2.1.0\n\n- **Dual-chain payments** — Base Mainnet (EVM) + Solana Mainnet\n- **Tiered pricing** — $0.03 to $0.25 per call based on data complexity\n- **PayAI facilitator** — Free, no API key required for payment processing\n- **23/23 endpoints verified** — Full production health check passed\n- **2,547+ records** across 14 database tables\n- **Server card** at `/.well-known/mcp/server-card.json` for auto-discovery\n- **Live analytics** dashboard with real-time payment tracking\n- **Listed on** Official MCP Registry, Smithery, Glama, mcp.so, x402scan\n\n## Tools\n\n### Paid (USDC via x402)\n\n| Tool | Price | Description |\n|------|-------|-------------|\n| `dd_calculate` | $0.10 | Calculate demurrage & detention costs — free days, per-diem rates, slab breakdown, total cost |\n| `dd_compare` | $0.25 | Compare D&D costs across all 6 shipping lines in one call. **No competitor offers this.** |\n| `local_charges` | $0.05 | Port local charges — THC, documentation fees, BL fees, seal fees |\n| `inland_search` | $0.03 | Search inland transport routes by origin/destination |\n| `cfs_tariffs` | $0.05 | Container Freight Station handling tariffs by cargo type |\n| `inland_haulage` | $0.05 | Inland haulage rates — trucking/rail from port to destination |\n\n### Free\n\n| Tool | Description |\n|------|-------------|\n| `list_lines` | List all 6 shipping lines with per-country record counts |\n| `get_stats` | Database statistics — records, coverage, pricing, last update |\n| `health_check` | Server status, version, network configuration |\n\n## Payment\n\nShippingRates uses the [x402 protocol](https://x402.org) — the internet's native payment standard for AI agents.\n\n- **Currency:** USDC (stablecoin, always $1.00)\n- **Networks:** Base Mainnet (EVM) + Solana Mainnet\n- **Facilitator:** [PayAI](https://payai.network) — free, no API key needed\n- **Settlement:** Instant (~200ms)\n- **No API keys, no accounts, no subscriptions**\n\nYour agent sends a request → gets HTTP 402 with payment terms → signs USDC payment → retries with proof → gets data. All handled automatically by x402 client libraries.\n\n### Supported x402 Client Libraries\n\n- **TypeScript:** `@x402/fetch` or `@x402/axios`\n- **Python:** `x402` package (httpx / requests)\n- **Go:** `x402` Go module\n\n### Payment Wallets\n\n| Network | Address |\n|---------|---------|\n| Base (EVM) | `0x8c9e0882b4c6e6568fe76F16D59F7E080465E5C8` |\n| Solana | `Gcv56hKWuEGmXheBpJxAwQxvX6QAMimZzzVrHaVCbNWE` |\n\n## Data Coverage\n\n| Metric | Value |\n|--------|-------|\n| **Shipping Lines** | 6 — Maersk, MSC, CMA-CGM, Hapag-Lloyd, ONE, COSCO |\n| **Records** | 2,547+ verified tariff entries across 14 tables |\n| **Countries** | 9 — IN, AE, SG, CN, MY, LK, PK, BD, TH |\n| **Container Types** | 20DV, 40DV, 40HC, 20RF, 40RF, 20OT, 40OT, 20FR, 40FR |\n| **Data Quality** | 100% manually verified from official carrier PDFs |\n| **Data Tables** | dd_tariffs, local_charges, inland_haulage, cfs_tariffs, ports, and more |\n\n## API Access\n\nFor direct API integration (without MCP):\n\n| Resource | URL |\n|----------|-----|\n| API Base | `https://api.shippingrates.org` |\n| Full Docs | `https://api.shippingrates.org/llms-full.txt` |\n| LLMs.txt | `https://api.shippingrates.org/llms.txt` |\n| x402 Discovery | `https://api.shippingrates.org/.well-known/x402.json` |\n| MCP Server | `https://mcp.shippingrates.org/mcp` |\n| MCP Server Card | `https://mcp.shippingrates.org/.well-known/mcp/server-card.json` |\n| Health Check | `https://api.shippingrates.org/health` |\n\n### Example: D&D Calculate\n\n```bash\n# Free endpoint — no payment needed\ncurl https://api.shippingrates.org/api/stats\n\n# Paid endpoint — returns HTTP 402 with payment instructions\ncurl -X POST https://api.shippingrates.org/api/dd/calculate \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"line\": \"maersk\", \"country\": \"IN\", \"container_type\": \"40HC\", \"days\": 14}'\n```\n\n### Example Response (D&D Calculate)\n\n```json\n{\n  \"line\": \"maersk\",\n  \"country\": \"IN\",\n  \"container_type\": \"40HC\",\n  \"days\": 14,\n  \"free_days\": 4,\n  \"currency\": \"USD\",\n  \"slabs\": [\n    { \"from\": 5, \"to\": 7, \"rate_per_day\": 7.5, \"days\": 3, \"cost\": 22.5 },\n    { \"from\": 8, \"to\": 14, \"rate_per_day\": 15, \"days\": 7, \"cost\": 105 }\n  ],\n  \"total_cost\": 127.5\n}\n```\n\n### Example Response (D&D Compare)\n\n```json\n{\n  \"country\": \"IN\",\n  \"container_type\": \"40HC\",\n  \"days\": 14,\n  \"comparisons\": [\n    { \"line\": \"maersk\", \"total_cost\": 127.5, \"free_days\": 4, \"currency\": \"USD\" },\n    { \"line\": \"msc\", \"total_cost\": 150.0, \"free_days\": 3, \"currency\": \"USD\" },\n    { \"line\": \"cosco\", \"total_cost\": 95.0, \"free_days\": 7, \"currency\": \"USD\" }\n  ],\n  \"cheapest\": \"cosco\",\n  \"savings_vs_most_expensive\": 55.0\n}\n```\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────┐\n│                   AI Agent / Client                  │\n│            (Claude, Cursor, ChatGPT, etc.)           │\n└──────────────┬──────────────────────┬───────────────┘\n               │ MCP                  │ HTTP + x402\n               ▼                      ▼\n┌──────────────────────┐  ┌──────────────────────────┐\n│  MCP Server v1.1.0   │  │    API Server v2.1.0     │\n│  mcp.shippingrates   │──│  api.shippingrates.org   │\n│  .org:3480           │  │  :3402                   │\n└──────────────────────┘  └────────────┬─────────────┘\n                                       │\n                          ┌────────────▼─────────────┐\n                          │  Shipping Intelligence DB │\n                          │  SQLite — 14 tables       │\n                          │  2,547+ verified records   │\n                          └──────────────────────────┘\n```\n\n- **MCP Server** — TypeScript, `@modelcontextprotocol/sdk`, Streamable HTTP transport\n- **API Server** — TypeScript, Express.js, x402 v2 SDK with PayAI facilitator\n- **Database** — SQLite with data from official carrier tariff PDFs\n- **Infrastructure** — PM2 process manager, Cloudflare Tunnel, reboot-proof\n\n## Use Cases\n\n- **Freight forwarders** estimating penalty costs before booking\n- **AI agents** optimizing container pickup schedules to minimize D&D charges\n- **Logistics companies** comparing carriers to find the cheapest option\n- **Trade finance** assessing cost risk on import operations\n- **Supply chain platforms** integrating real-time D&D data\n\n## Discovery & Directories\n\nShippingRates is listed on:\n\n| Directory | Status |\n|-----------|--------|\n| [Official MCP Registry](https://registry.modelcontextprotocol.io) | ✅ Live — `io.github.vinaybhosle/shippingrates-mcp-server` |\n| [Smithery](https://smithery.ai) | ✅ Submitted |\n| [Glama](https://glama.ai/mcp/servers) | ✅ Submitted |\n| [mcp.so](https://mcp.so) | ✅ Submitted |\n| [x402scan](https://x402scan.com) | ✅ Indexed — 6 resources auto-discovered |\n\n## About\n\nBuilt by [SmartBiz AI](https://shippingrates.org) — AI solutions for commercial shipping, based in Mumbai, India.\n\nShippingRates is the world's first x402-native shipping data API, purpose-built for AI agents and autonomous commerce.\n\n## Links\n\n- 🌐 [Website](https://shippingrates.org)\n- 📖 [Full API Documentation](https://api.shippingrates.org/llms-full.txt)\n- 🔍 [x402 Discovery](https://api.shippingrates.org/.well-known/x402.json)\n- ⚡ [x402 Protocol](https://x402.org)\n- 🤖 [MCP Specification](https://modelcontextprotocol.io)\n- 📊 [API Stats](https://api.shippingrates.org/api/stats)\n\n## License\n\nThis repository contains documentation and connection configuration only. The ShippingRates API and MCP server are commercial services operated by SmartBiz AI.\n\nUsage of the API is governed by pay-per-request pricing via the x402 protocol.\n",
  "bytes": 8422,
  "sha": "49190f223d8077f38d7d110d0cbbfdf998fd5ed812d20ab0e87df963de770e5e",
  "repo_slug": "vinaybhosle/shippingrates-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_vinaybhosle_freightgate_mcp_se_b64e1044/readme"
}