How do I install Regintel?

Regintel is a local plugin. Install it using the provided package and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Regintel safe to use?

Regintel scored 5.6/10 (moderate risk) in MCP Marketplace's automated security scan. It has 5 high or critical findings to review. It's listed, but review the security report on this page before installing.

What AI apps work with Regintel?

Regintel uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Regintel MCP Server

by Black Swan Causal Labs

Developer ToolsModerate5.6MCP RegistryLocal

Free

Server data from the Official MCP Registry

Retrieve FDA docket comments, attachments and draft/final guidance for reviewable analysis.

About

Retrieve FDA docket comments, attachments and draft/final guidance for reviewable analysis.

Security Report

5.6

Moderate5.6Moderate Risk

regintel-mcp is a read-only regulations.gov retrieval server with a clear, documented purpose and no evidence of data exfiltration, shell execution, or hardcoded secrets in the reviewed code. Its API key is read from configuration and sent only as an X-Api-Key header, and its only network access targets regulations.gov and FDA download URLs, which matches its stated purpose. The main observations are minor: the code is truncated in the provided content, so the remaining guidance.py and the unseen client, config, cache and extract modules were not fully reviewed, and some broad exception handling and SQL-built column names exist, which are low-severity quality points. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity).

5 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "com-blackswancausallabs-regintel-mcp": {
      "args": [
        "regintel-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

regintel-mcp

Regulatory intelligence from FDA regulations.gov dockets: who commented, what they asked for, and what changed between the draft and final guidance.

Black Swan Causal Labs · blackswancausallabs.com

Retrieval lives in the MCP server. Judgment lives in skills. Humans sit at the checkpoints.

Layer	Component	Status
Data	`regintel-mcp` server (this repo, MIT)	Phase 1 built. Fetch, cache, extract, diff. No interpretation.
Method	skills: `submitter-taxonomy`, `comment-theming`, `draft-final-concordance`	Built
Orchestration	`/docket-analysis <docketId>` with 4 human checkpoints	Built; first run on FDA-2020-D-2307
Output	Docket Lens explorer (reads one `analysis.json`; PolyForm Noncommercial)	Built for FDA-2020-D-2307

Install

Python 3.11 or later.

git clone https://github.com/Black-Swan-Causal-Labs/regintel-mcp.git
cd regintel-mcp
python3 -m venv .venv && .venv/bin/pip install -e .
cp .env.example .env    # then paste your key into .env

API key: get a free key at https://open.gsa.gov/api/regulationsgov/ and put it in .env as REGULATIONS_GOV_API_KEY=.... .env is gitignored. The key is sent only as the X-Api-Key header and never appears in logs, the cache or any output. DEMO_KEY is fine for single lookups but too rate-limited for a full corpus pull. Personal keys allow 1,000 requests/hour.

Register with an MCP client. MCP is an open standard, so the server works with any compatible assistant (Claude, OpenAI Codex, others). For Claude Code, from the repo directory:

claude mcp add regintel-mcp -- "$(pwd)/.venv/bin/python" -m regintel_mcp

When installed as a Claude plugin, .mcp.json starts the server from the plugin root.

Tools

Every tool reads the local SQLite cache (data/cache.sqlite) first. It only touches the network on a cache miss or when called with refresh=true.

Tool	Does
`search_dockets(query, agency="FDA", docket_type?, limit=25)`	Keyword search over dockets
`get_docket(docket_id)`	Docket metadata and total comment count
`list_documents(docket_id)`	Notices, draft and final guidance, meeting material, with every file URL
`list_comments(docket_id, include_withdrawn=false)`	All comments, paginated internally. Flags `is_stub`, `duplicate_of` and `agency_duplicate_count` (flags only; nothing is dropped)
`get_comment(comment_id)`	Body, submitter fields, attachments and extracted attachment text
`build_corpus(docket_id, with_attachments=true)`	Pulls every comment and attachment into the cache. Resumable. Reports stubs, duplicates, OCR needs and failures
`get_guidance_text(ref)`	A guidance document (doc ID or URL) split into numbered sections
`diff_guidance(draft_ref, final_ref)`	Section-aligned draft-vs-final diff with paragraph changes and moved-paragraph detection
`export_corpus(docket_id)`	Writes `output/<docket>/corpus.jsonl` for skills and subagents

For long pulls outside a chat: .venv/bin/python -m regintel_mcp build-corpus FDA-2020-D-2307.

How the diff works: the text layer is extracted with pdfplumber. Running headers, draft line numbers, footnotes and the table of contents are removed. Sections are split on the guidance's own Roman, letter and number headings, then matched draft→final by heading (parent-qualified first) and then by heading plus text similarity. Paragraphs are diffed within each matched section, and paragraphs that moved to a different section are labelled. Everything is deterministic: there are no model calls in the server.

API behaviour verified against the live service is recorded in docs/api-notes.md.

Docket Lens (the explorer)

Docket Lens (explorer/template.html) is a single page that reads one analysis.json and shows three linked views: who spoke, what they asked for (a themes × submitter-type heatmap that opens the verbatim requests), and what changed (draft vs final by section, with each request's call). Build a docket's copy with:

.venv/bin/python scripts/build_analysis.py FDA-2020-D-2307
.venv/bin/python scripts/build_explorer.py FDA-2020-D-2307

Then open explorer/FDA-2020-D-2307/index.html through any static server, e.g. python3 -m http.server --directory explorer/FDA-2020-D-2307. The explorer is licensed separately under PolyForm Noncommercial 1.0.0 (explorer/LICENSE, explorer/NOTICE).

Hosting a Docket Lens demo (Cloudflare Pages, password-protected)

sh scripts/build_site.sh FDA-2020-D-2307
cd site && npx wrangler pages deploy public --project-name docket-lens

site/functions/_middleware.js puts HTTP Basic Auth in front of every request, including analysis.json. Credentials are Pages secrets, never files: npx wrangler pages secret put DEMO_USER --project-name docket-lens, and the same for DEMO_PASS. If either secret is missing, the site serves nothing (it fails closed). It is a demo gate, not access control for sensitive data.

Status (3 Oct 2026)

First full run: FDA-2020-D-2307 (60 comments, 1,211 requests, 4 checkpoints, human spot-check agreement 91% on 55 calls). Outputs in output/FDA-2020-D-2307/, decisions in decisions/.
Second-docket smoke test: FDA-2021-D-0548. Retrieval and the draft/final comparison passed without changes; see docs/smoke-test-FDA-2021-D-0548.md.

The concordance caveat

This tool measures concordance, not impact. Changes between draft and final guidance also come from FDA's internal review, ICH M14, other guidances and the evolving science. When the final text moves in the direction a commenter asked for, that does not show the comment caused the change. Every output from this project carries that caveat.

License

Server: MIT (see LICENSE). The Explorer template is licensed separately under PolyForm Noncommercial 1.0.0.

Official MCP Registry packaging

The Docket Lens retrieval server has an MCP bundle for Registry distribution. See Registry installation and release instructions. The bundle requires uv, your Regulations.gov API key, and a writable working folder.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Rea

Free

by Morluto · Developer Tools

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

Paperclip

Free

by Paperclipai · Developer Tools

Trending hip-hop artist momentum scores across four cultural dimensions.

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

by Lharries · Communication

Read, search, and send WhatsApp messages through your AI assistant

Regintel MCP Server

About

Security Report

Findings (9)Action required

Permissions Required

How to Install

Documentation

regintel-mcp

Install

Tools

Docket Lens (the explorer)

Hosting a Docket Lens demo (Cloudflare Pages, password-protected)

Status (3 Oct 2026)

The concordance caveat

License

Official MCP Registry packaging

Reviews

No reviews yet

More Developer Tools MCP Servers

Rea

Paperclip

Toleno

MCP Marketplace

mcp-creator-python

WhatsApp