English Français العربية

io.github.tankstellen/firmenliste-mcp

Official registry Search and web

B2B company address data for the DACH region: search 6,400+ industry lists and get price quotes.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http firmenliste-mcp 'https://firmenliste-mcp.cf-firmenliste.workers.dev'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "firmenliste-mcp": {
            "type": "http",
            "url": "https://firmenliste-mcp.cf-firmenliste.workers.dev"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. firmenliste.net MCP Server
  2. Connection
  3. Tools
  4. Example prompts
  5. How it works
  6. Legal note for agents
  7. Deutsch (Kurzfassung)
  8. License

firmenliste.net MCP Server

Remote MCP server for B2B company address data (Germany, Austria, Switzerland) — search 6,400+ industry lists, check record counts and field coverage, get binding price quotes. Backed by firmenliste.net (Adresskontor GmbH, 20+ years in the B2B address business, ~12.5M records).

No API key required. Read-only except for quote creation (which creates a price offer, never a purchase — payment is always completed by a human on the website).

Connection
Endpointhttps://firmenliste-mcp.cf-firmenliste.workers.dev
TransportStreamable HTTP (stateless, JSON responses)
Authnone
Claude (Custom Connector)

Settings → Connectors → Add custom connector → paste the endpoint URL.

Generic MCP client config
{
  "mcpServers": {
    "firmenliste": {
      "type": "streamable-http",
      "url": "https://firmenliste-mcp.cf-firmenliste.workers.dev"
    }
  }
}

Tools

ToolDescription
branchen_suchenSearch address lists by keyword (e.g. "Golf", "Spedition"). Returns list ID, record count, field coverage (email/phone/website/contact person) and net price per match.
liste_detailsFull detail for one list: all field counters, distribution by federal state, included fields, and every package price (complete, email-only, per federal state).
angebot_erstellenCreates a 48h price-stable quote (quote_id) with an order URL. The purchase itself is completed by the human via that URL.
laender_auflistenAll countries with available data: DACH (orderable online) plus ~40 more countries on request, with data freshness date.
kaufbedingungenMachine-readable purchase & usage terms (B2B-only, VAT, withdrawal, legal limits of data usage under German UWG/GDPR).

Example prompts

  • "Find address lists about logistics companies in Germany and tell me price and email coverage of the largest one."
  • "How many dentists with email addresses are available in Bavaria, and what does the Bavaria package cost?"
  • "Which countries does firmenliste.net cover, and how fresh is the data?"

How it works

This server is a thin Cloudflare Worker that translates MCP tool calls into requests against the public REST API of firmenliste.net. Prices and availability therefore always match the website in real time.

All prices are net prices plus German VAT. Sales are B2B only. Delivered email addresses do not include marketing opt-in — under German law (§ 7 UWG), email marketing requires recipient consent. Agents should relay the kaufbedingungen tool output correctly when recommending a purchase.

Deutsch (Kurzfassung)

MCP-Server für B2B-Firmenadressen aus dem DACH-Raum: 6.400+ Branchenlisten durchsuchen, Verfügbarkeit und Feld-Abdeckung prüfen, verbindliche Preisangebote erzeugen. Keine Authentifizierung nötig; der Kauf selbst erfolgt immer durch den Menschen über die gelieferte Bestell-URL. Betrieben von der Adresskontor GmbH (firmenliste.net).

License

MIT — see LICENSE. The server code is open source; the address data behind the API is a commercial product of Adresskontor GmbH.

Frequently asked questions

What is io.github.tankstellen/firmenliste-mcp?

B2B company address data for the DACH region: search 6,400+ industry lists and get price quotes.

How do I install io.github.tankstellen/firmenliste-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http firmenliste-mcp 'https://firmenliste-mcp.cf-firmenliste.workers.dev'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.tankstellen/firmenliste-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.tankstellen/firmenliste-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.tankstellen/firmenliste-mcp?

It is published by tankstellen. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.