referencesource.org MCP server
Commit Sep 21, 2026Allows an AI client to search verified regulatory datasets and verify claims against verbatim source quotes and URLs.
Also known as joelp22-maker/referencesource-mcp, referencesource-rules
- Stars
- 0
- Tools
- 8
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Sep 21, 2026
- License
- MIT
What is referencesource.org MCP?
referencesource.org allows an AI client to search verified regulatory datasets and verify claims against verbatim source quotes and URLs. It exposes 8 tools, such as list_datasets, search_records, get_record.
Summary generated from the project's README
About referencesource.org MCP server
Verifying regulatory thresholds and deadlines against verified datasets is what this MCP server enables for developers using AI clients. It provides access to over 110,000 records across 285 datasets, covering topics like certification registers, inspection requirements, and standards supersessions. Users can connect via Claude Desktop or other stdio clients using npx, or connect directly to a remote HTTP endpoint without installing a package.
This tool distinguishes itself by providing full provenance for every piece of information. Instead of just returning a value, the server provides the source URL and a verbatim quote from the original page. The verify_quote tool allows an assistant to check a specific claim against published records to determine if it matches exactly, matches a quote, differs from the stored value, or is not found in the dataset. This setup requires no accounts or API keys and functions as a stateless bridge to the hosted data.
What you can do with it
- 1Validate regulatory compliance claimsCheck if a specific regulatory value provided by an AI matches the official record.
- 2Audit data provenanceRetrieve the exact source URL and verbatim text used to justify a specific data point.
Written from the project's README. Every use case is checked against a quote from it.
How to install referencesource.org MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall referencesource.org MCP in Claude Code
$ claude mcp add --transport http referencesource-rules https://referencesource.org/mcp/rulesInstall referencesource.org MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"referencesource-rules": {
"url": "https://referencesource.org/mcp/rules"
}
}
}Install referencesource.org MCP in VS Code
.vscode/mcp.json
{
"servers": {
"referencesource-rules": {
"type": "http",
"url": "https://referencesource.org/mcp/rules"
}
}
}Install referencesource.org MCP in VS Code CLI
$ code --add-mcp '{"name":"referencesource-rules","type":"http","url":"https://referencesource.org/mcp/rules"}'Install referencesource.org MCP in Codex
$ codex mcp add referencesource-rules --url https://referencesource.org/mcp/rulesInstall referencesource.org MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.referencesource-rules] url = "https://referencesource.org/mcp/rules"
Install referencesource.org MCP in Gemini CLI
$ gemini mcp add -s user --transport http referencesource-rules https://referencesource.org/mcp/rulesInstall referencesource.org MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"referencesource-rules": {
"url": "https://referencesource.org/mcp/rules",
"type": "http"
}
}
}referencesource.org MCP tools 8
Detected from the READMElist_datasetssearch_recordsget_recordverify_quotematches_recordmatches_quotediffersnot_found
| list_datasets | — | |
| search_records | — | |
| get_record | — | |
| verify_quote | — | |
| matches_record | — | |
| matches_quote | — | |
| differs | — | |
| not_found | — |
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablejoelp22-maker/referencesource-mcp is public and reachablegithub.com/joelp22-maker/referencesource-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-21github.com/joelp22-maker/referencesource-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 41 msPass
README
View on GitHubreferencesource-mcp
MCP server for referencesource.org — small, verified reference datasets where every record carries its source URL and a verbatim quote from that page, so any value an assistant gives you can be checked, not just believed.
285 datasets, 110,000+ records: regulatory thresholds and deadlines, version compatibility, standards supersessions, certification registers, inspection requirements, and more. Each dataset states its coverage and its last-verified date.
Tools
| tool | what it does |
|---|---|
list_datasets |
every dataset with record counts and descriptions |
search_records |
search within a dataset; each hit returns the value plus its source URL and verbatim source quote |
get_record |
one record by id, full provenance included |
verify_quote |
give it a dataset slug and a value you already hold (record id and field optional) — it checks that claim against our published records and says whether it matches |
verify_quote is the unusual one: assistants invent plausible-but-wrong
values roughly 19% of the time in our own measurements, and this is the
check. Four verdicts come back:
| verdict | what it means |
|---|---|
matches_record |
the claim equals the stored value; the match type is named (exact, case-insensitive, normalised) |
matches_quote |
not a stored value, but it does appear in the record's source quote |
differs |
the record holds a different value — both are returned, with the source |
not_found |
no record in that dataset carries it |
Where a record is found, the answer carries the stored value, the record URL,
the source URL and the verbatim quote, so the claim can be traced upstream —
plus an attestation saying plainly that the verdict is about what our source
states, not about what is true in the world. Asking whether the 2026
conforming loan limit for Autauga County, Alabama is $806,500 returns
differs, stored value $832,750, quoting the FHFA row it came from.
Scope, stated so nobody overclaims: these tools search
referencesource.org's own published records. They do not fetch arbitrary
URLs and cannot check a claim against a page we have not harvested.
not_found means "not in this dataset", never "false".
Setup
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"referencesource": {
"command": "npx",
"args": ["-y", "referencesource-mcp"]
}
}
}
Cursor / other stdio MCP clients — same idea: command npx, args
["-y", "referencesource-mcp"].
Clients that support remote servers directly don't need this package at
all — point them at the streamable-HTTP endpoint:
https://referencesource.org/mcp.
Notes
- Zero dependencies; Node 18+. The package is a thin stdio→HTTPS bridge to
the stateless server at
referencesource.org/mcp. - No accounts, no keys, no tracking beyond standard server request logs (see referencesource.org/privacy).
- Data is free to read on the site in HTML, Markdown, and JSON; this package just makes it callable mid-conversation.
MIT licensed.
The data behind it
- Site: https://referencesource.org — canonical, re-verified on a schedule
- Bulk data: https://github.com/joelp22-maker/referencesource-data
- Archived snapshot with a DOI: 10.5281/zenodo.22115966
- Hugging Face: https://huggingface.co/datasets/referencesource
Every record carries source (the page the value was read from) and
source_quote (the verbatim line on that page which states it), so any answer
this server returns can be checked against its source. verify_quote runs that
check against a value you already hold: it tells you whether our record agrees,
and hands back the source and quote either way.
Licence
MIT — see LICENSE. The reference data itself is CC BY 4.0; see the data repository for the full position on the quoted excerpts.
referencesource.org MCP questions
How do I add referencesource.org MCP to Claude Code?
Run claude mcp add --transport http referencesource-rules https://referencesource.org/mcp/rules in your terminal. Add --scope user to make it available in every project.
How do I add referencesource.org MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does referencesource.org MCP provide?
It exposes 8 tools, including list_datasets, search_records, get_record, verify_quote, matches_record.
How can I verify if an AI's claim is correct using this server?
You can use the verify_quote tool to check a value against published records, which returns verdicts like matches_record, matches_quote, differs, or not_found.
Does this server fetch information from any website on the internet?
No, the tools only search the specific datasets published on referencesource.org and cannot fetch arbitrary URLs.
Do I need an API key to use this server?
No, the server requires no accounts or keys for access.