mcp-coordinadora

Name: mcp-coordinadora
Author: codespar

Local

github.com/codesparMaps & Travel275Updated 4w ago

Repository

About mcp-coordinadora

mcp-coordinadora is an MCP server for Coordinadora, a Colombian courier and logistics company offering domestic and international shipping. It is an alpha release, and endpoint paths have not been fully validated against the live service.

Key features

01Shipment creation, lookup and cancellation
02Tracking and tracking history retrieval
03Shipping rate and service type lookup
04Pickup scheduling and cancellation
05Batch guía creation and return shipments

Use cases

01Letting an agent create shipments and track them for Colombian orders
02Generating multiple guías in one batch
03Checking coverage and scheduling pickups

MCP support

This project is an MCP server that exposes 19 tools to MCP clients for calling the Coordinadora API to handle shipments, pickups, rates and coverage.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "codespar-mcp-coordinadora": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-coordinadora"
      ],
      "env": {
        "COORDINADORA_API_KEY": "<COORDINADORA_API_KEY>",
        "COORDINADORA_NIT": "<COORDINADORA_NIT>"
      }
    }
  }
}

Run commandnpx -y @codespar/mcp-coordinadora

Environment variables to set

COORDINADORA_API_KEYSecretAPI key for Coordinadora

COORDINADORA_NITCompany NIT number

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@codespar/mcp-coordinadora0.2.0-alpha.3stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
sender	object	Yes	Sender information
sender.nit	string	No	Sender NIT/CC
sender.name	string	Yes	Sender name
sender.phone	string	Yes	Sender phone
sender.address	string	Yes	Sender address
packages	array	Yes	Packages to ship
recipient	object	Yes	Recipient information
recipient.nit	string	No	Recipient NIT/CC
recipient.name	string	Yes	Recipient name
recipient.phone	string	Yes	Recipient phone
recipient.address	string	Yes	Recipient address
origin_city	string	Yes	Origin city DANE code
payment_type	string	No	Payment type (prepaid, collect, contra_entrega)
service_type	string	No	Service type (standard, express, same_day)
destination_city	string	Yes	Destination city DANE code

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.