# Kestrel > UK public tenders for small firms: find the ones that fit, read the buyer's documents, and check a bid before it is sent. Free while in testing. Searching and reading tenders need no account; everything else needs the person to sign in (Microsoft or an emailed link). The best way to use Kestrel is from an AI assistant, through its MCP server. ## MCP server - https://kestrelhq.co.uk/mcp (streamable HTTP; OAuth 2.1 with PKCE and dynamic registration). The assistant asks the person to sign in once, then works on their firm: start with `get_me`, then `find_tenders_for_firm`. - [How to connect an assistant](https://kestrelhq.co.uk/agents) ## JSON API The same things over HTTP. Field names are snake_case. Open to all: - `GET https://kestrelhq.co.uk/api/tenders?query=` with optional `regions`, `near` (a town, city, county or area code: that area, the areas next to it, and tenders for its region or the whole UK; an unknown place is a 400 naming it), `kinds`, `min_value`, `max_value`, `open_only`, `small_firms_only`, `closing_within_days`, `sort`, `page`. 20 a page, up to page 50. - `GET https://kestrelhq.co.uk/api/places?q=`: places for `near` as someone types, each with where it is. - `GET https://kestrelhq.co.uk/api/tenders/[ocid]` and `GET https://kestrelhq.co.uk/api/tenders/[ocid]/summary`: one tender, and its plain-English summary. - `GET https://kestrelhq.co.uk/api/tenders/[ocid]/holders`: who holds it now, from the buyer's earlier award notices for the same work. - `GET https://kestrelhq.co.uk/api/buyers/notes?buyer=` or `?ocid=`: how a buyer has asked and marked before, from the published documents of its earlier tenders (usual scale, quality, price and social value split, price formula, the kinds of question it asks most and their weights, word limits); `enough` is false below two tenders. With neither, signed in: the questions buyers of your firm's kind of work ask most. Signed in (`Authorization: Bearer` from the MCP sign-in above), always on the person's own firm: - `GET https://kestrelhq.co.uk/api/me`; `PUT https://kestrelhq.co.uk/api/me/name` with `name`; `POST https://kestrelhq.co.uk/api/firms` with `name` (and optional `facts`): another firm, which you own and work in from then on; `GET https://kestrelhq.co.uk/api/me/assistants` and `DELETE https://kestrelhq.co.uk/api/me/assistants/[assistant_id]`: the assistants and apps signed in as you, and signing one out. - `GET https://kestrelhq.co.uk/api/feed`: the firm's tender feed (its home page), made at most once a day from the firm's details only. `POST https://kestrelhq.co.uk/api/watches` with `feed: true` (and `rhythm` daily or weekly): new tenders from the feed by email or webhook (`feed.matched`, each tender with `fit`, `why`, `watch_out`). - `GET`, `PUT`, `DELETE https://kestrelhq.co.uk/api/firm`; `GET https://kestrelhq.co.uk/api/firm/applications` (each with `started`, `progress` and `list`: working_on, looked_at or closed; `?only=` one list), `DELETE https://kestrelhq.co.uk/api/firm/applications/looked-at` (removes those only looked at); `GET`, `POST https://kestrelhq.co.uk/api/firm/invitations`; `POST https://kestrelhq.co.uk/api/firm/invitations/[invitation_id]/resend`; `DELETE https://kestrelhq.co.uk/api/firm/people/[person_id]`; `PUT https://kestrelhq.co.uk/api/firm/people/[person_id]/role` with `role` (owner, member or helper); `POST https://kestrelhq.co.uk/api/firm/invitations` takes `role: "helper"` to invite a helper; `POST https://kestrelhq.co.uk/api/join`. `POST https://kestrelhq.co.uk/api/firm/parts/draft` with `part` (what, where, size, track, insurance, contracts, accreditations, quality, other) and optional `parts` (key to text, as typed): one part of the firm's details written for the person, with `gaps` and `questions` for what only they know; nothing is saved. - `GET https://kestrelhq.co.uk/api/firm/export` (owners): everything the firm keeps as one zip (details, kept answers with their marks, bids so far, policies, certificates; README.txt says what each file is, firm.json holds it all). - `PUT https://kestrelhq.co.uk/api/firm/owner` with `person_id`: the owner hands the firm to one of its people. `GET https://kestrelhq.co.uk/api/firm/activity?take=`: who changed what, newest first, and how (site, API or which assistant). `GET https://kestrelhq.co.uk/api/firm/plan`: the firm's plan, its limits (null: unlimited) and this month's AI use in pounds against its budget. - `GET`, `PUT` (`webhook_url`), `DELETE https://kestrelhq.co.uk/api/firm/webhook`: the owner's address for `person.joined`, `person.left`, `person.removed`, `owner.changed` and `firm.deleted`, signed `X-Kestrel-Signature: t=…,v1=HMAC-SHA256(secret, "t.body")`; the secret comes back once, from PUT. - `POST https://kestrelhq.co.uk/api/fitting-tenders` (optional `facts`, `regions`, `min_value`, `max_value`, `small_firms_only`, `limit`): tenders that fit, best first. - `POST https://kestrelhq.co.uk/api/ask` with `question`: an answer from open tenders, with sources. - `POST https://kestrelhq.co.uk/api/checks`: help applying for one tender, and the routes under `/api/checks/[id]`: `answers`, `deliverables/[n]/brief` (a demo brief for a coding agent), `pack` (the zip to upload), `POST|DELETE forms/[n]` (one of the buyer's forms as the firm filled it in), `POST|GET pack-check` (what's missing, then how the answers are likely to score and what would gain marks). - `GET https://kestrelhq.co.uk/api/checks/[id]/answers`: every question with the firm's saved answer, words, limit, [gaps] left and who has it (`assignee`); `?mine=true` for only the signed-in person's. `PUT https://kestrelhq.co.uk/api/checks/[id]/answers/[ref]` with `text`: save one answer, keeping the others (price questions are refused). - `GET https://kestrelhq.co.uk/api/checks/[id]/answers/[ref]/history`: one answer's earlier wordings, newest first, with who saved each, when and how; `POST https://kestrelhq.co.uk/api/checks/[id]/answers/[ref]/history/[n]/restore` puts version `n` back (a new version itself). - `POST https://kestrelhq.co.uk/api/checks/[id]/approval`: approve the bid as the signed-in person; `GET https://kestrelhq.co.uk/api/checks/[id]/approval`: who approved it and when, or what changed since (also `approval` in the ready list and the check). - `PUT https://kestrelhq.co.uk/api/checks/[id]/answers/[ref]/assignment` with `person_id` (or `me`) and `state` (`to_write`, `to_review`, `done`): give the question to one of the firm's people, or change how far it has got; `DELETE` takes it off them. `PUT https://kestrelhq.co.uk/api/me/emails` with `question_emails`: whether you're emailed when someone gives you a question. - `GET https://kestrelhq.co.uk/api/checks/[id]/gaps`: every [gap] left in the answers and every ask about one. `POST https://kestrelhq.co.uk/api/checks/[id]/gaps` with `ref`, `gap` (as written) and `person_id`, or `name` and `email` for someone outside Kestrel, and an optional `note`: ask them to fill it in (Kestrel emails them; outside asks: 20 a firm a day, 3 an address a day). `DELETE https://kestrelhq.co.uk/api/checks/[id]/gaps/[ask_id]` cancels one; `POST https://kestrelhq.co.uk/api/checks/[id]/gaps/[ask_id]/answer` with `text` fills in one asked of the firm's people; `POST https://kestrelhq.co.uk/api/checks/[id]/gaps/[ask_id]/file` with `keep` keeps a file sent with an answer in the firm's documents, or leaves it out. - `POST https://kestrelhq.co.uk/api/watches` (`near` as in search), `GET https://kestrelhq.co.uk/api/watches/[id]`: new tenders by email or webhook. With neither `email` nor `webhook_url`, to the signed-in person's own address. - `GET https://kestrelhq.co.uk/api/saved`, `PUT|DELETE https://kestrelhq.co.uk/api/saved/[ocid]`: the firm's shortlist of tenders to look at later. - `GET https://kestrelhq.co.uk/api/firm/saved/[ocid]/decision`, `PUT https://kestrelhq.co.uk/api/firm/saved/[ocid]/decision/vote` with `yes`, `why` (one line) and optional `decide_by` (yyyy-MM-dd), `POST https://kestrelhq.co.uk/api/firm/saved/[ocid]/decision` with `bid` (and optional `reason` for not): "Should we bid?" on a saved tender, decided together. - `GET|PUT https://kestrelhq.co.uk/api/checks/[id]/dates` with `drafts`, `reviews`, `approval` (each yyyy-MM-dd or `usual`): the firm's own dates before bids close. - `POST https://kestrelhq.co.uk/api/firm/not-for-us` with `ocid` and `reason` (`too_big`, `too_small`, `too_far`, `not_our_work`, `wrong_buyer`): the tender leaves the firm's feed; `DELETE https://kestrelhq.co.uk/api/firm/not-for-us/[ocid]` puts it back; `GET https://kestrelhq.co.uk/api/firm/not-for-us` lists them. After three with the same reason, `suggested_detail` (also in `GET https://kestrelhq.co.uk/api/feed`) is a line for the firm's details; `POST https://kestrelhq.co.uk/api/firm/not-for-us/suggestion` with `agree` (and the `reason` shown) adds it or not. - `GET|POST https://kestrelhq.co.uk/api/checks/[id]/marking`: how the buyer marks (scale, split, price formula, social value questions). `POST https://kestrelhq.co.uk/api/checks/[id]/answers/[ref]/improve` with `answer`: the answer marked, rewritten to score higher and marked again, with questions only the firm can answer; `POST https://kestrelhq.co.uk/api/firm/facts` with `part` and `text` adds one answer to the firm's details. `POST https://kestrelhq.co.uk/api/checks/[id]/answers/[ref]/commitments`: social value promises. `POST https://kestrelhq.co.uk/api/checks/[id]/forms/[n]/fill`: what goes in each box of a buyer's form. - `GET https://kestrelhq.co.uk/api/checks/[id]/timetable` (and `timetable.ics`), `PUT https://kestrelhq.co.uk/api/checks/[id]/reminders` with `on`, `POST https://kestrelhq.co.uk/api/checks/[id]/buyer-answers` (one file): the dates, reminder emails, and what the buyer's answers to questions change. - `GET https://kestrelhq.co.uk/api/firm/documents`, `POST https://kestrelhq.co.uk/api/firm/documents/policies` (`type`, `answers`), `PUT https://kestrelhq.co.uk/api/firm/documents/[document_id]` (`text`, `adopt`), `POST https://kestrelhq.co.uk/api/firm/documents?type=&title=&expires=` (one file), `DELETE https://kestrelhq.co.uk/api/firm/documents/[document_id]`, `GET https://kestrelhq.co.uk/api/firm/documents/[document_id]/file`, `PUT https://kestrelhq.co.uk/api/firm/first-bid` (`done`): the firm's policies, certificates and first-bid list. - `GET https://kestrelhq.co.uk/api/firm/evidence`, `PUT https://kestrelhq.co.uk/api/firm/evidence` (a new one: `kind` case_study or referee, `client`, `year`, `value`, `what`, `result`, `may_name`, `referee_name`, `referee_role`, `referee_contact`, `from_bid`), `PUT|DELETE https://kestrelhq.co.uk/api/firm/evidence/[evidence_id]`, `POST https://kestrelhq.co.uk/api/firm/evidence/split`: the firm's case studies and referees, and its Track record box turned into items to confirm. - `GET https://kestrelhq.co.uk/api/bids`, `PUT https://kestrelhq.co.uk/api/bids/[id]` (`sent`, `outcome`), `POST https://kestrelhq.co.uk/api/bids/[id]/feedback` (one file): the firm's past bids, their results and the buyer's marks; `summary` has the firm's record `by_buyer`, `by_band` (size of contract) and `by_kind` (kind of question). - `GET https://kestrelhq.co.uk/api/checks/[id]/lessons?ref=`: for each question (or one), what buyers said about the firm's earlier answers to questions like it, from their letters, the same buyer first. - `POST https://kestrelhq.co.uk/api/firm/bids/import` with `name` and `content_base64` (a bid the firm sent before, Word or PDF), or `answers` given with it, or `import_id`, and `title`, `buyer`, `year`, `outcome`, `save`, `leave_out`, `discard`: each question and the firm's answer found in the file word for word, kept a week to check, saved only with `save`. `GET https://kestrelhq.co.uk/api/firm/bids/import`: what waits to be checked. `DELETE https://kestrelhq.co.uk/api/bids/[id]`: an added bid and its answers out again. - `GET`, `POST https://kestrelhq.co.uk/api/searches` (`name`, `query`, `regions`, `near`, `kinds`, `min_value`, `max_value`, `small_firms_only`, `closing_within_days`, `sort`), `PUT` (`name`) and `DELETE https://kestrelhq.co.uk/api/searches/[search_id]`, `GET https://kestrelhq.co.uk/api/searches/[search_id]/tenders?page=`: the firm's saved searches, and one run now. `GET`, `PUT https://kestrelhq.co.uk/api/me/feed` (`feed`: `recommended` or a saved search's id or name): what your own home feed shows. ## Pages - [Search](https://kestrelhq.co.uk/search) - [Browse open tenders](https://kestrelhq.co.uk/tenders) - [Tenders that fit your firm](https://kestrelhq.co.uk/for-your-firm) (sign in) - [Help applying](https://kestrelhq.co.uk/check) (sign in)