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

GET Pläne-API

[ schwarzplan.eu/wp-json/sp/api/plans ](https://schwarzplan.eu/wp-json/sp/api/plans)Maschinenlesbare Liste aller Pläne mit Koordinaten, Stadt, Land, Maßstab, Formaten, Ebenen, Preis und URL. Paginierbar über ?per\_page=N.

GET Outlines-API

[ schwarzplan.eu/wp-json/sp/api/outlines ](https://schwarzplan.eu/wp-json/sp/api/outlines)Index aller freien Stadt-, Länder- und Kontinent-Outlines mit direkten GeoJSON- und SVG-URLs.

POST MCP-Server

[ schwarzplan.eu/wp-json/sp/mcp/v1 ](https://schwarzplan.eu/wp-json/sp/mcp/v1)Model Context Protocol über Streamable HTTP, JSON-RPC 2.0, ohne Anmeldung. Vier Werkzeuge: search\_plans, get\_plan, search\_outlines, get\_pricing.

GET llms.txt

[ schwarzplan.eu/llms.txt ](https://schwarzplan.eu/llms.txt)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.

[Geodaten & Outlines →](https://schwarzplan.eu/geodaten/) [Alle Pläne →](https://schwarzplan.eu/lageplan-shop/) [llms.txt →](https://schwarzplan.eu/llms.txt)