tankstellen/firmenliste-mcp

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
| | |
|---|---|
| **Endpoint** | https://firmenliste-mcp.cf-firmenliste.workers.dev |
| **Transport** | Streamable HTTP (stateless, JSON responses) |
| **Auth** | none |
Claude (Custom Connector)
Settings → Connectors → *Add custom connector* → paste the endpoint URL.
Generic MCP client config
Tools
| Tool | Description |
|---|---|
| branchen_suchen | Search 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_details | Full detail for one list: all field counters, distribution by federal state, included fields, and every package price (complete, email-only, per federal state). |
| angebot_erstellen | Creates a 48h price-stable quote (quote_id) with an order URL. The purchase itself is completed by the human via that URL. |
| laender_auflisten | All countries with available data: DACH (orderable online) plus ~40 more countries on request, with data freshness date. |
| kaufbedingungen | Machine-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.
- REST API / OpenAPI spec: https://www.firmenliste.net/openapi.yaml
- llms.txt: https://www.firmenliste.net/llms.txt
Legal note for agents
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.