Us Eli Mcp

io.github.matematicsolutionsPublished by GitHub account matematicsolutionsv0.5.3Updated Oct 24, 2026

US law MCP: bills, US Code, Federal Register, executive orders, case law (state+federal), eCFR

VerifiedSTDIODesktop onlyWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Local MCP server that lets an assistant search and retrieve US federal and state legal sources — bills, US Code, Federal Register, executive orders, case law, e

What you can do
Search and read federal bills: list bills by congress and type, and get full detail with the latest action for one bill. Browse enacted law packages from GovInfo (US Code, Statutes at Large, CFR, Federal Register) and get metadata plus download links. Search Federal Register documents in full text, filter for rules, notices and executive orders, and fetch one document with its official citation. Search court opinions across federal and state courts, and retrieve one opinion cluster. Search current CFR sections and view a section's amendment history. Report what the connector covers and does not cover, with a fallback for each gap.
When to use it
Useful when you need to look up US legislation, regulations or case law and want official citations returned with each result, especially for state case law that federal sources do not cover. It is read-only research support, not a substitute for heavy federal case-law research.
Requirements
Runs locally as a Python package (pip install, or uvx); the Claude plugin route needs uv. Network access to Congress.gov, GovInfo, Federal Register, CourtListener and eCFR. Optional environment variables: US_ELI_API_KEY (defaults to the shared DEMO_KEY with a low rate limit), US_ELI_GOVINFO_API_KEY, US_ELI_CACHE_DIR, US_ELI_AUDIT_DIR, and base URL overrides. Federal Register, CourtListener and eCFR need no key.
Before you install
The default US_ELI_API_KEY is a shared demo key with a low rate limit; a personal free key is recommended. On first use the server fetches a small configuration file from the project's GitHub Releases, which can be disabled with US_ELI_RUNTIME_URL set to empty. It writes cache and audit files to local directories. All tools are read-only; no LLM provider or other telemetry is used.

Installation

In SourceWeft

  1. Open Us Eli Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

us-eli-mcp

MCP server for US law with verifiable citations. Five sources behind ten read-only tools:

  • Congress.gov API - the federal legislative process: bills as they move through committees and floor votes.
  • GovInfo API - enacted law text as published packages: US Code, Statutes at Large, CFR annual editions, Federal Register issues.
  • Federal Register API - full-text search over 1,003,504 FR documents (1994-2026, live-verified 2026-07-07), including 8,513 presidential documents (1,550 executive orders). Keyless.
  • CourtListener search API - full-text search over 8,294,123 court opinions (live-verified 2026-07-07). The headline value is STATE case law (California, New York, Texas, ...), which no federal source covers. Keyless, ~5 requests/min anonymous.
  • eCFR API - the CURRENT Code of Federal Regulations: section-level full-text search over 412,846 sections plus per-section amendment history. Keyless.

What this is not

  • State legislation (all 50 states) - see LegiScan, a free-tier aggregator (30,000 queries/month) not wrapped here.
  • A federal case-law workhorse - for heavy federal case-law research the mature MIT-licensed wrappers (blakeox/courtlistener-mcp, john-walkoe/courtlistener_citations_mcp) remain the recommendation; the case-law tools here exist primarily for state courts. See SOURCES.md.

Tools

ToolPurpose
us_search_billsList bills by congress (e.g. 118) and type (hr, s, hres, ...)
us_get_billFull detail + latest action for one bill
us_list_code_packagesList GovInfo packages in a collection (USCODE, CFR, FR, STATUTE)
us_get_code_packageMetadata + download links (PDF/XML/TXT) for one package
us_search_federal_registerFull-text search over FR documents; filter rules, notices, executive orders
us_get_federal_register_docOne FR document with its official citation (e.g. 91 FR 41591)
us_search_case_lawFull-text search over 8M+ opinions; court filter (e.g. cal, ny, scotus)
us_get_caseOne opinion cluster by cluster_id
us_search_cfr_sectionsFull-text search over the current CFR (eCFR)
us_get_cfr_section_historyAmendment history of one CFR section (e.g. 15 CFR 744.3)
us_coverageDeclare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback.

Every response carries lex_uri (a resolvable API URL), human_readable_citation (the official convention: "H.R. 1, 118th Congress", "91 FR 41591", "People v. Miranda-Guerrero, 519 P.3d 1004 (California Supreme Court 2022)", "15 CFR § 744.3") and source_url (the public page). Reporter citations are taken verbatim from the source and never fabricated; when none exists the docket number is used instead.

Install

As a Claude plugin (Claude Code or the desktop app, needs uv); see plugin/README.md for what it sends and stores:

/plugin marketplace add matematicsolutions/us-eli-mcp/plugin install us-eli-mcp@us-eli-mcp

As a standalone server:

bash
pip install us-eli-mcp

Windows 11 with Smart App Control

Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe and the us-eli-mcp.exe launcher that pip writes at install time. The python.exe and py.exe from the python.org installer are signed by the Python Software Foundation, so running the module through the interpreter works:

bash
python -m pip install us-eli-mcppython -m us_eli_mcp

pip.exe is blocked for the same reason, so install with python -m pip, not pip install. If python is not on PATH, use the Windows launcher: py -3 -m us_eli_mcp.

json
{ "mcpServers": { "us-eli-mcp": { "command": "python", "args": ["-m", "us_eli_mcp"] } } }

Do not turn Smart App Control off to work around this - it cannot be re-enabled without reinstalling Windows.

Configuration

Env varDefault
US_ELI_API_KEYDEMO_KEY (shared, low rate limit - get your own free key at api.congress.gov/sign-up)
US_ELI_GOVINFO_API_KEYreuses US_ELI_API_KEY (same api.data.gov key family)
US_ELI_CACHE_DIR~/.matematic/cache/us-eli
US_ELI_AUDIT_DIR~/.matematic/audit
US_ELI_BASE_URLhttps://api.congress.gov/v3
US_ELI_GOVINFO_BASE_URLhttps://api.govinfo.gov
US_ELI_FR_BASE_URLhttps://www.federalregister.gov/api/v1 (keyless)
US_ELI_COURTLISTENER_BASE_URLhttps://www.courtlistener.com/api/rest/v4 (keyless)
US_ELI_ECFR_BASE_URLhttps://www.ecfr.gov/api (keyless)

The Federal Register, CourtListener and eCFR tools need no key at all.

Network: the server talks to the five sources above and the local filesystem. Once, on first use, it also fetches a small configuration file (us-runtime.json.gz, updated source addresses) from this repository's GitHub Releases. That request carries no query content; GitHub's download counter for the file is the only usage signal we see. US_ELI_RUNTIME_URL="" turns it off; the Claude plugin ships with it off. No LLM provider, no other telemetry.

License

Apache-2.0 (code). Congress.gov, GovInfo, Federal Register and eCFR data are US government works (public domain). CourtListener data is provided by the Free Law Project.

Source: README.md at commit 43b9e9c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.5.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts