Polish Public Tenders

Official9 tools

by ContentWriterco

Polish public procurement for AI agents: BZP and TED tenders, awards, buyers and contractors.

io.github.ContentWriterco/polish-public-tenders — Model Context Protocol (MCP) Server

This MCP server provides access to information about Polish public procurement for AI agents, focusing on procurement records related to BZP and TED tenders, as well as awards, buyers, and contractors.

🛠️ Key Features

Covers Polish public procurement content
Includes BZP and TED tenders
Includes awards
Includes buyers and contractors

🚀 Use Cases

Retrieve procurement-related context for AI agent workflows in Poland
Look up tender information across BZP and TED sources
Reference parties involved in awards (buyers and contractors)

⚡ Developer Benefits

Structured context centered on tenders, awards, buyers, and contractors
Clear scope limited to Polish public procurement and the BZP/TED split

⚠️ Limitations

Description does not specify available tools or data fields beyond tenders, awards, buyers, and contractors

Topics

mcpmcp-servermodel-context-protocolopen-datapolandpublic-procurementtendersgemini-cli-extension

Captured live from the server via tools/list.

search_tenders

Search Polish public procurement notices from BZP (national) and TED (EU): open calls with deadlines or awarded contracts. Filter by industry (it, construction, medicine, or a 2-digit CPV division such as 72), region, buyer city, kind and value. Returns title, buyer, CPV codes, publication date, deadline, estimated or awarded value and a link to the notice.

Parameters10

status	string	optional	open (default) or awarded notices.
industry	string	optional	it, construction, medicine, or a 2-digit CPV division code (e.g. 72, 45, 33).
region	string	optional	Voivodeship of the buyer.
city	string	optional	Buyer city, e.g. Warszawa.
kind	string	optional	Contract type.
source	string	optional	national (BZP) or eu (TED). Default: both.
value_min	number	optional	Minimum estimated/awarded value.
value_max	number	optional	Maximum estimated/awarded value.
currency	string	optional	Currency for value filters and output. Default PLN.
page	integer	optional	Result page (20 per page).

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "open",
        "awarded"
      ],
      "description": "open (default) or awarded notices."
    },
    "industry": {
      "type": "string",
      "description": "it, construction, medicine, or a 2-digit CPV division code (e.g. 72, 45, 33)."
    },
    "region": {
      "type": "string",
      "enum": [
        "dolnośląskie",
        "kujawsko-pomorskie",
        "lubelskie",
        "lubuskie",
        "łódzkie",
        "małopolskie",
        "mazowieckie",
        "opolskie",
        "podkarpackie",
        "podlaskie",
        "pomorskie",
        "śląskie",
        "świętokrzyskie",
        "warmińsko-mazurskie",
        "wielkopolskie",
        "zachodniopomorskie"
      ],
      "description": "Voivodeship of the buyer."
    },
    "city": {
      "type": "string",
      "description": "Buyer city, e.g. Warszawa."
    },
    "kind": {
      "type": "string",
      "enum": [
        "supplies",
        "services",
        "works"
      ],
      "description": "Contract type."
    },
    "source": {
      "type": "string",
      "enum": [
        "national",
        "eu"
      ],
      "description": "national (BZP) or eu (TED). Default: both."
    },
    "value_min": {
      "type": "number",
      "description": "Minimum estimated/awarded value."
    },
    "value_max": {
      "type": "number",
      "description": "Maximum estimated/awarded value."
    },
    "currency": {
      "type": "string",
      "enum": [
        "PLN",
        "EUR",
        "USD"
      ],
      "description": "Currency for value filters and output. Default PLN."
    },
    "page": {
      "type": "integer",
      "minimum": 0,
      "maximum": 50,
      "description": "Result page (20 per page)."
    }
  },
  "additionalProperties": false
}

search_companies

Search and filter Polish KRS companies (spółki). Compabase also holds the full CEIDG/JDG register; this tool does not browse JDG — those without a public contact email are hidden because of RODO. Default `fields=summary` returns a compact row (name, NIP, KRS, location, PKD, latest financials, email/phone/website) — small enough for MCP clients. `fields=contacts_only` is name/NIP/KRS/city/email/phone/website only. `fields=full` returns every company_search column plus contacts and may exceed client size limits. Use for rankings, sector filters, city/county/region browsing, name search, or NIP/KRS lookup. When a PKD is mostly JDG, a sparse result includes a `hint` (full CEIDG is in the database; listing is RODO-gated). Do not call export_companies just to get a handful of emails or phones.

