Atlasprzetargow

io.github.atlasprzetargowPublished by GitHub account atlasprzetargowv0.2.1Updated Oct 25, 2026

Polish public tenders (BZP, TED): 1M+ notices, buyer and contractor profiles, CPV, stats, glossary.

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant search and analyze Polish public tenders (BZP, TED), buyer and contractor profiles, CPV categories and regional stats.

What you can do
Search tenders by keyword, CPV code, city, province, value range and dates, and fetch full notice details with an optional AI summary. Look up buyers and contractors by NIP or name, including their top counterparties. Get aggregate statistics for CPV categories and for provinces or cities, and resolve CPV codes from Polish keywords. Read a glossary of Polish procurement terms and knowledge base articles, and run guided prompts for tender analysis, buyer due diligence and opportunity discovery.
When to use it
Useful when working with Polish public procurement: finding active tenders that match a profile, checking a buyer's or contractor's track record, or comparing category and regional market statistics.
Requirements
Runs locally over stdio, typically launched with npx from the npm package @atlasprzetargow/mcp (Node.js required). Network access to the Atlas Przetargów API. Optional environment variables: ATLAS_API_KEY for higher quota and AI summaries, ATLAS_API_BASE to override the API root, plus timeout and retry settings.
Before you install
ATLAS_API_KEY is optional and sent as a header to the Atlas API; without it public endpoints still work but with a lower daily quota (1,500 per IP versus 5,000 with a key). Tender data and queries go to the third-party Atlas Przetargów service, which is subject to per-IP rate limits. The server is read-only lookup; it does not submit or modify tenders.

Installation

In SourceWeft

  1. Open Atlasprzetargow in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Atlas Przetargów — MCP Server

[npm version] [License: MIT]

The first MCP server for Polish public procurement data. Query 800 000+ Polish public tenders (BZP + TED), buyer/contractor profiles, and category statistics directly from Claude Desktop, Cursor, Continue, Cline, or any MCP-compatible AI client.

Powered by Atlas Przetargów — the Polish public procurement search and analytics platform.

What is this?

The Model Context Protocol (MCP) lets AI assistants connect to external tools and data. This server exposes the Atlas Przetargów API to any MCP client, giving your AI assistant the ability to:

  • Search Polish public tenders by keyword, CPV category, location, value, or deadline
  • Get full tender details including buyer, CPV codes, estimated value, deadlines, optional AI-generated summary
  • Profile any procuring entity (zamawiający) by NIP — including who wins their contracts most often
  • Profile any contractor (wykonawca) by NIP — including which buyers they win from
  • Analyze market statistics for any CPV category (count, median value, avg offers, avg deadline)
  • Compare provinces and cities in procurement volume
  • Access a glossary of 90+ Polish public procurement terms
  • Use guided workflows (prompts) for tender analysis, buyer due diligence, and opportunity discovery

Quick start (Claude Desktop)

Option A — via npx (recommended, no install)

Edit your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add:

json
{  "mcpServers": {    "atlas-przetargow": {      "command": "npx",      "args": ["-y", "@atlasprzetargow/mcp"]    }  }}

Restart Claude Desktop. The Atlas tools will appear in the tools panel.

Option B — global install

bash
npm install -g @atlasprzetargow/mcp

Then in claude_desktop_config.json:

json
{  "mcpServers": {    "atlas-przetargow": {      "command": "atlas-przetargow-mcp"    }  }}

Usage examples (in Claude Desktop)

"Find active construction tenders in Warsaw with budget 500k–5M PLN and show me the top 5"

"Use the buyer-due-diligence prompt for NIP 5252248481" (→ runs due diligence on the City of Warsaw as a procuring entity)

"What's the median value of IT tenders in Poland last year?"

"Look up tender 2026/BZP 00202613 and analyze its key terms and risks"

"Find me the CPV code for medical equipment and show active tenders"

"Who most frequently wins contracts from GDDKiA (National Roads Authority)?"

Tools

