Mcp Andreani

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

Andreani — Argentine courier and logistics

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Local MCP server for Andreani, the Argentine courier, letting an assistant create, track, label, cancel and return shipments and manage pickups.

What you can do
Create, retrieve, track and cancel shipments, including full tracking history and tracking events by date range for a contract.Quote shipping rates, validate postal code coverage and list available services, and list Andreani branches.Generate shipping labels and download them as base64-encoded PDF.Create, list and cancel pickup requests.Manage reverse logistics: create and list returns.List contracted products and retrieve billing or invoice details.
When to use it
Useful when an assistant needs to work with Argentine shipping through an Andreani account: quoting rates, booking or tracking parcels, producing labels, arranging pickups, handling returns or checking invoices.
Requirements
Runs as a local process via npm package @codespar/mcp-andreani (stdio, optionally HTTP with MCP_HTTP and MCP_PORT). Requires an Andreani account and the environment variables ANDREANI_API_KEY, ANDREANI_USER and ANDREANI_PASSWORD. Network access to the Andreani API is needed.
Before you install
Requires three credentials, including the secrets ANDREANI_API_KEY and ANDREANI_PASSWORD, which the server uses to log in and obtain a token. Many tools change real logistics data: creating, cancelling and returning shipments, creating and cancelling pickups, and generating labels. The README marks it an alpha release whose endpoints have not been fully live-validated, so pin exact versions.

Installation

In SourceWeft

  1. Open Mcp Andreani 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 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

bash
# Set your credentialsexport ANDREANI_API_KEY="your-api-key"export ANDREANI_USER="your-username"export ANDREANI_PASSWORD="your-password"
# Run via stdionpx tsx packages/argentina/andreani/src/index.ts
# Run via HTTPnpx tsx packages/argentina/andreani/src/index.ts --http

Environment Variables

VariableRequiredDescription
ANDREANI_API_KEYYesAPI key from Andreani
ANDREANI_USERYesUsername for authentication
ANDREANI_PASSWORDYesPassword for authentication
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (18)

ToolPurpose
create_shipmentCreate a new shipment
get_shipmentGet shipment details by ID
track_shipmentTrack a shipment by tracking number
get_ratesGet shipping rates/quotes
list_branchesList Andreani branches/sucursales
create_labelGenerate a shipping label for a shipment
get_tracking_historyGet full tracking history for a shipment
cancel_shipmentCancel a shipment
get_label_pdfDownload a shipping label as PDF (base64-encoded)
list_tracking_by_dateList tracking events for a contract within a date range
validate_postal_codeValidate CP coverage and list available services for a postal code
create_pickupCreate a pickup/collection request (retiro)
list_pickupsList pickup/collection requests
cancel_pickupCancel a pickup/collection request
create_returnCreate a reverse logistics shipment (logística inversa / devolución)
list_returnsList reverse logistics shipments (returns)
list_productsList contracted products/services available on the account
get_invoiceGet 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

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

Source: packages/argentina/andreani/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