# ESGO

> ESGO is an MCP server for freight and logistics. Search spare truck capacity and publish transport requests on ESGO's freight API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Contact sales
- **Platforms:** API, CLI
- **Website:** https://es-go.de/developers
- **Repository:** https://github.com/esgo-logistics/esgo-mcp
- **MCP Registry name:** io.github.ESGO-Logistics/esgo-mcp
- **Categories:** freight and logistics
- **Listing updated:** 2026-11-15

## About

ESGO is a German platform that matches loads with trucks that would otherwise drive empty. The MCP server wraps its public API, and each API operation becomes one tool, built at start-up from the live OpenAPI spec. A newly added endpoint therefore appears the next time the server starts, with a bundled copy of the spec as fallback. The README calls it alpha.

Four tools exist as of October 2026: me_retrieve to read the account, matches_search to find capacity for a lane, weight and loading metres, open_requests_create to publish a request, and open_requests_list_matches to fetch matches for it. Only open_requests_create changes data, so assistants are expected to ask first. Example weights are in kilograms and times use ISO 8601, with German local time as the default.

There is no self-service sign-up: ESGO issues a key tied to a shipper account. Limits per key are 60 calls a minute, 1,000 an hour and 10,000 a day, with 200 capacity searches and 50 new requests per day, and a search returns up to 25 hits. Prices in results are non-binding estimates, and booking happens on es-go.de via a link in each match. The code is MIT licensed.

## Features

- **Capacity search:** Finds empty-run truck capacity for an origin, destination, weight and loading metres.
- **Open transport requests:** Publishes a request and lists the matches found for it.
- **Spec-driven tools:** Tools are built from the live OpenAPI spec at start-up.
- **Read-only markings:** Only the create tool changes data, so assistants ask before using it.
- **Clear API errors:** Quota and validation errors are passed back as tool errors.
- **SDKs alongside:** Python and .NET libraries share the same API.

## Good for

- Ask for free capacity from Duisburg to Munich for a 12 tonne load
- Publish an open transport request from an ERP-driven assistant
- Check the matches that came back for an open request
- Verify which shipper account an API key belongs to

## Install

### Claude Code (Terminal)

```sh
claude mcp add esgo-mcp --env ESGO_API_KEY='<ESGO_API_KEY>' -- uvx esgo-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "esgo-mcp": {
      "command": "uvx",
      "args": [
        "esgo-mcp"
      ],
      "env": {
        "ESGO_API_KEY": "<ESGO_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "esgo-mcp": {
      "command": "uvx",
      "args": [
        "esgo-mcp"
      ],
      "env": {
        "ESGO_API_KEY": "<ESGO_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "esgo-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "esgo-mcp"
      ],
      "env": {
        "ESGO_API_KEY": "<ESGO_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "esgo-mcp": {
      "command": "uvx",
      "args": [
        "esgo-mcp"
      ],
      "env": {
        "ESGO_API_KEY": "<ESGO_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "esgo-mcp": {
      "command": "uvx",
      "args": [
        "esgo-mcp"
      ],
      "env": {
        "ESGO_API_KEY": "<ESGO_API_KEY>"
      }
    }
  }
}
```

## Tools

- `me_retrieve`: Reads the account tied to the API key.
- `matches_search`: Searches empty-run capacity for a route and load.
- `open_requests_create`: Publishes an open transport request.
- `open_requests_list_matches`: Lists matches for an open request.

## FAQ

### How do I get an API key?

ESGO issues keys; there is no self-service sign-up. Request access at es-go.de/developers.

### How do I run it?

With uvx esgo-mcp, supplying ESGO_API_KEY in the environment; pip install esgo-mcp also works.

### Which tools are there?

me_retrieve, matches_search, open_requests_create and open_requests_list_matches, as of October 2026.

### What are the limits?

Per key: 60 calls a minute, 200 capacity searches and 50 new requests a day.

### Are listed prices binding?

No. They are estimates; the carrier's offer is the firm price and booking happens on es-go.de.

### How much does ESGO cost?

ESGO does not publish prices. Contact the company for a quote.

### How do I add ESGO to Claude Code?

Run this command in your terminal: claude mcp add esgo-mcp --env ESGO_API_KEY='<ESGO_API_KEY>' -- uvx esgo-mcp

### What are the best alternatives to ESGO?

The closest alternatives to ESGO are Lane Cost freight rates, Zentria Flow, Gangway AIS, Cofinal and X3 Compliance.

## Alternatives

- [Lane Cost freight rates](https://ai-powered.com/mcp/lane-cost-freight-rates): Lane Cost freight rates is a free MCP server for freight and logistics.
- [Zentria Flow](https://ai-powered.com/mcp/zentria-flow): Zentria Flow is a freemium MCP server for freight and logistics.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Cofinal](https://ai-powered.com/mcp/cofinal): Cofinal is a paid MCP server for freight and logistics.
- [X3 Compliance](https://ai-powered.com/mcp/x3-compliance): X3 Compliance is a free MCP server for security.
- [RouteMetrics](https://ai-powered.com/mcp/routemetrics): RouteMetrics is a freemium MCP server for maps and travel.
- [Argo Hub Coste de Devoluciones](https://ai-powered.com/mcp/argo-hub-coste-de-devoluciones): Argo Hub Coste de Devoluciones is a free MCP server for freight and logistics.
- [Argo Hub Peso Volumétrico](https://ai-powered.com/mcp/argo-hub-peso-volumetrico): Argo Hub Peso Volumétrico is a free MCP server for freight and logistics.

---
Source: https://ai-powered.com/mcp/esgo
