By the fastCRW team · Tutorial · Catalogue figures checked 2026-11-05 against GET /v1/data · Verify independently before relying on any figure.
You can give Claude Code or Cursor access to public data with one install command. The local crw-mcp server adds two data tools to your coding agent: one to find a source, and one to call it. Behind them sit more than 430 sources. The agent does not need a separate MCP server, login or tool list for each one.
Install once
Run this in a terminal, with your fastCRW API key in place of the placeholder. The command installs the local server for the coding agents on your machine, which include Claude Code, Cursor, Codex, Windsurf, Gemini CLI and OpenCode.
# Local server, runs every source including the ones that run on your machine
npx -y crw-mcp install --api-key <your fastCRW API key>
Keep the key out of shared screenshots and commit history.
Check that the tools are there
Open your client and ask it to list its MCP tools. Look for crw_find_data and crw_get_data next to the other crw tools. If they are missing, check that the install finished without errors, then make sure the client has reloaded its server list.
How the two tools work together
The agent does not need to know the source before it starts. It searches first, then makes one call. The find tool takes a plain-language query and returns matching capabilities:
{"name": "crw_find_data", "arguments": {"query": "SEC full text search", "limit": 2}}
Each item names the provider and the capability, its credit cost, whether a key is required, and its required and optional options. The get tool takes those option names in its options object. Over MCP, each item also says whether the source has to run on your machine (requiresLocalInstall) and whether your key is configured (keyConfigured).
The loop is short. The agent finds the capability, reads its required options, calls it, and then reads the provenance block before it quotes a figure. Find calls are free and are never billed.
Which sources run where
Every source is either server-run or client-run. Most are server-run, and more than 70 are client-run.
| Kind | Where it runs | Cost per call | Needs a local install |
|---|---|---|---|
| Server-run | fastCRW servers, so the hosted MCP also reaches it | Usually 1 credit; the find item shows the exact cost | No |
| Client-run | Your machine, under the source's own terms | 0 credits; the data does not pass through fastCRW | Yes, the local crw-mcp |
Three prompts that work
These prompts use the two data tools. The JSON under each prompt is the tool call the client sends. We sent each of these calls to a local crw-mcp server on 2026-11-05 and each returned data; the wording of the prompts is ours, and your agent may phrase its calls differently.
1. Company filings
Prompt: What were Apple's most recent 10-K filings? The agent first finds the company's CIK, then reads its SEC EDGAR submissions record.
{"name": "crw_get_data", "arguments": {"provider": "secfts", "capability": "entity-suggest", "options": {"keysTyped": "apple"}}}
{"name": "crw_get_data", "arguments": {"provider": "sec", "capability": "submissions", "options": {"cik": "0000320193"}}}
2. A CVE and its exploit likelihood
Prompt: What is the NVD record for CVE-2021-44228, and how likely is it to be exploited? The first call returns the NVD record. The second returns the EPSS score, which estimates the chance of exploitation in the next 30 days.
{"name": "crw_get_data", "arguments": {"provider": "nvd", "capability": "cve", "options": {"cveId": "CVE-2021-44228"}}}
{"name": "crw_get_data", "arguments": {"provider": "epss", "capability": "score", "options": {"cve": "CVE-2021-44228"}}}
The record we received carried the date 2026-11-04 and an EPSS score of 0.99999.
3. Recent research papers
Prompt: Find recent papers on retrieval augmented generation. The agent calls OpenAlex with a search term and limits the fields it gets back.
{"name": "crw_get_data", "arguments": {"provider": "openalex", "capability": "works", "options": {"search": "retrieval augmented generation", "select": "id,display_name,publication_year"}}}
Keys for sources that run on your machine
Most sources run on fastCRW's servers and need only your fastCRW key. The terms of some sources do not let us run them on our servers, so those run inside the local server on your machine at 0 credits. More than 70 sources run that way. Some of them, such as FRED, need a key of their own. The connector list shows which ones.
npx -y crw-mcp connectors list
Trimmed output from 2026-11-05:
PROVIDER NAME KEY LICENCE
discogs Discogs required, missing Prohibited commercial uses include, but are not limited t...
fred FRED (St. Louis Fed) required, missing FRED provides data and data services to the public for no...
musicbrainz MusicBrainz not needed Non-commercial use of this web service is free; please se...
To store a key for one of them, run npx -y crw-mcp connectors set-key fred. The command saves the key to ~/.config/crw/config.toml with restricted permissions (mode 0600). The key is never passed as an argument.
Troubleshooting
When a data tool fails, the error text starts with a code in brackets. These are the four codes most people hit, with the meaning from the MCP client documentation.
| Code | What it means and what to do |
|---|---|
crw_too_old | Your local crw does not understand the current source definitions. Upgrade with npx -y crw-mcp@latest, then restart the MCP server. |
data_sources_unavailable | The source definitions could not be loaded or refreshed. Data tools fail until a refresh works, while the other tools keep running. Check your connection and CRW_API_URL, then try again. |
unauthorized | The fastCRW API key is missing or invalid. Check CRW_API_KEY or run the install command again. |
result_too_large | The result is over 256 KiB, the limit for MCP results. Narrow the options, for example with a date range or a field list, and call again. |
Honest limits
- The two data tools find and call sources. They do not summarise or rank results for you; the agent does that.
- A source's own limits still apply. The local server makes one call at a time per source, and retries once when a source asks it to wait 10 seconds or less.
- Hosted MCP at
https://fastcrw.com/mcpruns only the sources that run on fastCRW's servers and needs no update on your side. For the client-run sources, use the local install.
Sources
Related: Dependency risk agent with OSV and deps.dev · Claude Code integration · Cursor integration · Claude Code web scraping · Cursor fastCRW MCP plugin · MCP server for public data · Pergamon catalogue
