ecfr-mcp 0.1.0__tar.gz

ecfr_mcp-0.1.0/.gitignore

@@ -0,0 +1,35 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.env
+.venv
+venv/
+ENV/
+env/
+.pytest_cache/
+.coverage
+.mypy_cache/
+.ruff_cache/
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*.swo

ecfr_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.1.0 (2026-04-05)
+
+Initial release.
+
+- 13 MCP tools covering the eCFR API (admin, versioner, search endpoints)
+- Core: get_latest_date, get_cfr_content, get_cfr_structure, get_version_history, get_ancestry, search_cfr, list_agencies, get_corrections
+- Workflows: lookup_far_clause, compare_versions, list_sections_in_part, find_far_definition, find_recent_changes
+- Server-side XML parsing (Claude never sees raw XML, only clean text with headings, paragraphs, and citations)
+- Automatic date resolution (prevents 404s from eCFR's 1-2 day lag)
+- Search defaults to current-only (prevents historical version duplicates)
+- Actionable error translation for 400/404/406 responses
+- No authentication required

ecfr_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 1102tools
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ecfr_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: ecfr-mcp
+Version: 0.1.0
+Summary: MCP server for the eCFR (Electronic Code of Federal Regulations) API. Read FAR, DFARS, and all agency FAR supplements.
+Project-URL: Homepage, https://1102tools.com
+Project-URL: Repository, https://github.com/1102tools/ecfr-mcp
+Project-URL: Issues, https://github.com/1102tools/ecfr-mcp/issues
+Author: 1102tools
+License: MIT
+License-File: LICENSE
+Keywords: 1102,cfr,dfars,ecfr,far,federal-acquisition,mcp,model-context-protocol,regulations
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.0.0
+Description-Content-Type: text/markdown
+
+# ecfr-mcp
+
+MCP server for the eCFR (Electronic Code of Federal Regulations) API. Read FAR, DFARS, and all agency FAR supplement text with no authentication required.
+
+Works with any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Cline, Continue, Zed, etc.).
+
+## What it does
+
+Exposes the eCFR API as 13 MCP tools covering regulatory text, structure, search, version history, and common acquisition workflows:
+
+**Core endpoints**
+- `get_latest_date` - Get the most recent available date for a CFR title (call before other tools)
+- `get_cfr_content` - Get parsed regulatory text for a section, subpart, or part
+- `get_cfr_structure` - Hierarchical table of contents
+- `get_version_history` - Amendment history for a section or part
+- `get_ancestry` - Breadcrumb hierarchy path
+- `search_cfr` - Full-text search with hierarchy filters
+- `list_agencies` - All agencies with their CFR references
+- `get_corrections` - Editorial corrections for a title
+
+**Workflow convenience**
+- `lookup_far_clause` - One-call FAR/DFARS clause text lookup (auto-resolves date)
+- `compare_versions` - Side-by-side text comparison at two dates
+- `list_sections_in_part` - All sections in a FAR/DFARS part
+- `find_far_definition` - Search FAR 2.101 for a term definition
+- `find_recent_changes` - Sections modified since a given date
+
+## No authentication required
+
+The eCFR API is fully public. No API key, no registration, no auth headers. Just install and use.
+
+## Installation
+
+### Via uvx (recommended)
+
+```bash
+uvx ecfr-mcp
+```
+
+### Via pip
+
+```bash
+pip install ecfr-mcp
+```
+
+### From source
+
+```bash
+git clone https://github.com/1102tools/ecfr-mcp.git
+cd ecfr-mcp
+pip install -e .
+```
+
+## Claude Desktop configuration
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ecfr": {
+      "command": "uvx",
+      "args": ["ecfr-mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The `ecfr` server appears in your MCP tools panel with 13 tools.
+
+## Example prompts
+
+- "Pull the current text of FAR 15.305 (Proposal Evaluation) and summarize what it requires."
+- "List all sections in FAR Part 19 (Small Business Programs)."
+- "Look up the FAR definition of 'commercial product' in 2.101."
+- "What FAR sections were amended in the last 6 months?"
+- "Compare FAR 52.212-4 between 2024-01-01 and 2025-01-01 and show me what changed."
+- "Get the current text of DFARS 252.227-7014 (Rights in Noncommercial Computer Software)."
+- "Search Title 48 for 'organizational conflict of interest' and show me the relevant sections."
+- "Which agency owns Chapter 8 in Title 48? Get their FAR supplement structure."
+
+## Design notes
+
+- **XML parsed server-side.** The eCFR content endpoint returns raw XML. This server parses it into clean text (headings, paragraphs, citations) before returning to Claude, saving significant context tokens.
+- **Automatic date resolution.** eCFR lags 1-2 business days behind the Federal Register. Using today's date on versioner endpoints causes 404 errors. All content tools auto-resolve to the latest available date unless you specify one.
+- **Search defaults to current text.** Without `date=current`, eCFR search returns ALL historical versions including superseded. Default `current_only=True` prevents duplicate results.
+- **Structure endpoint limitation.** The eCFR structure endpoint does not support section-level filtering (returns 400). `list_sections_in_part` works around this by fetching the part structure and walking the tree.
+- **FAR 2.101 optimization.** The definitions section is ~109KB of XML. `find_far_definition` parses the full section server-side and returns only matching paragraphs with context.
+
+## CFR Title 48 quick reference
+
+| Chapter | Regulation | Parts |
+|---|---|---|
+| 1 | FAR | 1-99 |
+| 2 | DFARS | 200-299 |
+| 3 | HHSAR | 300-399 |
+| 4 | AGAR | 400-499 |
+| 5 | GSAR | 500-599 |
+| 6 | DOSAR | 600-699 |
+| 7 | AIDAR | 700-799 |
+| 8 | VAAR | 800-899 |
+| 9 | DEAR | 900-999 |
+| 18 | NFS | 1800-1899 |
+
+## Data source
+
+All data from [ecfr.gov](https://www.ecfr.gov), the continuously updated online Code of Federal Regulations maintained by the Office of the Federal Register. Updated daily, typically 1-2 business days after Federal Register publication. Not an official legal edition; for official citations reference the annual CFR from GPO.
+
+## Companion skill
+
+This MCP mirrors the `ecfr-api` skill from [1102tools.com](https://1102tools.com). The skill is markdown-based for interactive Claude use; the MCP wraps the same API as deterministic tool calls for agent workflows and automation.
+
+## License
+
+MIT

ecfr_mcp-0.1.0/README.md

@@ -0,0 +1,115 @@
+# ecfr-mcp
+
+MCP server for the eCFR (Electronic Code of Federal Regulations) API. Read FAR, DFARS, and all agency FAR supplement text with no authentication required.
+
+Works with any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Cline, Continue, Zed, etc.).
+
+## What it does
+
+Exposes the eCFR API as 13 MCP tools covering regulatory text, structure, search, version history, and common acquisition workflows:
+
+**Core endpoints**
+- `get_latest_date` - Get the most recent available date for a CFR title (call before other tools)
+- `get_cfr_content` - Get parsed regulatory text for a section, subpart, or part
+- `get_cfr_structure` - Hierarchical table of contents
+- `get_version_history` - Amendment history for a section or part
+- `get_ancestry` - Breadcrumb hierarchy path
+- `search_cfr` - Full-text search with hierarchy filters
+- `list_agencies` - All agencies with their CFR references
+- `get_corrections` - Editorial corrections for a title
+
+**Workflow convenience**
+- `lookup_far_clause` - One-call FAR/DFARS clause text lookup (auto-resolves date)
+- `compare_versions` - Side-by-side text comparison at two dates
+- `list_sections_in_part` - All sections in a FAR/DFARS part
+- `find_far_definition` - Search FAR 2.101 for a term definition
+- `find_recent_changes` - Sections modified since a given date
+
+## No authentication required
+
+The eCFR API is fully public. No API key, no registration, no auth headers. Just install and use.
+
+## Installation
+
+### Via uvx (recommended)
+
+```bash
+uvx ecfr-mcp
+```
+
+### Via pip
+
+```bash
+pip install ecfr-mcp
+```
+
+### From source
+
+```bash
+git clone https://github.com/1102tools/ecfr-mcp.git
+cd ecfr-mcp
+pip install -e .
+```
+
+## Claude Desktop configuration
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ecfr": {
+      "command": "uvx",
+      "args": ["ecfr-mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The `ecfr` server appears in your MCP tools panel with 13 tools.
+
+## Example prompts
+
+- "Pull the current text of FAR 15.305 (Proposal Evaluation) and summarize what it requires."
+- "List all sections in FAR Part 19 (Small Business Programs)."
+- "Look up the FAR definition of 'commercial product' in 2.101."
+- "What FAR sections were amended in the last 6 months?"
+- "Compare FAR 52.212-4 between 2024-01-01 and 2025-01-01 and show me what changed."
+- "Get the current text of DFARS 252.227-7014 (Rights in Noncommercial Computer Software)."
+- "Search Title 48 for 'organizational conflict of interest' and show me the relevant sections."
+- "Which agency owns Chapter 8 in Title 48? Get their FAR supplement structure."
+
+## Design notes
+
+- **XML parsed server-side.** The eCFR content endpoint returns raw XML. This server parses it into clean text (headings, paragraphs, citations) before returning to Claude, saving significant context tokens.
+- **Automatic date resolution.** eCFR lags 1-2 business days behind the Federal Register. Using today's date on versioner endpoints causes 404 errors. All content tools auto-resolve to the latest available date unless you specify one.
+- **Search defaults to current text.** Without `date=current`, eCFR search returns ALL historical versions including superseded. Default `current_only=True` prevents duplicate results.
+- **Structure endpoint limitation.** The eCFR structure endpoint does not support section-level filtering (returns 400). `list_sections_in_part` works around this by fetching the part structure and walking the tree.
+- **FAR 2.101 optimization.** The definitions section is ~109KB of XML. `find_far_definition` parses the full section server-side and returns only matching paragraphs with context.
+
+## CFR Title 48 quick reference
+
+| Chapter | Regulation | Parts |
+|---|---|---|
+| 1 | FAR | 1-99 |
+| 2 | DFARS | 200-299 |
+| 3 | HHSAR | 300-399 |
+| 4 | AGAR | 400-499 |
+| 5 | GSAR | 500-599 |
+| 6 | DOSAR | 600-699 |
+| 7 | AIDAR | 700-799 |
+| 8 | VAAR | 800-899 |
+| 9 | DEAR | 900-999 |
+| 18 | NFS | 1800-1899 |
+
+## Data source
+
+All data from [ecfr.gov](https://www.ecfr.gov), the continuously updated online Code of Federal Regulations maintained by the Office of the Federal Register. Updated daily, typically 1-2 business days after Federal Register publication. Not an official legal edition; for official citations reference the annual CFR from GPO.
+
+## Companion skill
+
+This MCP mirrors the `ecfr-api` skill from [1102tools.com](https://1102tools.com). The skill is markdown-based for interactive Claude use; the MCP wraps the same API as deterministic tool calls for agent workflows and automation.
+
+## License
+
+MIT

ecfr_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "ecfr-mcp"
+version = "0.1.0"
+description = "MCP server for the eCFR (Electronic Code of Federal Regulations) API. Read FAR, DFARS, and all agency FAR supplements."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "1102tools" }
+]
+keywords = ["mcp", "model-context-protocol", "ecfr", "cfr", "far", "dfars", "federal-acquisition", "regulations", "1102"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://1102tools.com"
+Repository = "https://github.com/1102tools/ecfr-mcp"
+Issues = "https://github.com/1102tools/ecfr-mcp/issues"
+
+[project.scripts]
+ecfr-mcp = "ecfr_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ecfr_mcp"]

ecfr_mcp-0.1.0/src/ecfr_mcp/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

ecfr_mcp-0.1.0/src/ecfr_mcp/constants.py

@@ -0,0 +1,58 @@
+"""Constants and reference data for the eCFR MCP server."""
+
+BASE_URL = "https://www.ecfr.gov"
+DEFAULT_TIMEOUT_JSON = 15.0
+DEFAULT_TIMEOUT_STRUCTURE = 30.0
+DEFAULT_TIMEOUT_CONTENT = 60.0
+USER_AGENT = "ecfr-mcp/0.1.0"
+
+# Search caps
+SEARCH_MAX_PER_PAGE = 5000
+SEARCH_MAX_TOTAL = 10000
+
+# Title 48 chapter map (Federal Acquisition Regulations System)
+TITLE_48_CHAPTERS: dict[str, str] = {
+    "1": "FAR (Parts 1-99)",
+    "2": "DFARS (Parts 200-299)",
+    "3": "HHSAR (Parts 300-399)",
+    "4": "AGAR (Parts 400-499)",
+    "5": "GSAR (Parts 500-599)",
+    "6": "DOSAR (Parts 600-699)",
+    "7": "AIDAR (Parts 700-799)",
+    "8": "VAAR (Parts 800-899)",
+    "9": "DEAR (Parts 900-999)",
+    "10": "DTAR (Parts 1000-1099)",
+    "12": "TAR (Parts 1200-1299)",
+    "13": "CAR (Parts 1300-1399)",
+    "14": "DIAR (Parts 1400-1499)",
+    "15": "EPAAR (Parts 1500-1599)",
+    "16": "OPMAR (Parts 1600-1699)",
+    "18": "NFS (Parts 1800-1899)",
+    "20": "NRCAR (Parts 2000-2099)",
+    "23": "SSAAR (Parts 2300-2399)",
+    "24": "HUDAR (Parts 2400-2499)",
+    "25": "NSFAR (Parts 2500-2599)",
+    "28": "JAR (Parts 2800-2899)",
+    "29": "DOLAR (Parts 2900-2999)",
+    "99": "CAS (Part 9900)",
+}
+
+# Common FAR sections for quick reference in tool descriptions
+COMMON_FAR_SECTIONS: dict[str, str] = {
+    "2.101": "Definitions",
+    "4.1102": "SAM policy",
+    "6.302-1": "Only one responsible source",
+    "9.104-1": "General standards of responsibility",
+    "9.406-2": "Causes for debarment",
+    "12.301": "Solicitation provisions (commercial)",
+    "13.003": "Simplified acquisition policy",
+    "15.305": "Proposal evaluation",
+    "15.306": "Exchanges with offerors",
+    "19.502-2": "Total small business set-asides",
+    "31.205": "Selected costs (allowability)",
+    "33.103": "Protests to the agency",
+    "42.302": "Contract administration functions",
+    "52.212-1": "Instructions to Offerors (Commercial)",
+    "52.212-4": "Contract Terms and Conditions (Commercial)",
+    "52.212-5": "Required Contract Terms (Commercial)",
+}