Freightgate Mcp Server

io.github.vinaybhoslePublished by GitHub account vinaybhoslev2.1.1Updated Oct 24, 2026

Deprecated - renamed to shippingrates-mcp-server

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Deprecated container-shipping rate server (renamed shippingrates-mcp-server) that returns demurrage, local charge, and inland haulage data, with most tools…

What you can do
  • Calculate demurrage and detention costs for a shipping line, country and container type, including free days and per-diem slabs
  • Compare detention costs across six carriers and identify the cheapest option
  • Look up port local charges, CFS handling tariffs and inland transport or haulage routes
  • List shipping lines, database statistics and server health without payment
When to use it
Only if you specifically need this older entry; the registry description says it is deprecated and renamed to shippingrates-mcp-server, so prefer that server. Useful for freight forwarders or logistics agents estimating detention penalties and comparing carrier charges.
Requirements
The README points to a remote endpoint rather than a local install, and the manifest declares no packages, credentials or environment variables. Paid tools require an x402-capable client library and a funded USDC wallet on Base or Solana mainnet; no accounts or API keys are needed.
Before you install
Six of the nine tools cost money, from about $0.03 to $0.25 per call in USDC, settled automatically by the agent's wallet, so an assistant can spend funds without per-call confirmation. The README publishes wallet addresses for payment. The entry is marked deprecated and renamed, so the endpoint may change or disappear.

Installation

In SourceWeft

  1. Open Freightgate Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

⚓ ShippingRates MCP Server

Container shipping intelligence for AI agents — demurrage & detention, local charges, inland haulage, CFS tariffs. Pay-per-request with USDC via x402.

[MCP] [x402] [Networks] [Version] [Status]

Quick Start

Add ShippingRates to Claude Desktop, Cursor, or any MCP-compatible client:

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

That's it. 9 tools auto-discovered. 3 free + 6 paid via x402.

What's New in v2.1.0

  • Dual-chain payments — Base Mainnet (EVM) + Solana Mainnet
  • Tiered pricing — $0.03 to $0.25 per call based on data complexity
  • PayAI facilitator — Free, no API key required for payment processing
  • 23/23 endpoints verified — Full production health check passed
  • 2,547+ records across 14 database tables
  • Server card at /.well-known/mcp/server-card.json for auto-discovery
  • Live analytics dashboard with real-time payment tracking
  • Listed on Official MCP Registry, Smithery, Glama, mcp.so, x402scan

Tools

Paid (USDC via x402)

ToolPriceDescription
dd_calculate$0.10Calculate demurrage & detention costs — free days, per-diem rates, slab breakdown, total cost
dd_compare$0.25Compare D&D costs across all 6 shipping lines in one call. No competitor offers this.
local_charges$0.05Port local charges — THC, documentation fees, BL fees, seal fees
inland_search$0.03Search inland transport routes by origin/destination
cfs_tariffs$0.05Container Freight Station handling tariffs by cargo type
inland_haulage$0.05Inland haulage rates — trucking/rail from port to destination

Free

ToolDescription
list_linesList all 6 shipping lines with per-country record counts
get_statsDatabase statistics — records, coverage, pricing, last update
health_checkServer status, version, network configuration

Payment

ShippingRates uses the x402 protocol — the internet's native payment standard for AI agents.

  • Currency: USDC (stablecoin, always $1.00)
  • Networks: Base Mainnet (EVM) + Solana Mainnet
  • Facilitator: PayAI — free, no API key needed
  • Settlement: Instant (~200ms)
  • No API keys, no accounts, no subscriptions

Your 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.

Supported x402 Client Libraries

  • TypeScript: @x402/fetch or @x402/axios
  • Python: x402 package (httpx / requests)
  • Go: x402 Go module

Payment Wallets

NetworkAddress
Base (EVM)0x8c9e0882b4c6e6568fe76F16D59F7E080465E5C8
SolanaGcv56hKWuEGmXheBpJxAwQxvX6QAMimZzzVrHaVCbNWE

Data Coverage

MetricValue
Shipping Lines6 — Maersk, MSC, CMA-CGM, Hapag-Lloyd, ONE, COSCO
Records2,547+ verified tariff entries across 14 tables
Countries9 — IN, AE, SG, CN, MY, LK, PK, BD, TH
Container Types20DV, 40DV, 40HC, 20RF, 40RF, 20OT, 40OT, 20FR, 40FR
Data Quality100% manually verified from official carrier PDFs
Data Tablesdd_tariffs, local_charges, inland_haulage, cfs_tariffs, ports, and more

API Access

For direct API integration (without MCP):

ResourceURL
API Basehttps://api.shippingrates.org
Full Docshttps://api.shippingrates.org/llms-full.txt
LLMs.txthttps://api.shippingrates.org/llms.txt
x402 Discoveryhttps://api.shippingrates.org/.well-known/x402.json
MCP Serverhttps://mcp.shippingrates.org/mcp
MCP Server Cardhttps://mcp.shippingrates.org/.well-known/mcp/server-card.json
Health Checkhttps://api.shippingrates.org/health

Example: D&D Calculate

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

Example Response (D&D Calculate)

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

Example Response (D&D Compare)

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

Architecture

┌─────────────────────────────────────────────────────┐│                   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 with PayAI facilitator
  • Database — SQLite with data from official carrier tariff PDFs
  • Infrastructure — PM2 process manager, Cloudflare Tunnel, reboot-proof

Use Cases

  • Freight forwarders estimating penalty costs before booking
  • AI agents optimizing container pickup schedules to minimize D&D charges
  • Logistics companies comparing carriers to find the cheapest option
  • Trade finance assessing cost risk on import operations
  • Supply chain platforms integrating real-time D&D data

Discovery & Directories

ShippingRates is listed on:

DirectoryStatus
Official MCP Registry✅ Live — io.github.vinaybhosle/shippingrates-mcp-server
Smithery✅ Submitted
Glama✅ Submitted
mcp.so✅ Submitted
x402scan✅ Indexed — 6 resources auto-discovered

About

Built by SmartBiz AI — AI solutions for commercial shipping, based in Mumbai, India.

ShippingRates is the world's first x402-native shipping data API, purpose-built for AI agents and autonomous commerce.

Links

License

This repository contains documentation and connection configuration only. The ShippingRates API and MCP server are commercial services operated by SmartBiz AI.

Usage of the API is governed by pay-per-request pricing via the x402 protocol.

Source: README.md at commit 74b471e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v2.1.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.