Mcp Coordinadora

io.github.codesparPublished by GitHub account codesparv0.2.0-alpha.3Updated Oct 24, 2026

Coordinadora — Colombian courier and logistics

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Local MCP server for Coordinadora, a Colombian courier, letting an assistant create, track, quote, cancel and return shipments and schedule pickups.

What you can do
Create and cancel shipments, including bulk guías and reverse-logistics returns, and list guías by date range or list returns. Track shipments, fetch full tracking event history and get shipment details by guide number. Quote shipping rates, list service types, cities and branch offices, and check or validate coverage for a city and postal code. Schedule, look up and cancel pickups at an address. Download a guía label as a PDF, returned as base64 or a URL.
When to use it
Useful when an assistant needs to handle Colombian domestic or international shipping through Coordinadora: quoting rates, booking and tracking guías, arranging pickups, or managing returns from a chat or agent workflow.
Requirements
Runs as a local process over stdio, installed from the npm package under the alpha dist-tag. Requires Node.js and two environment variables: COORDINADORA_API_KEY and COORDINADORA_NIT. Optional MCP_HTTP and MCP_PORT enable an HTTP transport. Credentials are issued through the provider's developer portal, and network access to the Coordinadora API is needed.
Before you install
The server is an alpha release whose endpoint paths have not been fully live-validated, so pin exact versions. It sends COORDINADORA_API_KEY and the company NIT as headers on every request. Many tools write or change real logistics data: creating and cancelling shipments, bulk guías, returns and pickups. Creating shipments and pickups may incur real shipping costs.

Installation

In SourceWeft

  1. Open Mcp Coordinadora in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
# Set your credentialsexport COORDINADORA_API_KEY="your-api-key"export COORDINADORA_NIT="your-nit"
# Run via stdionpx tsx packages/colombia/coordinadora/src/index.ts
# Run via HTTPnpx tsx packages/colombia/coordinadora/src/index.ts --http

Environment Variables

VariableRequiredDescription
COORDINADORA_API_KEYYesAPI key from Coordinadora
COORDINADORA_NITYesCompany NIT number
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (19)

ToolPurpose
create_shipmentCreate a new shipment
get_shipmentGet shipment details by guide number
track_shipmentTrack a shipment by guide number
get_ratesGet shipping rates/quotes
list_citiesList available cities for shipping
create_pickupSchedule a pickup at an address
get_coverageCheck if a location is within coverage area
cancel_shipmentCancel a shipment
get_guia_pdfDownload a guía label as PDF (returns base64 or URL)
get_pickupGet pickup (recolección) details by id
cancel_pickupCancel a scheduled pickup (recolección)
get_tracking_historyGet full tracking event history for a guía
list_shipments_by_dateList guías created within a date range
validate_coverageValidate that a city + postal code combination is covered
list_servicesList available service types for a given origin/destination
list_officesList Coordinadora branch offices (oficinas)
create_returnCreate a reverse-logistics return guía
list_returnsList existing return guías
create_bulk_guiasCreate 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 Coordinadora
  • COORDINADORA_NIT (required) — Company NIT number

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

License

MIT

Source: packages/colombia/coordinadora/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0-alpha.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts