MCPcopy Index your code
hub / github.com/JamesANZ/us-legal-mcp

github.com/JamesANZ/us-legal-mcp @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
126 symbols 239 edges 11 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

🇺🇸 US Legal MCP Server

Comprehensive US legal data in your AI workflow. Search Congress bills, Federal Register documents, court opinions, and committees. No API keys required (optional for enhanced access).

An MCP (Model Context Protocol) server that brings authoritative US legal information into AI coding environments like Cursor and Claude Desktop.

Why Use US Legal MCP?

  • 🆓 No API Keys Required – Works out of the box (optional keys for enhanced access)
  • 📜 Comprehensive Sources – Congress, Federal Register, CourtListener
  • Easy Setup – One-click install in Cursor or simple manual setup
  • 🔍 Multi-Source Search – Search across all legal sources simultaneously
  • 📊 Real-time Data – Recent bills, regulations, and court opinions

Quick Start

Ready to explore US legal data? Install in seconds:

Install in Cursor (Recommended):

🔗 Install in Cursor

Or install manually:

npm install -g us-legal-mcp
# Or from source:
git clone https://github.com/JamesANZ/legal-mcp.git
cd legal-mcp && npm install && npm run build

Features

📜 Congress.gov

  • search-congress-bills – Search bills and resolutions
  • get-recent-bills – Get recently introduced legislation
  • get-congress-committees – List Congressional committees

📋 Federal Register

  • search-federal-register – Search regulations and executive orders
  • get-recent-regulations – Get recently published documents

⚖️ CourtListener

  • search-court-opinions – Search court opinions (federal and state)
  • get-recent-court-opinions – Get recent court decisions

🔍 Multi-Source

  • search-all-legal – Comprehensive search across all sources
  • search_digital_asset_regulation – Aggregate search (Congress + Federal Register + all regulator feeds) scoped to crypto/stablecoin topics

🪙 Digital Asset & Crypto Legislation

  • get_genius_act_info – Curated reference for the GENIUS Act (S.1582, 119th Cong., Pub. L. 119-27) — US payment stablecoin framework
  • get_clarity_act_info – Curated reference for the Digital Asset Market CLARITY Act (H.R.3633, 119th Cong.) — SEC/CFTC digital-asset jurisdiction
  • get_curated_act – Fetch any curated act by slug (genius-act, clarity-act)
  • get_bill_details – Live Congress.gov metadata for any bill (by billId like s1582-119 or hr3633-119)
  • get_bill_actions – Full chronological action history for a bill
  • get_bill_text – All text versions (Introduced, Engrossed, Enrolled…) with PDF/HTML/XML links
  • get_public_law_text – GovInfo public law package + truncated full text (e.g., 119-27 for GENIUS Act)

🏛️ Regulator News Feeds

  • get_recent_regulator_news – Recent press releases from OCC, SEC, CFTC, Federal Reserve, Treasury, or FinCEN
  • search_regulator_news – Keyword search across any/all regulator press-release feeds

Installation

Cursor (One-Click)

Click the install link above or use:

cursor://anysphere.cursor-deeplink/mcp/install?name=legal-mcp&config=eyJsZWdhbC1tY3AiOnsiY29tbWFuZCI6Im5weCIsImFyZ3MiOlsiLXkiLCJ1cy1sZWdhbC1tY3AiXX19

Manual Installation

Requirements: Node.js 18+ and npm

# Clone and build
git clone https://github.com/JamesANZ/legal-mcp.git
cd legal-mcp
npm install
npm run build

# Run server
npm start

Claude Desktop

Add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "us-legal-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/legal-mcp/dist/index.js"],
      "env": {
        "CONGRESS_API_KEY": "",
        "COURT_LISTENER_API_KEY": "",
        "GOVINFO_API_KEY": ""
      }
    }
  }
}

Restart Claude Desktop after configuration.

Usage Examples

Search Congress Bills

Find bills related to a specific topic:

{
  "tool": "search-congress-bills",
  "arguments": {
    "query": "immigration",
    "congress": 118,
    "limit": 10
  }
}

Search Federal Regulations

Find regulations on a topic:

{
  "tool": "search-federal-register",
  "arguments": {
    "query": "environmental protection",
    "limit": 5
  }
}

Comprehensive Legal Search

Search across all sources simultaneously:

{
  "tool": "search-all-legal",
  "arguments": {
    "query": "healthcare",
    "limit": 20
  }
}

Search Court Opinions

Find court decisions:

{
  "tool": "search-court-opinions",
  "arguments": {
    "query": "immigration asylum",
    "court": "scotus",
    "limit": 10
  }
}

Data Sources

Source Description API Auth Required
Congress.gov Bills, resolutions, committees, bill actions, bill text versions https://api.congress.gov/v3 Optional
Federal Register Regulations, executive orders https://www.federalregister.gov/api/v1 No
CourtListener Court opinions, decisions https://www.courtlistener.com/api/ Optional
GovInfo Public laws, enrolled bill PDFs, XML https://api.govinfo.gov Optional (api.data.gov key)
OCC Office of the Comptroller of the Currency news releases https://www.occ.gov/rss/occ_news.xml No
SEC Securities and Exchange Commission press releases https://www.sec.gov/news/pressreleases.rss No
CFTC Commodity Futures Trading Commission (general, enforcement, speeches) https://www.cftc.gov/RSS/ No
Federal Reserve Federal Reserve Board press releases https://www.federalreserve.gov/feeds/press_all.xml No
Treasury US Treasury press releases (HTML listing) https://home.treasury.gov/news/press-releases No
FinCEN Financial Crimes Enforcement Network press releases (HTML listing) https://www.fincen.gov/news/press-releases No

API Keys (Optional)

Congress.gov API Key

  1. Visit https://api.congress.gov/
  2. Sign up for a free account
  3. Get your API key
  4. Set CONGRESS_API_KEY environment variable

CourtListener API Key

  1. Visit https://www.courtlistener.com/api/
  2. Create a free account
  3. Get your API key from your profile
  4. Set COURT_LISTENER_API_KEY environment variable

GovInfo API Key

  1. Visit https://api.data.gov/signup/ to request a free key
  2. Set GOVINFO_API_KEY environment variable. Without it the server falls back to DEMO_KEY (rate-limited).

Use Cases

  • Legal Researchers – Quick access to bills, regulations, and court opinions
  • Policy Analysts – Track legislation and regulatory changes
  • Lawyers – Reference tool for case law and regulations
  • Developers – Build apps with authoritative legal data

Technical Details

Built with: Node.js, TypeScript, MCP SDK
Dependencies: @modelcontextprotocol/sdk, superagent, zod
Platforms: macOS, Windows, Linux

Contributing

If this project helps you, please star it on GitHub!

Contributions welcome! Please open an issue or submit a pull request.

License

MIT License – see LICENSE file for details.

Support

If you find this project useful, consider supporting it:

⚡ Lightning Network

lnbc1pjhhsqepp5mjgwnvg0z53shm22hfe9us289lnaqkwv8rn2s0rtekg5vvj56xnqdqqcqzzsxqyz5vqsp5gu6vh9hyp94c7t3tkpqrp2r059t4vrw7ps78a4n0a2u52678c7yq9qyyssq7zcferywka50wcy75skjfrdrk930cuyx24rg55cwfuzxs49rc9c53mpz6zug5y2544pt8y9jflnq0ltlha26ed846jh0y7n4gm8jd3qqaautqa

₿ Bitcoin: bc1ptzvr93pn959xq4et6sqzpfnkk2args22ewv5u2th4ps7hshfaqrshe0xtp

Ξ Ethereum/EVM: 0x42ea529282DDE0AA87B42d9E83316eb23FE62c3f

Extension points exported contracts — how you extend this code

FeedItem (Interface)
(no doc)
src/rss.ts
CongressBill (Interface)
(no doc)
src/us-legal-apis.ts
CuratedActSource (Interface)
(no doc)
src/data/crypto-legislation.ts
FederalRegisterDocument (Interface)
(no doc)
src/us-legal-apis.ts
CuratedActSponsor (Interface)
(no doc)
src/data/crypto-legislation.ts
USCodeSection (Interface)
(no doc)
src/us-legal-apis.ts
CuratedActTimelineEvent (Interface)
(no doc)
src/data/crypto-legislation.ts
RegulationComment (Interface)
(no doc)
src/us-legal-apis.ts

Core symbols most depended-on inside this repo

send
called by 18
scripts/mcp-smoke-test.mjs
toText
called by 13
src/rss.ts
fetchFeed
called by 6
src/rss.ts
filterAndRank
called by 6
src/rss.ts
calculateRelevanceScore
called by 6
src/us-legal-apis.ts
scrapeListing
called by 6
src/us-legal-apis.ts
toRegulatorItem
called by 6
src/us-legal-apis.ts
stripHtml
called by 4
src/rss.ts

Shape

Method 44
Function 39
Class 26
Interface 17

Languages

TypeScript100%

Modules by API surface

src/us-legal-apis.ts89 symbols
src/rss.ts8 symbols
src/data/crypto-legislation.ts8 symbols
src/index.ts6 symbols
scripts/mcp-smoke-test.mjs4 symbols
scripts/mcp-dump-all.mjs4 symbols
scripts/mcp-test-search.mjs3 symbols
scripts/mcp-quick-test.mjs2 symbols
scripts/mcp-quick-probe.mjs2 symbols

For agents

$ claude mcp add us-legal-mcp \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page