Parameters35

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.
city	string	optional	City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'.
county	string	optional	County / powiat (lowercase).
region	string	optional	Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'.
postal_code	string	optional	Postal code prefix, e.g. '00-9' or '61-'.
pkd	string	optional	Primary PKD code prefix, e.g. '46.90.Z' or '46'.
all_pkd	string	optional	Match any PKD code in the company's activity list (not just primary).
legal_form	string	optional	Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'.
currency	string	optional	Currency for monetary filters. Default: pln.
revenue_min	number	optional	Minimum total revenue.
revenue_max	number	optional	Maximum total revenue.
profit_min	number	optional	Minimum net profit.
profit_max	number	optional	Maximum net profit.
profit_operating_min	number	optional	Minimum operating profit (PLN). Negative allowed. Omit if unused.
profit_operating_max	number	optional	Maximum operating profit (PLN). Omit if unused.
total_assets_min	number	optional	Minimum total assets.
total_assets_max	number	optional	Maximum total assets.
ebitda_min	number	optional	Minimum EBITDA.
ebitda_max	number	optional	Maximum EBITDA.
capital_min	number	optional	Minimum share capital.
capital_max	number	optional	Maximum share capital.
estimated_value_min	number	optional	Minimum Ohlson estimated equity value in PLN.
estimated_value_max	number	optional	Maximum Ohlson estimated equity value in PLN.
registration_date_min	string	optional	Earliest KRS registration date, YYYY-MM-DD (inclusive). For newly registered companies use today's date for both registration_date_min and registration_date_max.
registration_date_max	string	optional	Latest KRS registration date, YYYY-MM-DD (inclusive).
is_active	boolean	optional	true = active only, false = closed only. Omit for all.
has_email	boolean	optional	true = only companies with email on record. Matching rows include contacts.email. Omit otherwise.
has_website	boolean	optional	true = only companies with website on record. Matching rows include contacts.website. Omit otherwise.
sort_by	string	optional	Sort field (default: revenue_total). registration_date + sort_dir=desc lists the newest registrations first.
sort_dir	string	optional	Sort direction (default: desc).
year	integer	optional	Filter to companies whose latest financial_period_to falls within this calendar year (e.g. 2024). Use only for sector/ranking browse — omit when looking up a company by name, KRS, or NIP.
limit	integer	optional	Max results (default: 10, max: 50).
fields	string	optional	Response size. Default summary (name, NIP, KRS, location, PKD, latest financials, email/phone/website). contacts_only: name, NIP, KRS, city, email, phone, website. full: every company_search column plus contacts — often too large for MCP clients.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    },
    "city": {
      "type": "string",
      "description": "City name — KRS records use uppercase, e.g. 'WARSZAWA', 'POZNAŃ'."
    },
    "county": {
      "type": "string",
      "description": "County / powiat (lowercase)."
    },
    "region": {
      "type": "string",
      "description": "Voivodeship (lowercase), e.g. 'mazowieckie', 'wielkopolskie'."
    },
    "postal_code": {
      "type": "string",
      "description": "Postal code prefix, e.g. '00-9' or '61-'."
    },
    "pkd": {
      "type": "string",
      "description": "Primary PKD code prefix, e.g. '46.90.Z' or '46'."
    },
    "all_pkd": {
      "type": "string",
      "description": "Match any PKD code in the company's activity list (not just primary)."
    },
    "legal_form": {
      "type": "string",
      "description": "Legal form fragment, e.g. 'spółka z o.o.' or 'akcyjna'."
    },
    "currency": {
      "type": "string",
      "enum": [
        "pln",
        "usd",
        "eur"
      ],
      "description": "Currency for monetary filters. Default: pln."
    },
    "revenue_min": {
      "type": "number",
      "description": "Minimum total revenue."
    },
    "revenue_max": {
      "type": "number",
      "description": "Maximum total revenue."
    },
    "profit_min": {
      "type": "number",
      "description": "Minimum net profit."
    },
    "profit_max": {
      "type": "number",
      "description": "Maximum net profit."
    },
    "profit_operating_min": {
      "type": "number",
      "description": "Minimum operating profit (PLN). Negative allowed. Omit if unused."
    },
    "profit_operating_max": {
      "type": "number",
      "description": "Maximum operating profit (PLN). Omit if unused."
    },
    "total_assets_min": {
      "type": "number",
      "description": "Minimum total assets."
    },
    "total_assets_max": {
      "type": "number",
      "description": "Maximum total assets."
    },
    "ebitda_min": {
      "type": "number",
      "description": "Minimum EBITDA."
    },
    "ebitda_max": {
      "type": "number",
      "description": "Maximum EBITDA."
    },
    "capital_min": {
      "type": "number",
      "description": "Minimum share capital."
    },
    "capital_max": {
      "type": "number",
      "description": "Maximum share capital."
    },
    "estimated_value_min": {
      "type": "number",
      "description": "Minimum Ohlson estimated equity value in PLN."
    },
    "estimated_value_max": {
      "type": "number",
      "description": "Maximum Ohlson estimated equity value in PLN."
    },
    "registration_date_min": {
      "type": "string",
      "description": "Earliest KRS registration date, YYYY-MM-DD (inclusive). For newly registered companies use today's date for both registration_date_min and registration_date_max."
    },
    "registration_date_max": {
      "type": "string",
      "description": "Latest KRS registration date, YYYY-MM-DD (inclusive)."
    },
    "is_active": {
      "type": "boolean",
      "description": "true = active only, false = closed only. Omit for all."
    },
    "has_email": {
      "type": "boolean",
      "description": "true = only companies with email on record. Matching rows include contacts.email. Omit otherwise."
    },
    "has_website": {
      "type": "boolean",
      "description": "true = only companies with website on record. Matching rows include contacts.website. Omit otherwise."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "revenue_total",
        "profit_net",
        "total_assets",
        "profit_operating",
        "ebitda",
        "capital_total",
        "estimated_value",
        "registration_date"
      ],
      "description": "Sort field (default: revenue_total). registration_date + sort_dir=desc lists the newest registrations first."
    },
    "sort_dir": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort direction (default: desc)."
    },
    "year": {
      "type": "integer",
      "description": "Filter to companies whose latest financial_period_to falls within this calendar year (e.g. 2024). Use only for sector/ranking browse — omit when looking up a company by name, KRS, or NIP."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default: 10, max: 50)."
    },
    "fields": {
      "type": "string",
      "enum": [
        "contacts_only",
        "summary",
        "full"
      ],
      "description": "Response size. Default summary (name, NIP, KRS, location, PKD, latest financials, email/phone/website). contacts_only: name, NIP, KRS, city, email, phone, website. full: every company_search column plus contacts — often too large for MCP clients."
    }
  }
}

