Alvargo MCP Server

The official Model Context Protocol (MCP) server for the Alvargo Freight OS.

Deployed at alvargo.net — fully independent from the main Alvargo platform (alvargo.delivery).

Architecture

alvargo.delivery   →  Main platform (shipper portal, dispatcher, driver app)
alvargo.net        →  This repo — MCP server + landing page

This separation ensures no single point of failure. The MCP server proxies authenticated tool calls to alvargo.delivery but serves its own landing page, discovery manifest, and health endpoint independently.

Related MCP server: Logistics AI MCP

Quick Start (No install needed)

Paste the remote connector URL into Claude:

1. Go to Settings → Connectors → Add custom connector

2. Paste: https://alvargo.net/api/mcp

3. Click Add

Or use the Claude Code CLI:

claude mcp add --transport http alvargo https://alvargo.net/api/mcp

Local Installation (Cursor, Windsurf, Claude Desktop)

{
  "mcpServers": {
    "alvargo": {
      "command": "npx",
      "args": ["-y", "alvargo-mcp-server"]
    }
  }
}

Endpoints

Development

# Install dependencies
npm install

# Copy and fill in environment variables
cp .env.example .env

# Start the dev server (hot reload)
npm run dev

# Build for production
npm run build

# Start production server
npm start

Environment Variables

See .env.example for all required variables. The key one is:

MAIN_APP_URL=https://alvargo.delivery

This tells the MCP server where to proxy authenticated tool calls.

Available Tools

License

MIT © 2026 Alvargo