# UK Salary Benchmarks

> What do people actually earn round here? Official ONS pay percentiles by UK postcode — for hiring, offers, pricing and relocation.

Remote MCP server (Streamable HTTP): https://uk-salary-benchmarks-mcp.donniertf.workers.dev/mcp
Free tier: `area_salary` — no key, no sign-up, 20 calls/day per IP.
Pro: £9/month, cancel anytime — all tools, unlimited.

## Tools
- area_salary (free): FREE. Median full-time gross annual pay for employees working in the local authority of a UK postcode (ONS ASHE).
- salary_percentiles (Pro): PRO. 10th–90th percentile + mean/median pay for a postcode's area, by working pattern, measure (annual/weekly/hourly), sex, workplace or residence basis.
- compare_areas (Pro): PRO. Compare median and percentile pay across up to 10 postcodes/areas — for relocation, hiring and pricing.
- offer_check (Pro): PRO. Where does a salary sit in the local pay distribution (approximate percentile) for a postcode?

## Buying (agents)
1. POST https://uk-salary-benchmarks-mcp.donniertf.workers.dev/checkout -> {checkout_url, session_id}. A human (or a payment-capable agent) completes Stripe Checkout at checkout_url.
2. GET https://uk-salary-benchmarks-mcp.donniertf.workers.dev/token?session_id=... -> {access_token}.
3. Send Authorization: Bearer <access_token> to https://uk-salary-benchmarks-mcp.donniertf.workers.dev/mcp (or pass access_token in tool arguments).

## Pay per call (x402, USDC on Base)
No account: POST JSON args to https://uk-salary-benchmarks-mcp.donniertf.workers.dev/x402/<tool> -> HTTP 402 with payment requirements ($0.02 USDC per call, payTo 0x02226D28e0c85AE4AdDB7fe7043Dd2b1Ff710D41). Retry with an X-PAYMENT header (x402 v1, scheme exact, network base). Manifest: https://uk-salary-benchmarks-mcp.donniertf.workers.dev/.well-known/x402. MCP clients may also send X-PAYMENT on tools/call.
Machine-readable pricing: https://uk-salary-benchmarks-mcp.donniertf.workers.dev/pricing.json · Server card: https://uk-salary-benchmarks-mcp.donniertf.workers.dev/.well-known/mcp

## Sources
- ONS Annual Survey of Hours and Earnings (ASHE) tables 7 & 8 via the ONS API — OGL v3.0
- postcodes.io (ONS Postcode Directory) for local authority lookup

## Notes
ONS ASHE estimates for all employees in the area (not by job title); the latest ONS API edition can be 1–3 years old and small areas may have missing or less reliable estimates. Not financial advice.
Contact: dmorrisonwebdesign@gmail.com. More UK data MCPs: https://github.com/donniertf-hub/uk-mcp-fleet