get_company

Get the registry profile of one Polish company: name, legal form, address, industry (PKD), share capital, representation rules, recent registry changes, VAT status and headline financials for the latest filed period. Identify the company by name, KRS number or company tax number (NIP). For earlier years or full statements use get_financials.

Parameters3

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    }
  }
}

get_company_public_aid

Get SUDOP public aid / grants for a company — full case list with amounts, grantor, measure, purpose. Keyed by NIP. Identify company by name, KRS, or NIP.

Parameters3

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    }
  }
}

get_company_eu_funds

Get European Funds (Fundusze Europejskie) projects for a company — official MFiPR lists, EU co-financing, programme and dates. Keyed by NIP. Identify company by name, KRS, or NIP. Cohesion/shared-management funds; not TED procurement, not FTS Commission grants, and not SUDOP state aid.

Parameters3

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    }
  }
}

get_company_eu_grants

Get European Commission grants awarded directly to a Polish company (Horizon Europe, LIFE, Erasmus+ and other EU programmes from the EU Financial Transparency System). Identify the company by name, KRS number or company tax number (NIP).

Parameters3

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    }
  }
}

get_company_public_tenders

Get BZP public procurement data — full awards as contractor and notices as buyer, with award values. Keyed by NIP. Identify company by name, KRS, or NIP.

