For agents, LLMs & developers
MCP & API
Schwarzplan.eu makes its plans and free geodata available programmatically – as lean JSON APIs, as an llms.txt index and via the Model Context Protocol (MCP). This lets AI agents and LLMs query, cite and process the catalogue and geodata directly.
Endpunkte
Machine-readable list of all plans with coordinates, city, country, scale, formats, layers, price and URL. Paginate via ?per_page=N.
Index of all free city, country and continent outlines with direct GeoJSON and SVG URLs.
Model Context Protocol over Streamable HTTP, JSON-RPC 2.0, no authentication. Four tools: search_plans, get_plan, search_outlines, get_pricing.
Compact, link-oriented Markdown index of the key resources in the llmstxt.org format – for assistants like ChatGPT, Claude and Perplexity.
Beispiel
# Fetch first 20 plans
curl "https://schwarzplan.eu/wp-json/sp/api/plans?per_page=20"
# All free outlines (cities / countries / continents)
curl "https://schwarzplan.eu/wp-json/sp/api/outlines"Model Context Protocol (MCP)
The Model Context Protocol is an open standard through which AI assistants connect external tools. Our server runs at the address above — stateless, no sign-up, no key. It reads the same catalogue the JSON endpoints serve.
Tools
search_plans
Searches plans by city, country or region. Returns title, location, scale, formats, price and URL.
get_plan
Everything about one plan: scale, layers, formats, price, coordinates, description.
search_outlines
Searches the free outlines and returns direct GeoJSON and SVG URLs.
get_pricing
Pricing model: single plan, bundle, Access All Plans, free plans, licence scope.
Setup
{
"mcpServers": {
"schwarzplan": {
"type": "http",
"url": "https://schwarzplan.eu/wp-json/sp/mcp/v1"
}
}
}In clients that expect only a server URL (ChatGPT and Claude connectors), the address on its own is enough.
A parcel lookup is not included: the cadastral data lives as vector tiles and is evaluated in the browser — there is nothing to query server-side. If you need it programmatically, write to us.
Lizenz & Nutzung
Country outlines: Natural Earth (public domain). City outlines: derived from OpenStreetMap (ODbL – attribution & share-alike). Continent outlines: our own stylised shapes.
Die kostenpflichtigen Pläne selbst unterliegen der jeweiligen Produktlizenz. Die Endpunkte liegen hinter einem Server-Cache; bitte bei automatisierter Nutzung fair bleiben und Antworten selbst zwischenspeichern, statt eng zu pollen.