`search_notices`

Pack: uk-contracts · Endpoint: https://gateway.pipeworx.io/uk-contracts/mcp

Full-text search of UK government procurement from Contracts Finder (Cabinet Office) — what the public sector bought, who supplied it, and for how much, plus open opportunities still out to tender. Covers NHS trusts, councils, police forces, universities and central government departments. Search by keyword (“MRI scanner”, “agency nursing”, “school catering”, “cloud hosting”) across notice title, description and awarded supplier, and narrow by publication date. Returns awarded contracts with supplier name and contract value by default, because a question about “contracts” usually means what was actually awarded. Keyless. The UK complement to EU tenders.

Parameters

Name	Type	Required	Description
`keyword`	string	no	Free-text search over notice title, description and awarded supplier name, e.g. “MRI”, “magnetic resonance imaging”, “agency nursing”. Server-side and properly indexed. Omit to browse the newest notices for the chosen status.
`status`	string	no	Which notices: “awarded” (contracts actually awarded, with supplier and value — the DEFAULT, and what a question about “contracts” nearly always means), “open” (opportunities still accepting bids), “closed” (bidding shut, award not yet published), “withdrawn”, or “any”. A niche keyword often has zero OPEN notices while having hundreds of awarded ones — “MRI” is 0 open, 151 closed, 495 awarded, 9 withdrawn — so an empty “open” result says nothing about whether the buying happened.
`notice_type`	string	no	Optional notice type. “Contract” is a real procurement; “PreProcurement” is market engagement; “Pipeline”/“Planning”/“Future” are intentions to buy later.
`published_from`	string	no	Optional ISO date (YYYY-MM-DD) lower bound on publication date, e.g. “2025-01-01”.
`published_to`	string	no	Optional ISO date (YYYY-MM-DD) upper bound on publication date, e.g. “2026-08-01”.
`limit`	number	no	Max notices to return, 1–100 (default 20). `total_matches` reports the full hit count regardless.

Example call

Arguments

{
  "keyword": "MRI",
  "limit": 20
}

curl

curl -X POST https://gateway.pipeworx.io/uk-contracts/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_notices","arguments":{"keyword":"MRI","limit":20}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_notices', {
  "keyword": "MRI",
  "limit": 20
});

More examples

{
  "keyword": "magnetic resonance imaging",
  "status": "awarded",
  "published_from": "2025-01-01",
  "limit": 50
}

{
  "keyword": "cloud hosting",
  "status": "open"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "uk-contracts": {
      "url": "https://gateway.pipeworx.io/uk-contracts/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_notices