The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Vergabe Api: German public procurement notices listing page.
German public procurement notices, above and below the EU thresholds, as a normalised JSON API for software agents and procurement tools. Paid per call with x402 (HTTP 402, USDC). No account, no API key, no subscription.
Base URL: https://vergabe-api.applehorsefrog.workers.dev (a branded domain under viono-insights.de will follow). Payments settle on Base mainnet in USDC since 2026-09-14; the facilitator is PayAI.
Every day roughly 1,000 notices are published on the official German notification service (Datenservice Öffentlicher Einkauf, eForms-DE). The raw feed is a ZIP of XML files, 20 MB per day, with organisation contacts, lots, deadlines and classifications scattered over UBL extensions. This API turns each notice into one flat record:
| field | meaning |
|---|---|
id, notice_id, version | notice UUID and version |
published, issue_date | publication day of the export, issue date from the notice |
kind | competition (calls for tenders), result (awards), planning, change |
notice_type, subtype, procedure, legal_basis, nature | eForms codes (cn-standard, open, vgv, works ...) |
title, description | German text, personal contact data removed |
cpv_main, cpv_additional | CPV codes without check digit |
buyer_name, buyer_type, buyer_city, buyer_postal, buyer_nuts, buyer_website | contracting authority (organisation level only) |
place_nuts, place_city | place of performance |
estimated_value, currency | if stated |
deadline_date, deadline_time, deadline_kind | earliest lot deadline; tender or participation |
documents_url, submission_url | where the tender documents live |
lots | array of lots with title, CPV, NUTS, value, deadline, period |
winners, total_awarded | for award notices, organisation names only |
source_url | the original notice at oeffentlichevergabe.de |
Coverage on a sample day (2026-09-10): 1,067 notices, 589 calls for tenders, 569 of them with a submission deadline, 1,036 with CPV, 985 with NUTS.
| endpoint | price | notes |
|---|---|---|
GET / | free | service descriptor |
GET /openapi.json | free | OpenAPI 3.1 |
GET /v1/stats | free | notices per day, last 30 days |
GET /v1/sample?cpv=72 | free | 5 latest calls for tenders, compact fields |
GET /v1/notices | $0.01 | filtered list, up to 100 records |
GET /v1/notice/{id} | $0.002 | one full record |
POST /mcp | free | remote MCP server (Streamable HTTP), free tools |
GET /.well-known/x402 | free | x402 discovery manifest |
/v1/noticeskind (default competition; result, planning, change, all), cpv (codes or prefixes, comma separated: 45,7131), nuts (prefixes: DE2,DE1), q (substring in title, description, buyer), since / until (publication day), deadline_after / deadline_before, nature, procedure, legal_basis, buyer_type, min_value, limit (max 100), offset (max 5000), fields=full (all columns incl. lots), sort=deadline.
A request without payment returns 402 with a PAYMENT-REQUIRED header describing the amount (USDC), network and receiving address. Any x402 client handles this automatically, for example @x402/fetch:
Prices are in USD and settled in USDC on Base (eip155:8453); there are no other fees on our side. The same code runs against Base Sepolia by setting X402_NETWORK=eip155:84532 and X402_FACILITATOR=https://x402.org/facilitator in wrangler.jsonc.
Two ways to use the data from an MCP client (Claude Desktop, Claude Code, Cursor, any MCP host):
Remote, free tools only (no install): Streamable HTTP endpoint https://vergabe-api.applehorsefrog.workers.dev/mcp with sample_tenders, tender_stats, describe_api. The paid tools are listed there too but only return the payment requirements, because the remote server has no wallet.
Local, with paid tools (stdio, Node 20+): the client pays per call from a wallet you control.
Tools: search_tenders ($0.01 per call, all filters of /v1/notices), get_tender ($0.002), sample_tenders, tender_stats, describe_api (free). Without VERGABE_PAYER_KEY the paid tools return the x402 payment requirements and the HTTP URL instead of data. Use a dedicated low-balance wallet for the key; the server never sends it anywhere, it only signs USDC transfer authorisations (EIP-3009) for the exact price of each call. Source: mcp/server.mjs.
Data: Datenservice Öffentlicher Einkauf, https://oeffentlichevergabe.de, published under CC0 1.0. Every response carries X-Data-Source and X-Data-License headers. Code in this repository: MIT.
Contact persons, e-mail addresses, phone and fax numbers are removed during import (etl/etl.py), both from structured fields and from free text. Only organisation-level data is served. If you find personal data that slipped through, open an issue and it will be removed.
This is a technical data service, not legal advice. Deadlines and conditions must be verified at the source before bidding.
src/index.ts: Cloudflare Worker (Hono) with @x402/hono payment middleware, a D1 (SQLite) database and the remote MCP endpoint.mcp/server.mjs: local MCP server (stdio) that pays for the paid endpoints with @x402/fetch.etl/etl.py: downloads the daily eForms ZIP, parses it with lxml, scrubs personal data, writes INSERT statements..github/workflows/daily-etl.yml: runs the ETL twice a day (06:30 and 14:00 UTC), re-imports the last three days and loads the rows with wrangler d1 execute.Local development:
Operated by Dr. Josua Decker, Viono Insights (https://viono-insights.de). Legal notice (Impressum, § 5 DDG): https://viono-insights.de/impressum.html, also served at GET /impressum. Privacy notice for this API (Art. 13 GDPR): GET /datenschutz. Contact: kontakt@viono-insights.de. The GitHub account that publishes this repository is an automated account operated with Claude on behalf of the provider.
This service was built with substantial AI assistance (Claude); the provider reviews and is responsible for it. Issues and pull requests are welcome; automated contributions are labelled as such.