# API und MCP-Server

Ausschreibungen und Zuschläge aus Deutschland direkt in Claude, ChatGPT oder Ihren eigenen Programmen. Kostenlos und ohne Anmeldung.

## Mit Claude oder ChatGPT verbinden

Über das Model Context Protocol (MCP) fragt Ihr KI-Assistent unsere Daten selbst ab und antwortet mit Links auf die Ausschreibungen. Sie brauchen dafür nur diese Adresse:

`https://vergabeweiser.de/mcp`

- **Claude** (claude.ai und Desktop-App): Einstellungen, Konnektoren, „Benutzerdefinierten Konnektor hinzufügen“. Name „Vergabeweiser“, die Adresse oben, keine Anmeldung.
- **ChatGPT**: In den Einstellungen unter „Apps und Konnektoren“ den Entwicklermodus einschalten, dann einen Konnektor mit der Adresse oben anlegen, Authentifizierung „Keine“. Welche ChatGPT-Tarife eigene Konnektoren erlauben, legt OpenAI fest; unsere Schnittstelle selbst ist kostenlos und ohne Anmeldung nutzbar.
- **Claude Code**, Cursor, VS Code und andere Programme mit MCP: als HTTP-Server eintragen, zum Beispiel `claude mcp add --transport http vergabeweiser https://vergabeweiser.de/mcp`

In Team- und Enterprise-Konten richtet den Konnektor der Administrator ein. Die Menüs der Anbieter ändern sich öfter. Steht etwas anders da, suchen Sie nach „Konnektor“ oder „MCP-Server“.

## Was der KI-Assistent abfragen kann

| Werkzeug | Liefert |
| --- | --- |
| `search_tenders` | Ausschreibungen suchen: Freitext mit Gewerk und Ort („Gebäudereinigung Rosenheim“), Umkreis, Status, Bundesland, Verfahren. |
| `get_tender` | Eine Ausschreibung: alle Fristen, Verfahren, Lose, Ergebnis mit Gewinnern, Summen und Zahl der Angebote, Link zu den Vergabeunterlagen. |
| `find_organisations` | Vergabestelle oder Firma nach Namen finden, zum Beispiel „Stadt Köln“ oder „Fraunhofer“. |
| `get_buyer` | Eine Vergabestelle: offene Ausschreibungen, letzte Zuschläge, Angebote je Zuschlag, häufige Gewinner, auslaufende Verträge. |
| `get_company_awards` | Zuschläge einer Firma mit eigener Seite: Auftraggeber, Länder, Gewerke, veröffentlichte Summen. |
| `market_stats` | Markt eines Gewerks in Deutschland, einem Bundesland oder Kreis: Ausschreibungen in 12 Monaten, Wettbewerb, typische Summen. |
| `expiring_contracts` | Verträge, die laut Bekanntmachung in den nächsten Monaten enden: Kandidaten für eine neue Ausschreibung. |
| `list_categories` | Kürzel aller Gewerke und Bundesländer für die anderen Werkzeuge. |

Alle Werkzeuge lesen nur. Jede Antwort enthält die Quelle mit Datenstand und den Link auf die Seite bei Vergabeweiser.

## Beispielfragen

- „Welche Ausschreibungen für Gebäudereinigung sind im Umkreis von 50 km um Rosenheim gerade offen? Sortiere nach Frist.“
- „Fasse mir die Ausschreibung https://vergabeweiser.de/ausschreibung/… zusammen: Fristen, Lose, Ergebnis und Link zu den Unterlagen.“
- „Wie viele Angebote bekommen Vergabestellen in Bayern bei Dachdeckerarbeiten im Schnitt, und welche Summen sind üblich?“
- „Welche Verträge für Winterdienst in Nordrhein-Westfalen laufen in den nächsten 6 Monaten aus?“
- „Welche Zuschläge hat diese Firma in den letzten Jahren bekommen, und bei welchen Auftraggebern?“

Der Assistent formuliert die Antwort selbst. Prüfen Sie Fristen und Bedingungen immer in der Bekanntmachung und den Vergabeunterlagen.

## REST-API

