mcp-coordinadora — Claude Code MCP server: features and setup
Connect an AI agent to Coordinadora’s Colombian shipping API. Create shipments, check rates and coverage, or follow parcel activity through MCP tools.
claude mcp add mcp-coordinadora -e COORDINADORA_API_KEY=<COORDINADORA_API_KEY> -e COORDINADORA_NIT=<COORDINADORA_NIT> -- npx -y @codespar/mcp-coordinadoraWhat mcp-coordinadora does
The server exposes Coordinadora operations to an agent: create or cancel shipments, request rates, check service coverage, and retrieve tracking events. It can also arrange pickups, return a PDF shipping label, manage return shipments, and create multiple guías in one batch.
Each API request uses the company’s API key and NIT as custom headers. Set COORDINADORA_API_KEY and COORDINADORA_NIT before starting the server. It supports stdio; HTTP transport is available as a separate launch option.
This is an alpha release, and the API paths have not all been verified against a live service. Check the operations you rely on with your Coordinadora account before using them in a production workflow.
What it helps with
- Create a Coordinadora shipment
- Check rates and postcode coverage before dispatch
- Track a parcel by guía number
- Schedule or cancel a pickup
- Retrieve a label PDF or create a return guía
Example prompts for the agent
- Create a Coordinadora shipment using these sender and recipient details.
- Check the rate and coverage for a shipment from this city to this postal code.
- Track this parcel by guía number and show its event history.
How to install mcp-coordinadora
Platform CLI
claude mcp add mcp-coordinadora -e COORDINADORA_API_KEY=<COORDINADORA_API_KEY> -e COORDINADORA_NIT=<COORDINADORA_NIT> -- npx -y @codespar/mcp-coordinadoraReplace <…> with your own values
Platform CLI
codex mcp add coordinadora --env COORDINADORA_API_KEY=<COORDINADORA_API_KEY> --env COORDINADORA_NIT=<COORDINADORA_NIT> -- npx -y @codespar/mcp-coordinadoraReplace <…> with your own values
Config file
{
"mcpServers": {
"coordinadora": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-coordinadora"
],
"env": {
"COORDINADORA_API_KEY": "<COORDINADORA_API_KEY>",
"COORDINADORA_NIT": "<COORDINADORA_NIT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"coordinadora": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-coordinadora"
],
"env": {
"COORDINADORA_API_KEY": "<COORDINADORA_API_KEY>",
"COORDINADORA_NIT": "<COORDINADORA_NIT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e COORDINADORA_API_KEY=<COORDINADORA_API_KEY> -e COORDINADORA_NIT=<COORDINADORA_NIT> coordinadora npx -y @codespar/mcp-coordinadoraReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-coordinadora
How do I install mcp-coordinadora in Claude Code?
Run `claude mcp add mcp-coordinadora -e COORDINADORA_API_KEY=<COORDINADORA_API_KEY> -e COORDINADORA_NIT=<COORDINADORA_NIT> -- npx -y @codespar/mcp-coordinadora`. Replace the placeholders with your API key and company NIT.
What does mcp-coordinadora do?
It gives an agent tools for Coordinadora shipments, pickups, rate and coverage checks, labels, returns, and tracking.
Which credentials does the server need?
Provide a Coordinadora API key and your company NIT through COORDINADORA_API_KEY and COORDINADORA_NIT.
