# mcp-andreani

Wires the Andreani courier API into your agent: shipments, tracking, rate quotes and labels handled from the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/argentina/andreani
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-andreani

## What it does

Eighteen tools come with this server, all aimed at Andreani logistics. You can open a shipment, pull its status by tracking number, get a rate quote, generate a label as PDF, cancel an order, look up branches, book a courier pickup or file a return.

Login happens inside the server. It takes your username and password, exchanges them for a JWT, and sends that token along with the API key on every call. Three environment variables are mandatory before it starts: `ANDREANI_API_KEY`, `ANDREANI_USER`, `ANDREANI_PASSWORD`. Miss one and there is nothing to talk to.

The package ships as alpha. Request paths were written against the public docs and have not been validated end to end on the live service, so pin the exact version if you are deploying this for real work — inside the `0.x.x-alpha` line behaviour can shift from build to build.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ANDREANI_API_KEY`, `ANDREANI_USER`, `ANDREANI_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-andreani -e ANDREANI_API_KEY=<ANDREANI_API_KEY> -e ANDREANI_USER=<ANDREANI_USER> -e ANDREANI_PASSWORD=<ANDREANI_PASSWORD> -- npx -y @codespar/mcp-andreani
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add andreani --env ANDREANI_API_KEY=<ANDREANI_API_KEY> --env ANDREANI_USER=<ANDREANI_USER> --env ANDREANI_PASSWORD=<ANDREANI_PASSWORD> -- npx -y @codespar/mcp-andreani
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "andreani": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-andreani"
            ],
            "env": {
                "ANDREANI_API_KEY": "<ANDREANI_API_KEY>",
                "ANDREANI_USER": "<ANDREANI_USER>",
                "ANDREANI_PASSWORD": "<ANDREANI_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "andreani": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-andreani"
            ],
            "env": {
                "ANDREANI_API_KEY": "<ANDREANI_API_KEY>",
                "ANDREANI_USER": "<ANDREANI_USER>",
                "ANDREANI_PASSWORD": "<ANDREANI_PASSWORD>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ANDREANI_API_KEY=<ANDREANI_API_KEY> -e ANDREANI_USER=<ANDREANI_USER> -e ANDREANI_PASSWORD=<ANDREANI_PASSWORD> andreani npx -y @codespar/mcp-andreani
```
Replace <…> with your own values

## When to use it
- book an Andreani shipment without leaving the agent chat
- follow a parcel's progress by tracking number
- quote delivery cost for a given postal code
- export a shipment label as a PDF
- schedule a courier pickup or cancel one

## Example prompts
- Create an Andreani shipment to an address in Córdoba and give me the tracking number
- Show the full tracking history for this tracking number
- Quote shipping to postal code 5000 and list the services available there

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 40 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md