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

GET Plans API

[ schwarzplan.eu/wp-json/sp/api/plans ](https://schwarzplan.eu/wp-json/sp/api/plans)Machine-readable list of all plans with coordinates, city, country, scale, formats, layers, price and URL. Paginate via ?per\_page=N.

GET Outlines-API

[ schwarzplan.eu/wp-json/sp/api/outlines ](https://schwarzplan.eu/wp-json/sp/api/outlines)Index of all free city, country and continent outlines with direct GeoJSON and SVG URLs.

POST MCP server

[ schwarzplan.eu/wp-json/sp/mcp/v1 ](https://schwarzplan.eu/wp-json/sp/mcp/v1)Model Context Protocol over Streamable HTTP, JSON-RPC 2.0, no authentication. Four tools: search\_plans, get\_plan, search\_outlines, get\_pricing.

GET llms.txt

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

[Geodata & Outlines →](https://schwarzplan.eu/geodaten/) [All plans →](https://schwarzplan.eu/en/site-plan-figure-ground-plan-shop/) [llms.txt →](https://schwarzplan.eu/llms.txt)