ToolDescription
search_tendersSearch tenders with filters (query, CPV, city, province, value range, dates, sort)
get_tenderFull details of a tender by ID, optionally with AI summary
get_buyerProfile of a procuring entity by NIP + top winning contractors
get_contractorProfile of a contractor by NIP + top buyers they win from
search_entitiesFind buyers / contractors by name (returns NIP for other tools)
get_category_statsAggregate stats for a CPV category (count, median, avg offers, avg deadline)
get_province_statsStatistics by province or city (top buyers, top CPV)
search_cpvLook up CPV codes by Polish keyword

Resources

URIDescription
atlas://glossaryIndex of 90+ Polish public procurement terms
atlas://glossary/{slug}Full definition of a specific term
atlas://knowledgeIndex of long-form knowledge base articles
atlas://knowledge/{slug}Full knowledge base article

Prompts

PromptDescription
analyze-tenderComprehensive analysis of a tender notice: scope, value, deadlines, risks, recommendation
buyer-due-diligenceDue diligence on a procuring entity: purchase profile, contractor network, red flags
find-opportunitiesFind active tender opportunities matching a CPV + location + value profile

Configuration (environment variables)

All optional. Defaults are safe.

VariableDefaultDescription
ATLAS_API_BASEhttps://atlasprzetargow.plAPI root. Useful for staging or self-hosted Atlas
ATLAS_API_KEY(none)Optional Atlas API key (atlas_...), generated at https://atlasprzetargow.pl/konto (tab "API"). Raises the daily request quota (anonymous: 1 500/day per IP, key: 5 000/day) and is sent as X-Api-Key. Docs: https://atlasprzetargow.pl/dokumentacja-api
ATLAS_TIMEOUT_MS20000Request timeout
ATLAS_MAX_RETRIES2Retry count for 429 / 5xx / timeouts

Pass them via your MCP client config:

json
{  "mcpServers": {    "atlas-przetargow": {      "command": "npx",      "args": ["-y", "@atlasprzetargow/mcp"],      "env": {        "ATLAS_API_KEY": "atlas_your_key_here"      }    }  }}

Polish public procurement — quick reference

  • BZP (Biuletyn Zamówień Publicznych) — Polish national tender registry. IDs look like 2026/BZP 00202613.
  • TED (Tenders Electronic Daily) — EU-wide tender registry, required for tenders above EU thresholds.
  • CPV (Common Procurement Vocabulary) — 8-digit category codes, e.g. 45000000 = construction, 72000000 = IT.
  • NIP — Polish 10-digit tax ID, used to identify every buyer / contractor.
  • Province codes: PL02 dolnośląskie · PL04 kujawsko-pomorskie · PL06 lubelskie · PL08 lubuskie · PL10 łódzkie · PL12 małopolskie · PL14 mazowieckie · PL16 opolskie · PL18 podkarpackie · PL20 podlaskie · PL22 pomorskie · PL24 śląskie · PL26 świętokrzyskie · PL28 warmińsko-mazurskie · PL30 wielkopolskie · PL32 zachodniopomorskie
  • Notice types:
    • ContractNotice — active tender, open for bids
    • TenderResultNotice / ContractAwardNotice — results (who won, at what price)
    • CompetitionNotice, ConcessionNotice — specialized notices

Development

bash
git clone https://github.com/atlasprzetargow/mcp-server.gitcd mcp-servernpm installnpm run buildnpm run smoke   # runs all tools against production API
# Test locally in Claude Desktop:# Point the "command" in claude_desktop_config.json to the absolute path of dist/index.js:# "command": "node", "args": ["/abs/path/to/mcp-server/dist/index.js"]

Rate limits & fair use

Atlas Przetargów API has a per-IP rate limit (30 req/min for LLM endpoints, more for public ones). The MCP server automatically retries 429 responses with exponential backoff.

If you hit rate limits frequently (e.g. in production automations), please reach out via atlasprzetargow.pl/kontakt for higher-tier access.

License

MIT © Atlas Przetargów

Data source attribution

All tender data is sourced from:

  • BZP (Biuletyn Zamówień Publicznych) — public registry of the Polish Public Procurement Office
  • TED (Tenders Electronic Daily) — EU public procurement registry

Processed, enriched, and served by Atlas Przetargów.

Related

Source: README.md at commit d1f4326

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.2.1LatestOct 16, 2026
  2. v0.1.1Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts