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. Vier Werkzeuge: search_plans, get_plan, search_outlines, get_pricing.
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. Er liest denselben Katalog, den auch die JSON-Endpunkte ausliefern.
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.
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.
Nicht enthalten ist eine Flurstücksabfrage: die Katasterdaten liegen als Vektorkacheln und werden im Browser ausgewertet — serverseitig gibt es dafür nichts abzufragen. Wer sie programmatisch 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.