Skip to content
Eden Engine

UK Public Sector Contract Awards (Contracts Finder)

contractsfinder/search-award-notices

UK public sector contract award notices from Contracts Finder published since a date-time, in the Open Contracting Data Standard format: the awarded supplier, award value in GBP, award date, contract period, the original tender (title, description, procedure, category, region) and the buyer. Give a published-from date-time, optionally a published-to and a count (1 to 50, default 10). Notices contain buyer-supplied text, including buyer contact details. Contains public sector information licensed under the Open Government Licence v3.0, passed through unmodified and served by Eden Engine; not an official Contracts Finder product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

Contracts Finder (Cabinet Office)

Contains public sector information licensed under the Open Government Licence v3.0. Source: Contracts Finder, Cabinet Office. Served by Eden Engine; not an official Contracts Finder product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "contractsfinder/search-award-notices" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "contractsfinder/search-award-notices" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "contractsfinder/search-award-notices", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "contractsfinder/search-award-notices", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "published_from"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "How many award notices to return, 1 to 50. Defaults to 10. Each notice is roughly 5 to 7 KB, so 50 is a large response."
    },
    "published_to": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}$",
      "description": "Optional. Only notices published on or before this date-time, same format as published_from. Leave out for up to now."
    },
    "published_from": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}$",
      "description": "Only award notices published on or after this date-time, written YYYY-MM-DDThh:mm:ss with no timezone suffix, for example 2026-10-18T00:00:00. The service works in UK local time. This is the date the notice was published, not the date the contract was awarded."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "uri": {
      "type": "string",
      "description": "The search URL the service reports it answered."
    },
    "license": {
      "type": "string",
      "description": "URL of the Open Government Licence v3.0."
    },
    "version": {
      "type": "string",
      "description": "The OCDS version, for example 1.1."
    },
    "releases": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The release id."
          },
          "tag": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "date": {
            "type": "string"
          },
          "ocid": {
            "type": "string",
            "description": "The contracting process id."
          },
          "buyer": {
            "type": "object",
            "additionalProperties": true
          },
          "awards": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            },
            "description": "The award: `status`, `date` (awarded), `datePublished`, `value` (amount and currency), `suppliers`, `contractPeriod`, `documents`."
          },
          "tender": {
            "type": "object",
            "description": "The original procurement: `title`, `description`, `status`, `classification` (CPV), `value`, `procurementMethodDetails`, `contractPeriod`, `mainProcurementCategory`.",
            "additionalProperties": true
          },
          "parties": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            },
            "description": "The buyer and the supplier(s), with `roles`."
          }
        },
        "additionalProperties": true
      },
      "description": "One OCDS release per award notice."
    },
    "publisher": {
      "type": "object",
      "description": "The package publisher (Cabinet Office).",
      "additionalProperties": true
    },
    "extensions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "publishedDate": {
      "type": "string",
      "description": "When the package was generated."
    },
    "publicationPolicy": {
      "type": "string"
    }
  },
  "description": "The Contracts Finder OCDS release package: publisher, licence and one release per award notice.",
  "additionalProperties": true
}