Skip to main content
Glama
vergabe-mcp

vergabe-mcp

by jocks-studio

vergabe-mcp

CI npm

Ein MCP-Server für oeffentlichevergabe.de, das deutsche Bundesportal für öffentliche Ausschreibungen. Deutschland veröffentlicht dort jede öffentliche Ausschreibung und bietet einen Bulk-Open-Data-Export an, der jedoch einen Tag hinterherhinkt, als tägliche ZIPs ausgeliefert wird und keine Filterung erlaubt – Sie laden alles herunter und sortieren selbst. Die eigene Such-API des Portals kann filtern (CPV-Code, Region, Fristfenster, das eForms-Flag „geeignet für Freiberufler“) und ist aktuell, sobald eine Bekanntmachung live geht, ist aber undokumentiert. Dieser Server kapselt sie, sodass jeder MCP-Client den Live-Feed mit echten Filtern durchsuchen und eine Bekanntmachung im Domänenmodell des Portals, als eForms-XML oder als OCDS abrufen kann. Anonym, kein API-Schlüssel, kein Konto.

Die reverse-engineerte API-Referenz befindet sich in docs/API.md – sie ist eigenständig nutzbar, wenn Sie die Endpunkte direkt statt über MCP aufrufen möchten.

Installation

Nichts zu installieren; führen Sie es mit npx aus.

Claude Code

claude mcp add vergabe -- npx vergabe-mcp

Claude Desktop – in claude_desktop_config.json:

{
  "mcpServers": {
    "vergabe": {
      "command": "npx",
      "args": ["vergabe-mcp"]
    }
  }
}

Jeder andere stdio-Client

npx vergabe-mcp

Streamable HTTP, falls Ihr Client eine URL statt eines Subprozesses benötigt:

npx vergabe-mcp --http --port 3000

Related MCP server: germany-tenders

Werkzeuge

Werkzeug

Was es tut

search_tenders

Durchsucht Lose mit flachen Parametern – Freitext, CPV-Präfixe, suitableFor, Vertragsart, NUTS-Region, Plattform, Frist- und Veröffentlichungsfenster, Seitenumbruch, Sortierung. Gibt normalisierte Ergebnisse zurück.

get_tender

Eine Bekanntmachung anhand der ID, als kuratierte summary (Standard) oder wörtliches domain-JSON, eforms-XML oder ocds-JSON.

search_tenders_raw

Die native SELECT/FROM/WHERE/PAGE/ORDER-DSL, durchgereicht und roh zurückgegeben – für alles, was das kuratierte Werkzeug nicht abbildet.

lookup_code

Löst einen CPV- oder NUTS-Code in seine deutsche oder englische Beschreibung auf.

get_export_url

Erstellt die Bulk-Open-Data-Export-URL für einen Tag oder Monat, mit den zugehörigen Hinweisen.

Alle fünf sind schreibgeschützt; der Server schreibt nichts, speichert nichts auf der Festplatte und besitzt keine Anmeldedaten.

Ressourcen. vergabe://api-reference liefert das API-Dokument, sodass ein Client lesen kann, was das Backend tatsächlich unterstützt, bevor er eine Abfrage zusammenstellt. Vorlagen decken einzelne Bekanntmachungen ab – vergabe://notice/{noticeId}, .../eforms, .../ocds – und vergabe://codelist/{list}/{code}.

Prompt. find-solo-tenders (Argumente: keywords, cpv, maxDays) sucht mit den Freiberufler-/Selbstständigen-Flags und führt dann das Modell durch die Sichtung der Kandidaten: Personentage, die in der Beschreibung versteckt sind, ob die nahende Frist eine Aufforderung zur Teilnahme oder das Angebot selbst ist, und die Tatsache, dass ein leeres Wertfeld nichts bedeutet. Dieses Sichtungswissen wird als Prompt und nicht als Bewertungscode ausgeliefert, sodass Sie darüber diskutieren können.

Beispiel

Sie: Finden Sie offene IT-Ausschreibungen, die als für Freiberufler geeignet gekennzeichnet sind.

Das Modell ruft search_tenders mit cpv: ["72"], suitableFor: ["freelance"], onlyActive: true auf. Am 17.08.2026 sind das 30 offene Lose, darunter:

{
  "noticeId": "7c70692d-dfb9-4b96-b777-4a5539eaee50",
  "title": "Beschaffung einer Beratungsdienstleistung zur Fachberatung im Rahmen eines Identity and Access Management (IAM) Projektes für die Stadtwerke Bielefeld (SWB)",
  "lotTitle": "Beratungsdienstleistung zur Fachberatung im Rahmen eines Identity and Access Management (IAM) Projektes",
  "buyer": "Stadtwerke Bielefeld GmbH",
  "cpv": "72260000",
  "noticeType": "cn-standard",
  "nature": "services",
  "deadline": "2026-09-14T10:00:00+02:00",
  "published": "2026-08-12T00:00:00+02:00"
}

