# UK Compliance — agent instructions

Service ID: `nb:uk-compliance` · version 0.1.5 · status **Beta** · consumable: **true**

Beta UK corporate compliance monitoring: query live Companies House profiles, The Gazette corporate insolvency notices, and Find a Tender contract awards through an evidence-backed REST API.

## Does not do
- complete UK regulatory compliance
- sanctions screening
- AML clearance
- legal advice

## Free REST demo workflow
1. For an exact company number, call `GET https://api.niftibot.com/v1/companies/{company_number}?payment=false`. For evidence documents, call `GET https://api.niftibot.com/v1/companies/{company_number}/evidence?limit=5&payment=false`. For a name, call `GET https://api.niftibot.com/v1/companies/search?q={url_encoded_name}&payment=false` first and resolve the legal entity; never guess between candidates.
2. Do not sign, send, or request a payment for these demo calls. The response contains `payment.required: false` and `payment.mode: free_demo`; the server also returns `X-Payment-Mode: free-demo`. The demo is rate-limited to five calls per minute per client IP.
3. Return the complete JSON envelope with Companies House identity, compliance verdict and markers, observed Gazette insolvency notices and Find a Tender awards, provenance URI and retrieval time, OGL v3.0 licence, notice and limitations.
4. The preview excludes residential/registered-office postcodes and internal watchlist notes. It does not provide sanctions, AML, credit, or overall legal clearance.
5. If the endpoint fails or the demo rate limit is reached, report that and stop. Do not substitute general web search or memory.
6. Stripe checkout and prepaid credits are test mode only. Do not describe them as live payment or approved commercial pricing.

## Connection
- Endpoint: https://api.niftibot.com
- Transport: http-rest
- Auth: none
- Manifest: /manifests/uk-compliance/0.1.5.json

## Tools

| Tool | Built | Read-only | Price |
|---|---|---|---|
| `uk_company_search` | yes | yes | not priced |
| `uk_company_profile` | yes | yes | not priced |
| `uk_compliance_screen` | yes | yes | not priced |
| `uk_company_evidence` | yes | yes | not priced |

## Data
- Coverage: Companies House company search and profile lookups combined with observed corporate insolvency notices from The Gazette (Category 24) and public-contract awards from Find a Tender (OCDS).
- Freshness: Company search and profiles are live Companies House lookups; Gazette notices (polled every 10 min) and Find a Tender awards (polled every 30 min) reflect records observed by the aggregator.
- Sources:
  - Companies House (OGL v3)
  - The Gazette (OGL v3)
  - Find a Tender Service (OGL v3)

## Limitations
- This is corporate-registry, insolvency-notice, and procurement data, not sanctions, AML, credit or overall legal clearance
- ambiguous company names return an error; pass an exact company number or an explicit 1-based candidate pick
- Gazette and Find a Tender evidence is limited to corporate records observed and linked by this service; absence of a record does not guarantee no notice or award exists
- Stripe checkout accepts test cards only; the $5 test pack grants 1,000 service credits and does not represent live commercial pricing
- The payment=false REST preview is unauthenticated and rate-limited to five calls per minute per client IP

## Rights
- Status: open_data
- Attribution: Contains public sector information licensed under the Open Government Licence v3.0 (Companies House, The Gazette, Find a Tender)

## Open readiness blockers
- Stripe checkout and prepaid credits are in test mode; live payments and commercial pricing are not enabled
- REST demo is rate-limited to five calls per minute per client IP

See also: /agents/payments.md · /agents/security.md · /agents/licensing.md