Portugal Tenders MCP server

@pipeworx/portugal-tenders

Portuguese public-procurement tender announcements and awarded contracts from IMPIC (Instituto dos Mercados Públicos, do Imobiliário e da Construção), Portugal's public-procurement regulator. Fleet #3111.

Part of Pipeworx — an MCP gateway connecting AI agents to 1808+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

-- search tender announcements by free-text keyword (notice title), CPV classification code/prefix, contracting-authority (buyer) name substring, and a publish-date range (defaults to the last 90 days). Returns each notice's internal id, IMPIC notice id, buyer, title, notice type, contract type(s), base amount (EUR), CPV, publish date, and proposal deadline.

• ptannouncementsearch(query?, cpv?, buyer?, datefrom?, dateto?, limit?)

the internal id returned from ptannouncementsearch, including the buyer's NIF tax number, procedure model, lot descriptions, and a link to the official notice document.

• ptannouncementdetail(id) -- the full record for one announcement by

-- search awarded contracts by free-text keyword (contract title), buyer (adjudicante) name substring, awarded supplier (adjudicatário) name substring, a contract-amount range (EUR), and a publish-date range. Returns each contract's id, title, buyer, supplier, amount, contract type(s), CPV, publish date, and signing date.

• ptcontractsearch(query?, buyer?, supplier?, amountmin?, amountmax?, datefrom?, dateto?, limit?)

its id, including buyer/supplier NIF tax numbers, full description, base procurement price, execution deadline and location(s), procedure type, and the legal regime cited.

• ptcontractdetail(idcontrato) -- the full record for one contract by

Every response carries source, sourceurl, licence, dataasof, and (on search / no-match responses) the relevant windowfrom/window_to pair -- the span this pack currently holds for that dataset -- so a caller can tell "nothing on this topic" apart from "that date range isn't loaded".

Auth

Keyless. The tools answer only through the Pipeworx gateway, which holds the data; a standalone install has no data to read, and every tool returns a clear "store is not bound in this runtime" error there instead of an empty list.

Data sources

-- Portugal's public-procurement regulator, which runs the national tender register, Portal BASE. Fleet #3088 looked at reaching BASE directly and found two live paths, neither usable without more work: BASE's own legacy REST API resets every connection mid-response, and IMPIC's newer API needs account registration plus a token (Bruce ruled "register Portugal" on 2026-10-15 for that -- separate, ongoing, and this pack does not wait on it). IMPIC's own documentation says that newer API returns the SAME FIELDS as the files it already publishes as open data, organization IMPIC, on Portugal's national open-data portal () -- one dataset of tender announcements and one of awarded contracts, each split into a file per calendar year, refreshed weekly. Because neither dataset offers server-side search, this pack builds a store from them (scripts/portugal-tenders/load-data.mjs) rather than proxying per request, per Bruce's standing rule (2026-09-23): when live doesn't serve, build the store yourself, with a refresh path and dataasof on every response.

• IMPIC (Instituto dos Mercados Públicos, do Imobiliário e da Construção)

Shortened. The full README is on GitHub.