Anschließend ruft es get_tender für die interessanten auf, um die Beschreibung, den geschätzten Wert und die Ausschlussgründe zu lesen, bevor es Ihnen sagt, welche ein Gebot wert sind – dieses Urteil ist Aufgabe des Modells, und der Server bewertet bewusst nichts.

Beachten Sie die Form der Daten in diesem Ergebnis: Die Frist bei diesem ist deadlineReceiptRequests, eine Aufforderung zur Teilnahme, keine Angebotsfrist. Der Prompt find-solo-tenders existiert, weil Unterscheidungen wie diese entscheiden, ob eine Ausschreibung erreichbar ist.

Entwicklung

Node 20 oder neuer.

npm install
npm test            # vitest, no network
npm run typecheck
npm run lint        # biome

Integrationstests greifen auf das Live-Portal zu und werden übersprungen, sofern Sie nicht explizit danach fragen:

VERGABE_LIVE=1 npm test

Commits folgen Conventional Commits; release-please macht daraus einen Release-PR auf main – das Mergen dieses PRs erstellt den Release-Tag, schreibt das Changelog, veröffentlicht auf npm und hängt das Tarball an den GitHub-Release an. Der Commit-Typ bestimmt die Versionserhöhung.

Lizenz

MIT.

Available Tools

5 tools
get_export_urlBulk export URLA
Read-only

Builds the URL of the official bulk export for one day or month. The file is a large ZIP, so download it outside this server.

Inputs: day, month, format. Returns: url, note, format

get_tenderGet one noticeA
Read-only

Fetches a single notice. 'summary' extracts the fields a bidder decides on (deadlines, lot values, suitableFor, document links); the other formats are returned verbatim.

Inputs: noticeId (required), format, noticeVersion. Returns: raw, uri, format, summary, +1 more

lookup_codeLook up a CPV or NUTS codeB
Read-only

Resolves a CPV or NUTS code to its official description.

Inputs: code (required), list (required), language. Returns: code, list, description, descriptionDefault

search_tendersSearch German public tendersA
Read-only

Searches lots on oeffentlichevergabe.de. Defaults to open lots of the competition notice types (cn-standard, cn-social, cn-desg, subco, qu-sy, pin-cfc-standard, pin-cfc-social), newest first. Use search_tenders_raw for anything this does not cover.

Inputs: cpv, nuts, page, sort, +15 more. Returns: page, total, results, pageSize

search_tenders_rawSearch with the native DSLA
Read-only

Posts a WHERE/FROM/PAGE/ORDER query to /bkmk/searches unchanged. Operators: =, >, >=, <, <=, IN, STARTS_WITH, CONTAINS, MATCH_ALL, MATCH_ANY, RANGE_DAYS. Fields on lots: allFreeText, description, allCpvCodes, allContractNatures, active, noticeType, suitableFor (freelance|selbst|startup|other-sme), estimatedValue ('150000 EUR'), publicationDate, firstDeadline, allDeadlines, allPlacesOfPerformanceNutsCodes, contractingPlatform, procedureType, procedureLegalBasis, procedureIdentifier. Text and temporal operators take exactly one operand; IN and STARTS_WITH OR a list. RANGE_DAYS n means field >= midnight Europe/Berlin of today + n days, not a window. See the vergabe://api-reference resource for the full contract.

Inputs: FROM, PAGE, ORDER, WHERE, +1 more. Returns: offset, elements, totalElements

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct operation: searching tenders, fetching details, raw querying, code lookup, and export URL generation. There is no overlap between their purposes.

    Naming Consistency5/5

    All tool names follow a clear verb_noun pattern (search_tenders, get_tender, search_tenders_raw, lookup_code, get_export_url). The conventions are uniform and predictable.

    Tool Count5/5

    Five tools are well-scoped for a public procurement domain. Each tool addresses a necessary function without being excessive or insufficient.

    Completeness4/5

    Core workflows for searching, fetching, raw querying, code lookup, and export are covered. Minor gaps like bulk export download instructions are handled via external guidance, which is acceptable.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      MCP server providing read access to Swiss public procurement data via the official simap.ch API, covering all cantons and the Confederation with intraday updates. It enables searching tenders, awards, construction codes, and procurement offices through natural language queries.
      9
      71 PyPI
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Ukrainian public procurement (Prozorro) that exposes tools to search tenders, retrieve tender details and cards, list and read tender documents.
      ISC