Developers and AI agents
VettedHome Data API
VettedHome publishes its UK home-services content index as a read-only public API and as an MCP server for AI clients. The index covers 52 editorial pages across the energy, property-fixes and trades tiers, each with its canonical URL and the primary sources cited on the page. This is a content and page index, not a priced dataset: indicative cost bands stay inside the page copy. No authentication, no personal data, released under CC BY 4.0.
Coverage
| Tier | What it covers | Pages |
|---|---|---|
| energy | Energy and green upgrades | 12 |
| property-fixes | Property fixes and removals | 10 |
| trades | Trade services | 14 |
| trades-guide | Trade guides | 16 |
REST endpoints
Base URL https://vettedhome.co.uk/api. All responses are JSON with open CORS, an ETag and edge caching. Full machine-readable contract: OpenAPI 3.1 spec.
| Method | Path | Description |
|---|---|---|
| GET | /api/topics | List the editorial pages. Optional filters: ?q=, ?tier=, ?group=. https://vettedhome.co.uk/api/topics?tier=energy |
| GET | /api/topics/{slug} | Detail for one page. Optional ?tier= disambiguates slugs that repeat across tiers. https://vettedhome.co.uk/api/topics/solar-panel-installation-cost |
| GET | /api/index-snapshot | Coverage snapshot: total pages, per-tier breakdown and distinct primary-source count. https://vettedhome.co.uk/api/index-snapshot |
MCP server
The same data is exposed as a remote Model Context Protocol server over streamable HTTP, so MCP-capable AI clients can read it directly.
- Endpoint:
https://vettedhome.co.uk/mcp(JSON-RPC 2.0, POST) - Manifest: /.well-known/mcp.json
- Resources:
sp://index,sp://snapshot,sp://topics/{tier}/{slug} - Tool:
search_topics(query?, tier?, group?)
Sample pages in the index
- Solar panel installation and cost (energy)
- Solar panel grants 2026 (energy)
- Is solar worth it in the UK? (energy)
- Air source heat pump cost and the 7,500 pound grant (energy)
- Heat pump installation guide (energy)
- Heat pump vs gas boiler (energy)
Terms
Read-only and free under CC BY 4.0: attribute VettedHome and link back to vettedhome.co.uk. Every page in the index is published editorial content with its primary sources named. VettedHome is an independent comparison and introducer, not a lender or installer. Please cache responses and avoid abusive request rates.