Parameters3

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    }
  }
}

get_company_eu_tenders

Get TED EU-threshold public procurement — full awards as contractor and notices as buyer. Keyed by NIP. Identify company by name, KRS, or NIP.

Parameters3

name	string	optional	Company name, used when the KRS or NIP is not known.
krs	string	optional	KRS number of the company in the Polish National Court Register (10 digits).
nip	string	optional	Polish company tax number (NIP) of the business, 10 digits.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name, used when the KRS or NIP is not known."
    },
    "krs": {
      "type": "string",
      "description": "KRS number of the company in the Polish National Court Register (10 digits)."
    },
    "nip": {
      "type": "string",
      "description": "Polish company tax number (NIP) of the business, 10 digits."
    }
  }
}

get_usage

Get current billing period usage and remaining quota — mcp_queries, api_requests, export_companies, ask_ai_credits, watchlist_companies. Includes limits and reset date.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

README.md2 KBView on GitHub

Polish Public Tenders MCP Server

Search open and awarded Polish public tenders (national BZP and EU TED notices) and check which companies win public contracts.

Remote MCP server (Streamable HTTP), read-only, hosted by Compabase.

code

https://compabase.com/api/mcp/tenders

Tools

Tool	What it does
`search_tenders`	Open or awarded notices by industry (IT, construction, healthcare or CPV division), region, city, kind and value.
`get_company_public_tenders`	BZP contracts won and notices published by one company.
`get_company_eu_tenders`	TED (EU-threshold) contracts and notices for one company.
`get_company_eu_funds / get_company_public_aid / get_company_eu_grants`	EU funds, state aid and European Commission grants.
`search_companies / get_company`	Identify buyers and contractors (KRS, NIP, financials).

Example prompts

Find open IT tenders in Mazowieckie with a deadline in the next two weeks.
Which public contracts has Budimex won recently?
Show awarded construction tenders above 10 million PLN.

Authentication

Sign in with your Compabase account (OAuth) in clients that support it, or send an MCP key: create one at https://compabase.com/integrations?tab=mcp and pass it as Authorization: Bearer mcpk_… or append ?apiKey=mcpk_… to the URL. Queries count toward your Compabase plan.

Setup

Claude (claude.ai, Desktop): Settings → Connectors → Add custom connector → paste the URL above (add ?apiKey=mcpk_… if you use a key).

Cursor / VS Code / Windsurf (mcp.json):

json

{
  "mcpServers": {
    "polish-public-tenders": {
      "url": "https://compabase.com/api/mcp/tenders",
      "headers": { "Authorization": "Bearer mcpk_YOUR_KEY" }
    }
  }
}

ChatGPT: Settings → Apps → Developer mode → Create → paste the URL.

About

Part of the Compabase MCP family. Full Compabase MCP (all Polish company data tools): https://compabase.com/api/mcp.

Questions: contact@compabase.com

Gemini CLI

bash

gemini extensions install https://github.com/ContentWriterco/Polish-Public-Tenders-MCP

Gemini CLI asks for your Compabase MCP key during installation (create one at https://compabase.com/integrations?tab=mcp).

Setup guides

Step-by-step setup guides for Claude, ChatGPT, Gemini, Grok, Le Chat, Perplexity, Cursor, VS Code and Claude Code: https://compabase.com/docs/mcp/connect/

Install

Tools (9)

search_tenderssearch_companiesget_companyget_company_public_aidget_company_eu_fundsget_company_eu_grantsget_company_public_tendersget_company_eu_tenders

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://compabase.com/api/mcp/tenders

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "polish-public-tenders": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://compabase.com/api/mcp/tenders"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.ContentWriterco/polish-public-tenders — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_tenders

search_companies

get_company

get_company_public_aid

get_company_eu_funds

get_company_eu_grants

get_company_public_tenders

get_company_eu_tenders

get_usage

Polish Public Tenders MCP Server

Tools

Example prompts

Authentication

Setup

About

Gemini CLI

Setup guides

Install

Remote endpoint

Related servers