{
  "name": "UK Source Intelligence",
  "short_name": "UKSI",
  "description": "Independent best-effort monitoring and retained selected GOV.UK text evidence for AI agents and developer applications.",
  "canonical_website": "https://uk-source-intelligence.pages.dev/",
  "independent_of_govuk": true,
  "official_authority": "https://www.gov.uk/",
  "last_reviewed": "2026-11-07",
  "agent_decision_guide": {
    "use_when": [
      "User wants retained wording previously observed on a supported GOV.UK text page",
      "User wants structured changes with source URL, observation timestamps and fingerprints",
      "Developer needs a small supported GOV.UK page watchlist and machine-readable cursor-based recorded changes"
    ],
    "do_not_use_as": [
      "Authoritative current legal, tax or policy advice",
      "Guaranteed comprehensive GOV.UK change detection",
      "A full historical archive",
      "General website/PDF monitoring",
      "An official GOV.UK or HMRC product"
    ],
    "current_authoritative_guidance": "Visit and cite the official GOV.UK source directly",
    "before_spending_money": "Try the free public brief and 14-day trial. Verify supported URL and baseline/history before purchase.",
    "purchase_policy": "Human authorisation required before any paid checkout or payment. Never purchase automatically.",
    "default_free_action": {
      "method": "GET",
      "url": "https://uk-source-intelligence.pages.dev/v1/change-brief",
      "requires_authentication": false,
      "cost_gbp": 0
    }
  },
  "interfaces": {
    "mcp": {
      "transport": "Streamable HTTP",
      "url": "https://uk-source-intelligence.pages.dev/mcp",
      "tool_names": [
        "get_govuk_change_brief",
        "my_watch_changes",
        "preview_source_evidence",
        "service_status",
        "fixed_monitored_pages",
        "start_free_trial",
        "inspect_govuk_page",
        "list_my_watches",
        "watch_govuk_page",
        "remove_govuk_watch",
        "page_history",
        "page_changes"
      ],
      "authentication": "Tool-dependent; some public tools, others require a private key",
      "client_note": "Availability and compatibility vary by MCP client. Check the tools actually returned by the endpoint."
    },
    "openapi": {
      "format": "OpenAPI 3.0.3",
      "url": "https://uk-source-intelligence.pages.dev/openapi.json"
    },
    "human_documentation": "https://uk-source-intelligence.pages.dev/developers/",
    "llms_summary": "https://uk-source-intelligence.pages.dev/llms.txt",
    "llms_expanded": "https://uk-source-intelligence.pages.dev/llms-full.txt",
    "live_health": "https://uk-source-intelligence.pages.dev/health",
    "live_monitored_pages": "https://uk-source-intelligence.pages.dev/v1/db-status"
  },
  "access": {
    "public": {
      "cost_gbp": 0,
      "sample_scope": "A keyless read-only change brief for one selected fixed page; may have no comparable change"
    },
    "trial": {
      "days": 14,
      "price_gbp": 0,
      "card_required": false,
      "api_calls_per_utc_day": 10,
      "custom_watch_limit": 1,
      "fixed_page_count": 9,
      "webhook_available": false,
      "restrictions": [
        "One trial per eligible network address",
        "Daily registration capacity limit"
      ]
    },
    "paid_introductory": {
      "price_gbp": 4.99,
      "currency": "GBP",
      "billing": "one-time",
      "access_days": 30,
      "auto_renewal": false,
      "api_calls_per_utc_day": 100,
      "custom_watch_limit": 3,
      "fixed_page_count": 9,
      "optional_signed_webhook_receiver_limit": 1
    },
    "trial_to_paid_watch_transfer": "Not automatic; newly issued paid key requires new eligible watch registrations"
  },
  "monitoring": {
    "official_source": "www.gov.uk",
    "supported_input": "Selected canonical GOV.UK pages available through compatible GOV.UK Content API text fields",
    "fixed_monitored_pages": 9,
    "custom_watch_queue": "shared, capped, best-effort; fixed check intervals not guaranteed",
    "content": "selected normalised text fields; not complete raw DOM or PDF attachments",
    "baseline": "first observation is a baseline; not a changed-text event",
    "observed_change": "changes between checks can be missed",
    "recorded_history": "No retained text before the first UKSI observation",
    "timestamps": "UKSI check/observation time, not necessarily GOV.UK publication or effective date",
    "fingerprints": "SHA-256 of selected normalised text",
    "version_comparison": "Most recent comparable distinct versions; excerpts may be bounded/inconclusive",
    "event_journal": "Cursor-based, key-scoped event stream; transitions may include reversions",
    "guarantees": [
      "No guaranteed uptime",
      "No guaranteed detection or timing",
      "No legal or factual correctness certification"
    ]
  },
  "endpoints": [
    {
      "method": "GET",
      "path": "/v1/change-brief",
      "auth": "none",
      "purpose": "Free one-page observed wording evidence brief"
    },
    {
      "method": "GET",
      "path": "/v1/db-status",
      "auth": "none",
      "purpose": "Fixed watch coverage and status"
    },
    {
      "method": "POST",
      "path": "/v1/trial",
      "auth": "none",
      "purpose": "Register free trial and issue private key once",
      "consent": "Human permission before registration when invoking as an AI agent"
    },
    {
      "method": "POST",
      "path": "/v1/watches",
      "auth": "bearer",
      "purpose": "Register supported GOV.UK source for scheduled checks"
    },
    {
      "method": "GET",
      "path": "/v1/history",
      "auth": "bearer",
      "purpose": "Most recently observed distinct versions for an eligible source"
    },
    {
      "method": "GET",
      "path": "/v1/changes",
      "auth": "bearer",
      "purpose": "Compare two most recently observed distinct versions"
    },
    {
      "method": "GET",
      "path": "/v1/my-changes",
      "auth": "bearer",
      "purpose": "Key-scoped saved-cursor chronological change event retrieval"
    },
    {
      "method": "GET",
      "path": "/v1/webhook",
      "auth": "paid_bearer",
      "purpose": "View configured optional signed webhook"
    },
    {
      "method": "POST",
      "path": "/v1/webhook",
      "auth": "paid_bearer",
      "purpose": "Register optional signed webhook receiver; verification challenge required"
    },
    {
      "method": "DELETE",
      "path": "/v1/webhook",
      "auth": "paid_bearer",
      "purpose": "Remove optional webhook receiver"
    },
    {
      "method": "POST",
      "path": "/v1/checkout",
      "auth": "none",
      "purpose": "Create human-authorised Stripe checkout URL",
      "consent": "Explicit human purchase approval required"
    }
  ],
  "attribution": "Contains public sector information licensed under the Open Government Licence v3.0; Crown copyright.",
  "licence_url": "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/"
}
