Home / For agents
DEVELOPER DOCUMENTATION / MCP + REST

Your agent gets a real API.

Machine-readable evidence, explicit usage boundaries and a practical path from your first free request to a saved monitored GOV.UK page.

01 / READ-ONLY

Start with actual public evidence.

Anyone, including an AI agent, can request a read-only observed-change brief without registration. It returns one selected fixed-page example if genuine comparable versions exist. The response may legitimately report insufficient history.

Shell · no API key needed
curl -sS 'https://uk-source-intelligence.pages.dev/v1/change-brief'

Interpret changes, insufficient_history, inconclusive, last_observed_at and limitations. Use GOV.UK directly for the current official wording. UKSI is for source history it has actually retained.

Critical distinction: last_observed_at is a UKSI check timestamp. It is not necessarily the publication date, effective date or GOV.UK edit time.
02 / MCP

Connect a compatible AI client.

UKSI exposes a remote MCP endpoint on the branded domain. Add the URL in a client that supports remote Streamable HTTP MCP servers; available setup varies by client. The endpoint itself is not a web page.

Remote MCP endpoint
https://uk-source-intelligence.pages.dev/mcp

Available MCP tools are listed below. Paid purchases must be explicitly authorised by a human; agents should not initiate paid checkout autonomously.

›

get_govuk_change_brief

Public sample or authenticated saved wording brief

›

my_watch_changes

Cursor-based change events for your own watches

›

preview_source_evidence

Free GOV.UK VAT live source example

›

service_status

Basic service status

›

fixed_monitored_pages

List fixed monitored GOV.UK URLs

›

start_free_trial

Register a restricted trial key with human permission

›

inspect_govuk_page

Inspect a supported official page now

›

list_my_watches

List the key's custom monitored pages

›

watch_govuk_page

Register a supported page for monitoring

›

remove_govuk_watch

Remove a watch owned by the key

›

page_history

Read saved versions for an entitled URL

›

page_changes

Compare two retained distinct versions

03 / PRIVATE KEY

Get a restricted 14-day trial.

Request a key through the website or API. The API key is returned once, in the response body. Keep it secret. The trial includes 10 authenticated requests per UTC day and one custom watch, with capacity limits.

Shell · register trial
curl -sS -X POST 'https://uk-source-intelligence.pages.dev/v1/trial'

For browser-based signup, open the free-trial form. Do not send the key to an LLM conversation or any public log.

04 / SAVED SOURCE

Monitor a supported GOV.UK URL.

Pass the key as Authorization: Bearer ... and register a canonical supported GOV.UK page. This VAT page is an example of a custom watch; it is not one of the nine default fixed pages.

Shell · add a custom watch
curl -sS -X POST 'https://uk-source-intelligence.pages.dev/v1/watches' \
  -H 'Authorization: Bearer YOUR_PRIVATE_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://www.gov.uk/hmrc-internal-manuals/vat-input-tax/vit12100"}' 

Registration attempts an initial baseline; it may return pending. A baseline is not a detected change and does not recreate earlier history.

05 / CURSOR

Read new recorded changes without guessing.

Request your own chronological changes with a cursor. Store next_cursor from the response, then pass it as since next time. Reading does not mark events as read; retries are safe. Reversions can generate separate transition events.

Shell · key-scoped saved-cursor digest
curl -sS 'https://uk-source-intelligence.pages.dev/v1/my-changes?since=0' \
  -H 'Authorization: Bearer YOUR_PRIVATE_API_KEY'

The digest and a two-version snapshot comparison serve different purposes. If you need durable delivery, paid access optionally supports one signed HTTPS webhook receiver with retries. Webhook delivery is best-effort and may be duplicated.

IMPORTANT / DECISION GUIDE

When your agent should choose something else.

For authoritative current guidance, prefer GOV.UK directly. For comprehensive regulation alerts, compliance advice or full historical archives, use an established specialist service. For ordinary websites, screenshots, private pages or PDFs, use a general-purpose website monitor.

For recorded selected GOV.UK wording evidence, choose UKSI only if the target URL is supported and the observation window is sufficient. Compare alternatives before purchasing. Read the methodology and scope.