@codespar/mcp-coordinadora

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

# Set your credentials
export COORDINADORA_API_KEY="your-api-key"
export COORDINADORA_NIT="your-nit"

# Run via stdio
npx tsx packages/colombia/coordinadora/src/index.ts

# Run via HTTP
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)

Tools (19)

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

• Coordinadora API Docs

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 Coordinadora
• COORDINADORA_NIT (required) — Company NIT number

Issue credentials at the provider's developer portal: https://coordinadora.docs.apiary.io.

License

MIT