ESGO

io.github.ESGO-LogisticsPublished by GitHub account ESGO-Logisticsv0.1.1Updated Oct 28, 2026

ESGO API for AI assistants: search empty-run truck capacity and publish transport requests

VerifiedSTDIODesktop onlyLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

ESGO MCP server lets an AI assistant search empty-run truck capacity in road freight and publish open transport requests via the ESGO API.

What you can do
  • Check the authenticated ESGO account profile
  • Search matching empty-run freight capacity by route, weight and date
  • Create open transport requests
  • List matches for an existing open transport request
  • Tools are generated at start-up from the live ESGO OpenAPI spec, so new endpoints appear after a restart
When to use it
Useful for freight forwarders, shippers or dispatchers who have ESGO API access and want to find free truck capacity or post transport requests in plain language from an AI assistant.
Requirements
Runs locally as a stdio process started by the AI app; needs uv (uvx) or pip install of the esgo-mcp package. Requires an ESGO API key in ESGO_API_KEY, requested from ESGO (no self-service sign-up). Optional ESGO_BASE_URL overrides the default API base URL. Network access to the ESGO API is needed.
Before you install
The ESGO_API_KEY secret is stored in your local MCP configuration and sent to the ESGO API. The open_requests_create tool writes data by publishing a real transport request, so confirm before the assistant calls it. API errors such as daily quota limits are returned to the assistant. The project is marked alpha.

Installation

In SourceWeft

  1. Open ESGO 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

ESGO MCP server

Deutsche Version weiter unten

Lets AI assistants (Claude, Cursor, VS Code, Windsurf and others that speak the Model Context Protocol) use the ESGO API: search for matching empty-run capacity in road freight and publish open transport requests, in plain language.

"Find free capacity from 47057 Duisburg to 80331 München for 12 t next week."

Alpha. The tools follow the ESGO API v1 automatically (see below).

How it works

Every operation of the ESGO API becomes one tool, built at start-up from the live OpenAPI spec at api.es-go.de/v1/openapi.json. When ESGO adds an endpoint, it is available as a tool the next time the server starts, without updating this package. If the API cannot be reached at start-up, the server uses the copy of the spec it ships with.

Tools that only read (me_retrieve, matches_search, open_requests_list_matches) are marked read-only; tools that create data (open_requests_create) are not, so your assistant asks before calling them.

Access

You need an ESGO API key; there is no self-service sign-up yet. Request access at es-go.de/developers. The key stays on your machine and is only sent to the ESGO API.

Installation

The server runs locally and is started by your AI app. You need uv; uvx downloads and runs the package on demand.

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json), Windsurf and others with the same format:

json
{  "mcpServers": {    "esgo": {      "command": "uvx",      "args": ["esgo-mcp"],      "env": { "ESGO_API_KEY": "esgo_live_..." }    }  }}

Claude Code:

sh
claude mcp add esgo -e ESGO_API_KEY=esgo_live_... -- uvx esgo-mcp

VS Code (.vscode/mcp.json):

json
{  "servers": {    "esgo": {      "command": "uvx",      "args": ["esgo-mcp"],      "env": { "ESGO_API_KEY": "esgo_live_..." }    }  }}

Without uv: pip install esgo-mcp, then use esgo-mcp as the command.

VariableMeaning
ESGO_API_KEYyour ESGO API key (required for calls)
ESGO_BASE_URLoptional, default https://api.es-go.de

Tools (as of October 2026)

The list comes from the API itself, so it may already be longer when you read this.

ToolEndpointChanges data
me_retrieveGET /v1/meno
matches_searchPOST /v1/matches/searchno
open_requests_createPOST /v1/open-requestsyes
open_requests_list_matchesGET /v1/open-requests/{request_id}/matchesno

Errors of the API (for example [429] daily_quota_exceeded or [422] invalid_parameter (param: weight_kg)) are returned to the assistant as tool errors, so it can correct the input or tell you.

Related

License

MIT, see LICENSE.

ESGO MCP server (Deutsch)

Damit können KI-Assistenten (Claude, Cursor, VS Code, Windsurf und andere, die das Model Context Protocol sprechen) die ESGO API nutzen: passende Leerfahrten im Straßengüterverkehr suchen und offene Transportanfragen einstellen, in normaler Sprache.

So funktioniert es: Jeder Endpunkt der ESGO API wird zu einem Werkzeug. Der Server baut die Werkzeuge beim Start aus der aktuellen OpenAPI-Spezifikation. Neue Endpunkte sind damit beim nächsten Start da, ohne Update dieses Pakets. Ist die API beim Start nicht erreichbar, nimmt der Server die mitgelieferte Kopie. Werkzeuge, die Daten anlegen, sind entsprechend markiert; der Assistent fragt vorher nach.

Zugang: Du brauchst einen API-Schlüssel von ESGO, anzufragen unter es-go.de/developers. Der Schlüssel bleibt auf deinem Rechner und geht nur an die ESGO API.

Einrichtung: siehe die Konfigurationsbeispiele oben. Benötigt wird uv; uvx esgo-mcp lädt und startet das Paket.

Lizenz: MIT, siehe LICENSE.

Source: README.md at commit 48107ac

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestOct 18, 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