ShipCost MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ShipCost MCP
An open-source Model Context Protocol (MCP) server that gives AI agents illustrative freight estimates in Sri Lankan rupees (LKR), carrier comparisons, and multi-stop route planning across Sri Lanka.
What it does
ShipCost MCP exposes simple logistics tools over MCP. It estimates freight charges and transit time across road, air, and sea modes, compares carrier options, and arranges pickup cities with a nearest-neighbor route heuristic. It is designed as a small, self-contained starting point for connecting AI agents to supply-chain workflows.
Rates and distances are fictional, illustrative planning data, not live quotes or authoritative road measurements. Replace them with verified Sri Lankan carrier APIs and operational routing data before using estimates in production decisions.
Related MCP server: FreightUtils MCP Server
How to use it with AI
ShipCost MCP is a tool server, not an AI model. It does not contain or connect to a model and does not need an AI API key. Instead, an MCP-compatible AI app (the host), such as Copilot Chat in VS Code, connects to this server. The host's AI interprets your request, calls the appropriate ShipCost tool, and uses the returned result to answer. Without an MCP host and an available AI assistant, the server will not chat by itself.
Connect from VS Code and Copilot Chat
Open this project folder in VS Code and install its dependencies:
py -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install -r requirements.txtOn macOS/Linux, use
python3 -m venv .venvand.venv/bin/python -m pip install -r requirements.txt.Create
.vscode/mcp.jsonin the workspace. On Windows, use:{ "servers": { "shipcost-mcp": { "type": "stdio", "command": "${workspaceFolder}\\.venv\\Scripts\\python.exe", "args": [ "${workspaceFolder}\\server.py", "--transport", "stdio" ] } } }On macOS/Linux, replace
commandwith"${workspaceFolder}/.venv/bin/python"and the first argument with"${workspaceFolder}/server.py".In VS Code, run MCP: List Servers from the Command Palette (
Ctrl+Shift+P), selectshipcost-mcp, and start it. Approve the workspace/server trust prompt if VS Code shows one.Open Copilot Chat in Agent mode and ask a logistics question, for example:
Estimate FTL freight from Colombo to Kandy for 500 kg over 115 km.
VS Code launches the configured process over stdio. Keep the workspace open; you do not need to start python server.py separately in a terminal. The running process appears in VS Code's MCP server controls/output. If you edit the server code or configuration, restart the MCP server from there.
Other MCP hosts
Configure the host to launch server.py --transport stdio, using the Python executable from this project's virtual environment. For an MCP host that connects over HTTP instead, run python server.py and configure the host with http://localhost:8080/mcp. These transports connect the host to the tools; neither makes ShipCost MCP an AI model.
Tools exposed
Name | Description | Example input | Example output |
| Estimates cost in LKR, transit time, and a suggested carrier. Modes: |
|
|
| Ranks four illustrative mode/carrier options by estimated LKR cost. |
|
|
| Orders supported pickup cities from a depot using a nearest-neighbor heuristic; the route does not return to the depot. |
|
|
estimate_freight and compare_carriers require positive, finite weight and distance values. The route tool accepts these Sri Lankan cities: Colombo, Kandy, Galle, Jaffna, Trincomalee, Batticaloa, Anuradhapura, Negombo, Matara, and Kurunegala.
Quick start
Requires Python 3.11 or later.
Local run
python -m venv .venv
# Windows PowerShell:
.venv\Scripts\Activate.ps1
# macOS/Linux:
# source .venv/bin/activate
pip install -r requirements.txt
python server.pyBy default, the server uses streamable HTTP on http://localhost:8080/mcp and serves http://localhost:8080/health. Set PORT to change the listening port. For an MCP client that launches a local stdio process, configure its command as python with arguments ["server.py", "--transport", "stdio"].
Docker
docker build -t shipcost-mcp .
docker run --rm -p 8080:8080 -e PORT=8080 shipcost-mcpDeploy to Cloud Run
gcloud run deploy shipcost-mcp --source . --region us-central1 --allow-unauthenticatedCloud Run supplies PORT; the container binds to 0.0.0.0 and includes an HTTP health endpoint at /health.
Example agent usage
An MCP client first initializes its connection and negotiates the protocol version, then sends a tool call over the streamable HTTP endpoint. Example tools/call request:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "estimate_freight",
"arguments": {
"origin": "Colombo",
"destination": "Kandy",
"weight_kg": 500,
"distance_km": 115,
"mode": "FTL"
}
}
}Representative JSON-RPC response (the values are computed from the illustrative rates):
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [
{
"type": "text",
"text": "{\"origin\":\"Colombo\",\"destination\":\"Kandy\",\"mode\":\"FTL\",\"estimated_cost_lkr\":21000.0,\"estimated_transit_days\":1,\"carrier_suggestion\":\"Lanka Road Freight\"}"
}
],
"isError": false
}
}Security & secrets
The core tools require no secrets. Freight estimates use fictional LKR pricing and are configured with Sri Lankan examples.
Never commit
.env; commit.env.exampleinstead. Keep API keys and credentials in environment variables or a managed secret store, never in source code or container images.If extending the project with real carrier APIs, store credentials in Google Secret Manager and attach them to Cloud Run at deployment, for example:
gcloud run deploy shipcost-mcp --source . --set-secrets=FEDEX_API_KEY=fedex-key:latestIf a secret is ever committed, rotate it immediately with the provider, then clean repository history with
git filter-repoor BFG. Removing a secret from the latest commit alone is not sufficient.Enable GitHub Secret Scanning (available for public repositories) and push protection where available.
Do not report security issues in public issues.
Submit to Chainkit
Submit ShipCost MCP to the Chainkit supply chain AI directory under the category Logistics.
License
MIT. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
RixFreight logistics quotes and route info via AI agents
Multi-carrier shipping for AI agents: compare rates, buy labels, track packages, validate addresses
Agentic-AI route optimization for delivery fleets, capacity- and time-window-safe.
Neutral freight reference + validation layer for AI agents: ADR, HS, UN/LOCODE, freight math
Related MCP Servers
- AlicenseAqualityCmaintenanceThe first logistics/WMS MCP server for AI agents. Rate shopping, inventory management, order tracking, fleet logistics, AI-powered route optimization, demand forecasting, and supply chain analytics. 18 tools across 3 tiers.2087 npm1MIT
- AlicenseAqualityBmaintenanceThe neutral freight reference layer for AI agents: source-backed dangerous-goods data and checks (ADR 2025, with the ADR 2027 changes mapped), HS codes and UK duty, UN/LOCODE, air cargo identifiers and freight calculators — 26 tools, every figure cited to its primary source. No freight to sell, no carrier to push.261,271 npm8MIT

Easyship MCPofficial
AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage global shipping operations, including rate comparison, shipment creation, label purchasing, tracking, pickup scheduling, address validation, billing, and analytics, via natural language.MIT- AlicenseAqualityBmaintenanceEnables AI assistants to query and manage logistics shipment data, supporting operations like tracking, quoting, and performance analysis via nine tools backed by a demo dataset or a REST API.9253 npmMIT