mcp-skydropx

Name: mcp-skydropx
Author: codespar

Local

github.com/codesparMaps & Travel275Updated 4w ago

Repository

About mcp-skydropx

mcp-skydropx is an MCP server for Skydropx, a Mexican multi-carrier shipping aggregator covering carriers such as Estafeta, DHL, FedEx and Redpack. It is aimed at users who want an AI client to handle shipments, labels and tracking.

Key features

01Create, retrieve and cancel shipments
02Fetch shipping rates and generate labels
03Track parcels and view tracking events
04Validate and manage saved addresses
05Schedule and cancel carrier pickups
06Register webhooks for shipment events

Use cases

01Compare rates and create labels for Mexican orders through an agent
02Check tracking status for multiple parcels
03Schedule carrier pickups and manage pickup records

MCP support

This project is an MCP server that exposes 23 tools to MCP clients for shipping, rates, labels, tracking and pickup operations through the Skydropx API.

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-skydropx": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-skydropx"
      ],
      "env": {
        "SKYDROPX_API_TOKEN": "<SKYDROPX_API_TOKEN>"
      }
    }
  }
}

Run commandnpx -y @codespar/mcp-skydropx

Environment variables to set

SKYDROPX_API_TOKENSecretAPI token for Skydropx

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-skydropx0.2.2stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
parcels	array	Yes	Parcel details
address_to	string	Yes	Destination address ID
address_from	string	Yes	Origin address ID

Details

From the project README

MCP Skydropx

MCP server for Skydropx — Mexican multi-carrier shipping aggregator supporting Estafeta, DHL, FedEx, Redpack, and more.

Quick Start

# Set your API token
export SKYDROPX_API_TOKEN="your-token"

# Run via stdio
npx tsx packages/mexico/skydropx/src/index.ts

# Run via HTTP
npx tsx packages/mexico/skydropx/src/index.ts --http

Environment Variables

Variable	Required	Description
`SKYDROPX_API_TOKEN`	Yes	API token from Skydropx dashboard
`MCP_HTTP`	No	Set to `"true"` to enable HTTP transport
`MCP_PORT`	No	HTTP port (default: 3000)

Tools (23)

Tool	Purpose
`create_shipment`	Create a shipment
`get_shipment`	Get shipment by ID
`list_shipments`	List shipments
`get_rates`	Get shipping rates for a shipment
`create_label`	Create a shipping label for a shipment
`track_shipment`	Track a shipment
`list_carriers`	List available carriers
`create_address`	Create an address
`get_address`	Get address by ID
`cancel_shipment`	Cancel a shipment
`validate_address`	Validate an address (zip, city, province, country)
`list_addresses`	List saved addresses
`list_parcels`	List saved parcel presets
`get_label`	Get a label by ID
`list_labels`	List labels
`create_pickup`	Schedule a carrier pickup
`list_pickups`	List scheduled pickups
`cancel_pickup`	Cancel a scheduled pickup
`get_tracker`	Get tracker (events) by tracker ID
`list_trackers`	List trackers
`create_webhook`	Register a webhook to receive shipment/tracker events
`list_webhooks`	List registered webhooks
`delete_webhook`	Delete a registered webhook

Auth

Uses Bearer token authentication. Obtain your API token from the Skydropx Dashboard.

API Reference

Skydropx 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:

SKYDROPX_API_TOKEN (required, secret) — API token for Skydropx

Issue credentials at the provider's developer portal: https://skydropx.readme.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.