MCP Coordinadora
Alpha release — published under the alpha npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during 0.x.x-alpha. Install with npm install <pkg>@alpha.
MCP server for Coordinadora — one of Colombia's largest courier and logistics companies, offering domestic and international shipping services.
Quick Start
export COORDINADORA_API_KEY="your-api-key"
export COORDINADORA_NIT="your-nit"
npx tsx packages/colombia/coordinadora/src/index.ts
npx tsx packages/colombia/coordinadora/src/index.ts --http
Environment Variables
| Variable | Required | Description |
|---|
COORDINADORA_API_KEY | Yes | API key from Coordinadora |
COORDINADORA_NIT | Yes | Company NIT number |
MCP_HTTP | No | Set to "true" to enable HTTP transport |
MCP_PORT | No | HTTP port (default: 3000) |
| Tool | Purpose |
|---|
create_shipment | Create a new shipment |
get_shipment | Get shipment details by guide number |
track_shipment | Track a shipment by guide number |
get_rates | Get shipping rates/quotes |
list_cities | List available cities for shipping |
create_pickup | Schedule a pickup at an address |
get_coverage | Check if a location is within coverage area |
cancel_shipment | Cancel a shipment |
get_guia_pdf | Download a guía label as PDF (returns base64 or URL) |
get_pickup | Get pickup (recolección) details by id |
cancel_pickup | Cancel a scheduled pickup (recolección) |
get_tracking_history | Get full tracking event history for a guía |
list_shipments_by_date | List guías created within a date range |
validate_coverage | Validate that a city + postal code combination is covered |
list_services | List available service types for a given origin/destination |
list_offices | List Coordinadora branch offices (oficinas) |
create_return | Create a reverse-logistics return guía |
list_returns | List existing return guías |
create_bulk_guias | Create multiple guías in a single batch operation |
Auth
Uses API key + NIT header authentication. Both the API key and company NIT are sent as custom headers with every request.
API Reference
Enterprise
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
Authentication
Set these environment variables before launching the server:
COORDINADORA_API_KEY (required, secret) — API key for CoordinadoraCOORDINADORA_NIT (required) — Company NIT number
Issue credentials at the provider's developer portal: https://coordinadora.docs.apiary.io.
License
MIT