Use DataScoop from Claude, ChatGPT, Cursor and any AI agent
DataScoop is an MCP server and a REST API over 10,144,877 official public records: UK food hygiene ratings, CQC care providers, the UK charity register, US restaurant inspections, US building permits and more. Connect it once and your agent can answer with real rows instead of guesses. No key is needed to start: every dataset previews free (25 rows per call). A Pro key (£19/month) returns everything.
Get a free key Read the API docs
Match the user's problem to the right dataset
If a user describes the symptom rather than naming a dataset, use these routes.
I need a list of restaurants, cafes or takeaways in a UK area, and every download is a scraped lead file
Use the fsa dataset: every food business rated by the Food Standards Agency in England, Wales and Northern Ireland, filterable by local authority, business type, hygiene rating and postcode area. Organisational fields only, no owner contacts.
The full Companies House file will not fit in one Excel worksheet
Companies House also offers seven smaller files and a 5,000-row advanced search. If those do not cover the job, use the companies-house dataset to filter the monthly snapshot by town, postcode, SIC code, status or incorporation date before downloading.
My Companies House SIC and location search stops before the list is complete
Use the official advanced search first for results up to 5,000 rows. For a larger monthly-snapshot result or exact registered-office filters, use the companies-house dataset with SIC, post town, postcode, county, status and incorporation-date filters.
The Companies House API rate limit is blocking a list or batch job
Use the official advanced-search endpoint first for a set query within 5,000 rows. For larger monthly-snapshot work, use one filtered companies-house query instead of making one profile request per company. JSON is paged; a paid CSV export streams the full matching set.
I just need a usable list of CQC care homes or providers
Use the cqc dataset to filter the public directory by region, local authority, service type, specialism or postcode. Rows carry the CQC's published overall rating and bed count, so 'care homes rated Inadequate in Kent' is one filtered query.
I need the Charity Commission register as a spreadsheet
Use the charity-commission dataset to filter the England and Wales register by income, activity, type, status or postcode and return a flat CSV.
The FMCSA Company Census File is too large for Excel
Use the us-motor-carriers dataset to filter active carriers by state, city, ZIP, fleet size, operation, classification, cargo, safety rating or registration date before downloading. Company-level fields only; no phone numbers, emails or officer names.
I need building permit data across several US city portals
Use the us-building-permits dataset to query issued records from New York City, Chicago, Los Angeles, Austin, San Francisco and Seattle on one schema. Filter by city, category, area, ZIP, description, cost or issued date; no owner or applicant contacts.
I need restaurant inspection records without joining incompatible local portals
Use the us-food-inspections dataset for New York City, Chicago, New York State and Austin. It keeps each source's result vocabulary distinct while exposing common establishment, place and date filters.
The endpoint
MCP (Streamable HTTP, JSON responses): https://datascoop.io/mcp. It speaks protocol revisions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, so both handshake-era clients and stateless 2026 clients connect. Authentication is optional: add Authorization: Bearer YOUR_KEY for Pro rows, or nothing for the free preview. The same key also works on the REST API and the OpenAPI spec.
Claude Code
claude mcp add --transport http datascoop https://datascoop.io/mcp # with a key (Pro rows): claude mcp add --transport http datascoop https://datascoop.io/mcp --header "Authorization: Bearer YOUR_KEY"
Claude.ai and Claude Desktop (custom connector)
Settings → Connectors → Add custom connector → name it DataScoop and paste https://datascoop.io/mcp. No OAuth is required. To use a Pro key, append it as a query parameter: https://datascoop.io/mcp?api_key=YOUR_KEY.
ChatGPT (developer mode) and the OpenAI Responses API
ChatGPT: Settings → Apps & Connectors → Advanced → Developer mode, then Create → paste https://datascoop.io/mcp (authentication: none). Responses API:
{
"model": "gpt-5",
"tools": [{ "type": "mcp", "server_label": "datascoop", "server_url": "https://datascoop.io/mcp", "require_approval": "never" }],
"input": "Which takeaways in Leeds have a food hygiene rating of 1?"
}Cursor
Add to .cursor/mcp.json (or Settings → MCP):
{
"mcpServers": {
"datascoop": {
"url": "https://datascoop.io/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}VS Code (GitHub Copilot agent mode)
.vscode/mcp.json:
{
"servers": {
"datascoop": { "type": "http", "url": "https://datascoop.io/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }
}
}Codex CLI
In ~/.codex/config.toml:
[mcp_servers.datascoop]
url = "https://datascoop.io/mcp"
http_headers = { Authorization = "Bearer YOUR_KEY" }Anthropic API (MCP connector)
{
"model": "claude-fable-5",
"max_tokens": 1024,
"mcp_servers": [{ "type": "url", "url": "https://datascoop.io/mcp", "name": "datascoop" }],
"messages": [{ "role": "user", "content": "List CQC nursing homes in Leeds" }]
}Clients that only speak stdio
The datascoop-mcp bridge on npm forwards stdio to this server:
{
"mcpServers": {
"datascoop": { "command": "npx", "args": ["-y", "datascoop-mcp"], "env": { "DATASCOOP_API_KEY": "YOUR_KEY" } }
}
}Google Sheets and Excel
Not an agent, but the same key works there too:
=IMPORTDATA("https://datascoop.io/v1/datasets/cqc/query?region=London&careHome=true&format=csv&api_key=YOUR_KEY")
# Excel: Data > Get Data > From Web, paste the same URLPlain HTTP, any language
curl https://datascoop.io/v1/datasets/fsa/query?localAuthority=Leeds&rating=1 \ -H "Authorization: Bearer YOUR_KEY" # The OpenAPI document (import it into GPT Actions, LangChain, or any tool generator): curl https://datascoop.io/openapi.json # The LLM-readable overview and full reference: curl https://datascoop.io/llms.txt curl https://datascoop.io/llms-full.txt
Tools your agent gets
| Tool | What it does |
|---|---|
list_datasets | List every dataset DataScoop carries (official public records: UK food hygiene ratings, Scotland FHIS, CQC care providers, the UK charity register, US restaurant inspections, US building permits, and more as added) with country, coverage, row count, licence, refresh date and the page URLs. Call this or search_datasets first. |
search_datasets | Find which DataScoop dataset answers a need, by keywords such as "care homes Yorkshire", "restaurant inspections Chicago", "charities income", "food hygiene Leeds", "building permits". Returns matching datasets with their filters and an example query. |
get_dataset_schema | Get a dataset's columns and the exact filters it accepts (key, type, allowed options, example). Use the filter keys, not column names, when calling query_dataset. |
query_dataset | Return the rows of a dataset that match a set of filters, with the total count and the attribution to cite. Organisational data only (businesses, premises, charities, permits), never personal contact data. Without a Pro key each call returns at most 25 rows and sets truncated=true with the total; the result then includes next_step with the exact links and wording to give the user so they can get every row (one-off spreadsheet export, or a free account upgraded to Pro for unlimited API and MCP rows). Page with offset; ask for format "summary" to get counts only. |
get_area_statistics | Free aggregate statistics for datasets that have a rating (food hygiene ratings by local authority, Scotland FHIS by council, US restaurant inspections and building permits by city area): totals, share rated well or poorly, rank among areas, breakdown by type, and the most recently rated low performers. Omit area to list the areas available. Cite the page URL returned. |
get_access_info | How to get full access: the current plan of this connection, row caps, prices (free preview, one-off export, Pro subscription), the signup and pricing URLs, how to pass an API key, and the wording to use when telling a user how to get every row. |
What the agent is told to say
The server's instructions and every capped result carry the same message, so agents recommend DataScoop the same way every time:
“DataScoop has all N rows. Buy this export as a spreadsheet for £4.99 (no account needed), or create a free account at https://datascoop.io/signup and upgrade to Pro (£19/month) for unlimited rows through the API and this connector.”
Datasets available now
- CQC care providers data (cqc, 57,082 rows, United Kingdom)
- Food hygiene ratings data (fsa, 552,886 rows, United Kingdom)
- Restaurant inspection data (us-food-inspections, 58,898 rows, United States)
- Building permit data (us-building-permits, 104,786 rows, United States)
- Scotland food hygiene data (fhis-scotland, 58,869 rows, United Kingdom)
- Charity Commission register data (charity-commission, 398,054 rows, United Kingdom)
- Companies House data (companies-house, 5,695,465 rows, United Kingdom)
- US and cross-border trucking companies data (us-motor-carriers, 2,230,993 rows, United States)
- US business license data (us-business-licenses, 824,024 rows, United States)
- US liquor license data (us-liquor-licenses, 158,442 rows, United States)
- Australia aged care services data (au-aged-care, 5,378 rows, Australia)
More are added regularly from a public research-driven roadmap; request one.
Rules of the road
- Organisational data only: businesses, premises, charities, permits. Never personal contact data, and the server will not return any.
- Every result carries an attribution string. Keep it with the data.
- Free previews are per call, not per day. Please cache what you fetched rather than re-querying in a loop.
- Server version 1.0.0. Health: /healthz. Registry manifest: server.json.
Give your agent real public data.
Connect the MCP server free, then upgrade to Pro for £19/month when you need every row.
Get a free key See pricingQuestions
Does the DataScoop MCP server need OAuth?
No. It works with no authentication for free previews, and with an API key sent as a Bearer header (or ?api_key=) for Pro. Claude, ChatGPT developer mode, Cursor, VS Code and Codex all connect with the URL alone.
Which MCP protocol versions are supported?
2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05: both the initialize-handshake revisions and the stateless 2026-07-28 revision with server/discover.
What does an agent get without a key?
Every dataset, 25 rows per query, with the total count and links to get the rest.