Für Agenten, LLMs & Entwickler
MCP & API
Schwarzplan.eu stellt seine Pläne und freien Geodaten programmatisch bereit – als schlanke JSON-APIs, als llms.txt-Index und über das Model Context Protocol (MCP). So können KI-Agenten und LLMs die Katalog- und Geodaten direkt abfragen, zitieren und weiterverarbeiten.
Endpunkte
Maschinenlesbare Liste aller Pläne mit Koordinaten, Stadt, Land, Maßstab, Formaten, Ebenen, Preis und URL. Paginierbar über ?per_page=N.
Index aller freien Stadt-, Länder- und Kontinent-Outlines mit direkten GeoJSON- und SVG-URLs.
Model Context Protocol über Streamable HTTP, JSON-RPC 2.0, ohne Anmeldung. Sechs Werkzeuge: search_plans, get_plan, search_outlines, get_pricing, find_parcel, setback_rules.
Kompakter, link-orientierter Markdown-Index der wichtigsten Ressourcen im llmstxt.org-Format – für Assistenten wie ChatGPT, Claude und Perplexity.
Beispiel
# Erste 20 Pläne abrufen
curl "https://schwarzplan.eu/wp-json/sp/api/plans?per_page=20"
# Alle freien Outlines (Städte / Länder / Kontinente)
curl "https://schwarzplan.eu/wp-json/sp/api/outlines"Model Context Protocol (MCP)
Das Model Context Protocol ist ein offener Standard, über den KI-Assistenten externe Werkzeuge anbinden. Unser Server läuft unter der Adresse oben — zustandslos, ohne Anmeldung, ohne Schlüssel. Die Katalog-Werkzeuge lesen denselben Katalog wie die JSON-Endpunkte, find_parcel und setback_rules das Liegenschaftskataster und die Landesbauordnungen.
Werkzeuge
search_plans
Sucht Pläne nach Stadt, Land oder Region. Liefert Titel, Ort, Maßstab, Formate, Preis und URL.
get_plan
Alle Angaben zu einem Plan: Maßstab, Ebenen, Formate, Preis, Koordinaten, Beschreibung.
search_outlines
Durchsucht die kostenlosen Umrisse und gibt direkte GeoJSON- und SVG-URLs zurück.
get_pricing
Preismodell: Einzelplan, Bundle, Access All Plans, kostenlose Pläne, Lizenzumfang.
find_parcel
Flurstück unter einer Adresse oder Koordinate in Deutschland: Kennzeichen, Gemarkung, Flur, Fläche, Grenze als GeoJSON, Lizenzvermerk und Bestell-Link.
setback_rules
Abstandsflächen nach Landesbauordnung: Faktor, Mindesttiefe und erforderliche Tiefe für eine Wandhöhe, mit Fundstelle.
Einrichtung
{
"mcpServers": {
"schwarzplan": {
"type": "http",
"url": "https://schwarzplan.eu/wp-json/sp/mcp/v1"
}
}
}In Clients, die nur eine Server-URL erwarten (ChatGPT- und Claude-Connectors), genügt die Adresse selbst.
Beispiel: Flurstück zu einer Adresse
curl "https://schwarzplan.eu/wp-json/sp/mcp/v1" \
-H "content-type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_parcel","arguments":{"address":"Bundeskanzlerplatz 2, Bonn"}}}'Flurstücke: find_parcel deckt 15 Bundesländer ab, aus dem amtlichen Liegenschaftskataster (ALKIS, Open Data, Lizenzvermerk je Land in jeder Antwort). Bayern veröffentlicht keine Flurstücksdaten. Kein amtlicher Auszug. Höchstens 60 Abfragen je Stunde und IP – wer mehr braucht, schreibt uns.
Lizenz & Nutzung
Länder-Outlines: Natural Earth (gemeinfrei). Stadt-Outlines: aus OpenStreetMap abgeleitet (ODbL – Namensnennung & Share-alike). Kontinent-Umrisse: eigene stilisierte Formen.
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.