Dieselben Daten als JSON, für Tabellen, eigene Programme oder Automatisierungen. Basisadresse: `https://vergabeweiser.de/api/v1`. Die vollständige Beschreibung steht als [OpenAPI-Datei](https://vergabeweiser.de/api/openapi.json) bereit.

| GET | Inhalt |
| --- | --- |
| `/tenders` | Suche wie auf /suche. Parameter: was, wo, km, status, branche, land, gruppe, verfahren, wert, sort, seite. |
| `/tenders/{id}` | Eine Ausschreibung, id = die 8 bis 12 Zeichen am Ende der URL. |
| `/organisations` | Vergabestellen und Firmen nach Namen. Parameter: name (Pflicht, ab drei Zeichen), typ (vergabestelle oder unternehmen). |
| `/buyers/{slug}` | Eine Vergabestelle, slug aus /vergabestelle/{slug}. |
| `/companies/{slug}` | Zuschläge einer Firma, slug aus /unternehmen/{slug}, Parameter seite. |
| `/market` | Marktzahlen. Parameter: branche (Pflicht), land, kreis. |
| `/expiring` | Auslaufende Verträge. Parameter: branche, land oder vergabestelle (mindestens eins), monate (1 bis 36). |

Beispiel: offene Reinigungsausschreibungen um Rosenheim.

```
curl "https://vergabeweiser.de/api/v1/tenders?was=Reinigung&wo=Rosenheim&km=50"
```

Antworten enthalten `understood` (wie wir die Suche verstanden haben), `results` mit Frist, Auftraggeber, Ort, Wert und `url`, und `source` mit Quelle, Lizenz und Datenstand. Fehler kommen als JSON mit `error` und `message`.

## Limits und Schlüssel

- Ohne Schlüssel: 60 Abfragen pro Stunde je Anschluss für die REST-API, 600 für den MCP-Server.
- Mit kostenlosem Schlüssel: 1.000 Abfragen am Tag für die REST-API. Senden Sie ihn als `Authorization: Bearer vw_…` oder `X-Api-Key: vw_…`.
- Wird ein Limit erreicht, antworten wir mit Status 429 und `Retry-After`.

Einen Schlüssel erzeugen Sie in [Ihrem Konto](https://vergabeweiser.de/konto#api). Anmelden geht ohne Passwort.

## Daten und Regeln

- Quelle sind die Bekanntmachungen des Bekanntmachungsservice (oeffentlichevergabe.de, Lizenz CC0). Wir laden sie jeden Morgen. Ältere Verfahren bis 12.12.2022 stammen aus TED (ted.europa.eu, © Europäische Union): nicht CC0, Weiterverwendung nur mit Quellenangabe. `notice_source` nennt die Quelle je Ausschreibung.
- Maßgeblich sind immer die Bekanntmachung und die Vergabeunterlagen des Auftraggebers. Vollständigkeit und Aktualität sagen wir nicht zu; die Haftung regeln die Nutzungsbedingungen. Nicht jede Vergabe wird veröffentlicht.
- Vergabeunterlagen liefern wir nicht aus. Die Antworten verlinken die Plattform des Auftraggebers.
- Titel mit `title_ki_generated: true` sind KI-generiert; der Originaltitel steht in `original_title`.
- Einzelunternehmen erscheinen nur als „Einzelunternehmen aus …“. Versuchen Sie nicht, sie zu identifizieren. Namen und persönliche Kontaktdaten von Ansprechpersonen filtern wir beim Import heraus.
- Die Rohdaten aus dem Bekanntmachungsservice stehen unter CC0. Für unsere Aufbereitung (Klartext-Titel, Zuordnung zu Gewerken, Orten und Firmen, Kennzahlen) gilt [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/deed.de): Nutzung auch gewerblich, mit Quellenangabe „Vergabeweiser“ und Link auf die Seite aus `url`.
- Nutzen Sie die Daten nicht für unerwünschte Werbung an Firmen oder Vergabestellen (§ 7 UWG).
- Die Schnittstelle ist kostenlos und ohne Zusage zur Verfügbarkeit. Version 1 soll stabil bleiben; größere Änderungen kündigen wir vorher auf dieser Seite an. Bei Missbrauch oder Störung des Betriebs können wir Schlüssel sperren und Zugriffe begrenzen.
- Für die Nutzung gelten unsere [Nutzungsbedingungen](https://vergabeweiser.de/nutzungsbedingungen#api). Wie wir dabei mit Ihren Daten umgehen, steht in der [Datenschutzerklärung](https://vergabeweiser.de/datenschutz#api).

Stand: 25.10.2026. [Fehler melden](https://vergabeweiser.de/fehler-melden)

---
Markdown-Fassung der Seite https://vergabeweiser.de/api auf Vergabeweiser.