mcp-andreani

MCP Andreani

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 Andreani — the largest Argentine courier and logistics company, providing domestic and international shipping services.

Quick Start

# Set your credentials
export ANDREANI_API_KEY="your-api-key"
export ANDREANI_USER="your-username"
export ANDREANI_PASSWORD="your-password"

# Run via stdio
npx tsx packages/argentina/andreani/src/index.ts

# Run via HTTP
npx tsx packages/argentina/andreani/src/index.ts --http

Environment Variables

Variable	Required	Description
ANDREANI_API_KEY	Yes	API key from Andreani
ANDREANI_USER	Yes	Username for authentication
ANDREANI_PASSWORD	Yes	Password for authentication
MCP_HTTP	No	Set to "true" to enable HTTP transport
MCP_PORT	No	HTTP port (default: 3000)

Tools (18)

Tool	Purpose
create_shipment	Create a new shipment
get_shipment	Get shipment details by ID
track_shipment	Track a shipment by tracking number
get_rates	Get shipping rates/quotes
list_branches	List Andreani branches/sucursales
create_label	Generate a shipping label for a shipment
get_tracking_history	Get full tracking history for a shipment
cancel_shipment	Cancel a shipment
get_label_pdf	Download a shipping label as PDF (base64-encoded)
list_tracking_by_date	List tracking events for a contract within a date range
validate_postal_code	Validate CP coverage and list available services for a postal code
create_pickup	Create a pickup/collection request (retiro)
list_pickups	List pickup/collection requests
cancel_pickup	Cancel a pickup/collection request
create_return	Create a reverse logistics shipment (logística inversa / devolución)
list_returns	List reverse logistics shipments (returns)
list_products	List contracted products/services available on the account
get_invoice	Get billing/invoice details

Auth

Uses Bearer token authentication. The server logs in with username/password to obtain a JWT token, which is used for subsequent API calls. An API key header is also included.

API Reference

• Andreani 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:

• ANDREANI_API_KEY (required, secret) — API key for Andreani
• ANDREANI_USER (required) — Username for Andreani
• ANDREANI_PASSWORD (required, secret) — Password for Andreani

Issue credentials at the provider's developer portal: https://developers.andreani.com.

License

MIT