@cyanheads/federal-regulations-mcp-server 0.2.4 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/AGENTS.md +21 -14
  2. package/CLAUDE.md +21 -14
  3. package/README.md +100 -131
  4. package/changelog/0.2.x/0.2.5.md +23 -0
  5. package/changelog/0.3.x/0.3.0.md +27 -0
  6. package/changelog/template.md +9 -26
  7. package/dist/index.d.ts +2 -1
  8. package/dist/index.d.ts.map +1 -1
  9. package/dist/index.js +56 -3
  10. package/dist/index.js.map +1 -1
  11. package/dist/mcp-server/resources/definitions/cfr-section.resource.d.ts +1 -0
  12. package/dist/mcp-server/resources/definitions/cfr-section.resource.d.ts.map +1 -1
  13. package/dist/mcp-server/resources/definitions/cfr-section.resource.js +1 -0
  14. package/dist/mcp-server/resources/definitions/cfr-section.resource.js.map +1 -1
  15. package/dist/mcp-server/resources/definitions/document.resource.js +1 -1
  16. package/dist/mcp-server/resources/definitions/document.resource.js.map +1 -1
  17. package/dist/mcp-server/resources/definitions/index.d.ts +1 -0
  18. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -1
  19. package/dist/mcp-server/tools/definitions/browse-cfr.tool.d.ts +3 -0
  20. package/dist/mcp-server/tools/definitions/browse-cfr.tool.d.ts.map +1 -1
  21. package/dist/mcp-server/tools/definitions/browse-cfr.tool.js +3 -0
  22. package/dist/mcp-server/tools/definitions/browse-cfr.tool.js.map +1 -1
  23. package/dist/mcp-server/tools/definitions/date-input.d.ts +14 -0
  24. package/dist/mcp-server/tools/definitions/date-input.d.ts.map +1 -0
  25. package/dist/mcp-server/tools/definitions/date-input.js +27 -0
  26. package/dist/mcp-server/tools/definitions/date-input.js.map +1 -0
  27. package/dist/mcp-server/tools/definitions/find-comments.tool.d.ts +2 -0
  28. package/dist/mcp-server/tools/definitions/find-comments.tool.d.ts.map +1 -1
  29. package/dist/mcp-server/tools/definitions/find-comments.tool.js +2 -0
  30. package/dist/mcp-server/tools/definitions/find-comments.tool.js.map +1 -1
  31. package/dist/mcp-server/tools/definitions/format-utils.d.ts +20 -1
  32. package/dist/mcp-server/tools/definitions/format-utils.d.ts.map +1 -1
  33. package/dist/mcp-server/tools/definitions/format-utils.js +22 -2
  34. package/dist/mcp-server/tools/definitions/format-utils.js.map +1 -1
  35. package/dist/mcp-server/tools/definitions/get-cfr-section.tool.d.ts +1 -0
  36. package/dist/mcp-server/tools/definitions/get-cfr-section.tool.d.ts.map +1 -1
  37. package/dist/mcp-server/tools/definitions/get-cfr-section.tool.js +1 -0
  38. package/dist/mcp-server/tools/definitions/get-cfr-section.tool.js.map +1 -1
  39. package/dist/mcp-server/tools/definitions/get-docket.tool.d.ts +3 -0
  40. package/dist/mcp-server/tools/definitions/get-docket.tool.d.ts.map +1 -1
  41. package/dist/mcp-server/tools/definitions/get-docket.tool.js +3 -0
  42. package/dist/mcp-server/tools/definitions/get-docket.tool.js.map +1 -1
  43. package/dist/mcp-server/tools/definitions/get-document.tool.d.ts +23 -4
  44. package/dist/mcp-server/tools/definitions/get-document.tool.d.ts.map +1 -1
  45. package/dist/mcp-server/tools/definitions/get-document.tool.js +88 -11
  46. package/dist/mcp-server/tools/definitions/get-document.tool.js.map +1 -1
  47. package/dist/mcp-server/tools/definitions/index.d.ts +142 -83
  48. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  49. package/dist/mcp-server/tools/definitions/list-open-comments.tool.d.ts +26 -6
  50. package/dist/mcp-server/tools/definitions/list-open-comments.tool.d.ts.map +1 -1
  51. package/dist/mcp-server/tools/definitions/list-open-comments.tool.js +107 -56
  52. package/dist/mcp-server/tools/definitions/list-open-comments.tool.js.map +1 -1
  53. package/dist/mcp-server/tools/definitions/search-rules.tool.d.ts +18 -3
  54. package/dist/mcp-server/tools/definitions/search-rules.tool.d.ts.map +1 -1
  55. package/dist/mcp-server/tools/definitions/search-rules.tool.js +38 -26
  56. package/dist/mcp-server/tools/definitions/search-rules.tool.js.map +1 -1
  57. package/dist/services/ecfr/ecfr-service.js +2 -2
  58. package/dist/services/ecfr-mirror/ecfr-mirror.d.ts +10 -6
  59. package/dist/services/ecfr-mirror/ecfr-mirror.d.ts.map +1 -1
  60. package/dist/services/ecfr-mirror/ecfr-mirror.js +17 -12
  61. package/dist/services/ecfr-mirror/ecfr-mirror.js.map +1 -1
  62. package/dist/services/federal-register/federal-register-service.d.ts +16 -6
  63. package/dist/services/federal-register/federal-register-service.d.ts.map +1 -1
  64. package/dist/services/federal-register/federal-register-service.js +233 -35
  65. package/dist/services/federal-register/federal-register-service.js.map +1 -1
  66. package/dist/services/federal-register/types.d.ts +38 -8
  67. package/dist/services/federal-register/types.d.ts.map +1 -1
  68. package/dist/services/regulations-gov/regulations-gov-service.js +2 -2
  69. package/dist/services/upstream-failure.d.ts +1 -1
  70. package/package.json +19 -9
  71. package/server.json +3 -3
@@ -9,6 +9,14 @@ export interface CfrReference {
9
9
  part: string;
10
10
  title: number;
11
11
  }
12
+ /**
13
+ * One issuing agency. `slug` is the value the `agencies` search filter takes;
14
+ * null when the Federal Register lists the agency by raw name only.
15
+ */
16
+ export interface FrAgency {
17
+ name: string;
18
+ slug: string | null;
19
+ }
12
20
  /** Raw `regulations_dot_gov_info` block embedded in a Federal Register document. */
13
21
  export interface RawRegulationsDotGovInfo {
14
22
  comments_count?: number | null;
@@ -26,9 +34,9 @@ export interface RawFrDocument {
26
34
  action?: string | null;
27
35
  agencies?: Array<{
28
36
  name?: string | null;
37
+ raw_name?: string | null;
29
38
  slug?: string | null;
30
39
  }> | null;
31
- agency_names?: string[] | null;
32
40
  body_html_url?: string | null;
33
41
  cfr_references?: Array<{
34
42
  title?: number | null;
@@ -58,7 +66,7 @@ export interface RawFrSearchResponse {
58
66
  /** Normalized search-result row. */
59
67
  export interface FrSearchResult {
60
68
  abstract: string | null;
61
- agencies: string[];
69
+ agencies: FrAgency[];
62
70
  cfrReferences: CfrReference[];
63
71
  commentsCloseOn: string | null;
64
72
  docketIds: string[];
@@ -79,7 +87,7 @@ export interface FrSearchResponse {
79
87
  export interface FrDocumentDetail {
80
88
  abstract: string | null;
81
89
  action: string | null;
82
- agencies: string[];
90
+ agencies: FrAgency[];
83
91
  bodyHtmlUrl: string;
84
92
  cfrReferences: CfrReference[];
85
93
  commentCount: number | null;
@@ -88,7 +96,14 @@ export interface FrDocumentDetail {
88
96
  docketId: string | null;
89
97
  documentNumber: string;
90
98
  effectiveOn: string | null;
99
+ /** One window of the plain-text body — present only when a window was requested. */
91
100
  fullText?: string;
101
+ /** Characters in the whole plain-text body — present with `fullText`. */
102
+ fullTextLength?: number;
103
+ /** Offset the next window starts at — present only when body text remains past this window. */
104
+ fullTextNextOffset?: number;
105
+ /** Offset `fullText` starts at in the whole body — present with `fullText`. */
106
+ fullTextOffset?: number;
92
107
  htmlUrl: string;
93
108
  publicationDate: string;
94
109
  rawTextUrl: string;
@@ -103,7 +118,7 @@ export interface FrDocumentDetail {
103
118
  }
104
119
  /** Normalized open-comment-window row (FR-only; comment count enriched separately). */
105
120
  export interface OpenCommentRule {
106
- agencies: string[];
121
+ agencies: FrAgency[];
107
122
  commentCount: number | null;
108
123
  commentsCloseOn: string;
109
124
  docketIds: string[];
@@ -112,14 +127,21 @@ export interface OpenCommentRule {
112
127
  title: string;
113
128
  type: string;
114
129
  }
115
- /** Normalized open-comment-window response. */
130
+ /**
131
+ * The whole open-comment window, sorted by close date then document number.
132
+ * `truncated` is set when the Federal Register reported its 10,000-item maximum,
133
+ * so the window holds only the 10,000 most recently published matches.
134
+ */
116
135
  export interface OpenCommentsResponse {
117
136
  results: OpenCommentRule[];
118
- totalCount: number;
137
+ truncated: boolean;
119
138
  }
139
+ /** Result orders the Federal Register documents endpoint accepts. */
140
+ export type FrSearchOrder = 'relevance' | 'newest' | 'oldest';
120
141
  /** Parameters for a Federal Register document search. */
121
142
  export interface FrSearchParams {
122
143
  agencies?: string[] | undefined;
144
+ order: FrSearchOrder;
123
145
  page: number;
124
146
  perPage: number;
125
147
  publishedAfter?: string | undefined;
@@ -127,12 +149,20 @@ export interface FrSearchParams {
127
149
  query?: string | undefined;
128
150
  types?: string[] | undefined;
129
151
  }
152
+ /** Federal Register document types that carry a comment period. */
153
+ export type OpenCommentType = 'PRORULE' | 'RULE' | 'NOTICE';
130
154
  /** Parameters for the open-comment-window query. */
131
155
  export interface OpenCommentsParams {
132
156
  agencies?: string[] | undefined;
133
157
  closingBefore?: string | undefined;
134
- page: number;
135
- perPage: number;
158
+ /** Request each document's Regulations.gov block, the source of its comment count. */
159
+ includeCommentCounts: boolean;
136
160
  query?: string | undefined;
161
+ types: readonly OpenCommentType[];
162
+ }
163
+ /** Which slice of a document's plain-text body to return. */
164
+ export interface FullTextWindow {
165
+ maxChars: number;
166
+ offset: number;
137
167
  }
138
168
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/federal-register/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/federal-register/types.ts"],"names":[],"mappings":"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"}
@@ -18,8 +18,8 @@
18
18
  import { internalError, JsonRpcErrorCode, McpError, notFound, rateLimited, unauthorized, validationError, } from '@cyanheads/mcp-ts-core/errors';
19
19
  import { httpErrorFromResponse, withExtra } from '@cyanheads/mcp-ts-core/utils';
20
20
  import { getServerConfig } from '../../config/server-config.js';
21
- import { requestBudget } from '../../services/request-budget.js';
22
- import { fetchUpstream, rethrowTransportFailure, retryTransportOnly, runUpstream, } from '../../services/upstream-failure.js';
21
+ import { requestBudget } from '../request-budget.js';
22
+ import { fetchUpstream, rethrowTransportFailure, retryTransportOnly, runUpstream, } from '../upstream-failure.js';
23
23
  const BASE_DELAY_MS = 1500;
24
24
  /**
25
25
  * Per-attempt deadline. Matches the Federal Register leg rather than eCFR's
@@ -26,7 +26,7 @@
26
26
  */
27
27
  import type { Context } from '@cyanheads/mcp-ts-core';
28
28
  import { type RequestContext } from '@cyanheads/mcp-ts-core/utils';
29
- import type { RequestBudget } from '../services/request-budget.js';
29
+ import type { RequestBudget } from './request-budget.js';
30
30
  /** Identifies the request in the raised error's message and `data`. */
31
31
  interface UpstreamRequestContext {
32
32
  /** Service method raising the request, e.g. `RegulationsGovService.getDocket`. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cyanheads/federal-regulations-mcp-server",
3
- "version": "0.2.4",
3
+ "version": "0.3.0",
4
4
  "mcpName": "io.github.cyanheads/federal-regulations-mcp-server",
5
5
  "description": "Search and trace US federal rules across the Federal Register (proposed/final rules and notices), the eCFR (codified, point-in-time CFR full text, locally mirrored), and Regulations.gov (rulemaking dockets and public comments) via MCP. STDIO or Streamable HTTP.",
6
6
  "type": "module",
@@ -72,16 +72,26 @@
72
72
  "packageManager": "bun@1.4.0",
73
73
  "author": "Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)",
74
74
  "engines": {
75
- "bun": ">=1.3.0",
75
+ "bun": ">=1.4.0",
76
76
  "node": ">=24.0.0"
77
77
  },
78
+ "funding": [
79
+ {
80
+ "type": "github",
81
+ "url": "https://github.com/sponsors/cyanheads"
82
+ },
83
+ {
84
+ "type": "buy_me_a_coffee",
85
+ "url": "https://www.buymeacoffee.com/cyanheads"
86
+ }
87
+ ],
78
88
  "publishConfig": {
79
89
  "access": "public"
80
90
  },
81
91
  "dependencies": {
82
- "@cyanheads/mcp-ts-core": "0.12.3",
92
+ "@cyanheads/mcp-ts-core": "0.13.6",
83
93
  "pino-pretty": "^13.1.3",
84
- "zod": "^4.4.3"
94
+ "zod": "^4.6.5"
85
95
  },
86
96
  "overrides": {
87
97
  "body-parser": "^2.3.0",
@@ -92,14 +102,14 @@
92
102
  "postcss": "^8.5.23"
93
103
  },
94
104
  "devDependencies": {
95
- "@biomejs/biome": "2.5.9",
105
+ "@biomejs/biome": "2.5.14",
96
106
  "@socketsecurity/bun-security-scanner": "^1.1.2",
97
- "@types/node": "26.2.0",
107
+ "@types/node": "26.6.1",
98
108
  "better-sqlite3": "^13.0.3",
99
109
  "depcheck": "^1.4.7",
100
- "ignore": "^7.0.6",
101
- "tsc-alias": "^1.9.2",
110
+ "ignore": "^7.0.9",
111
+ "tsc-alias": "^1.9.5",
102
112
  "typescript": "^7.0.2",
103
- "vitest": "^4.1.11"
113
+ "vitest": "^5.0.1"
104
114
  }
105
115
  }
package/server.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "url": "https://github.com/cyanheads/federal-regulations-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.2.4",
9
+ "version": "0.3.0",
10
10
  "remotes": [
11
11
  {
12
12
  "type": "streamable-http",
@@ -19,7 +19,7 @@
19
19
  "registryBaseUrl": "https://registry.npmjs.org",
20
20
  "identifier": "@cyanheads/federal-regulations-mcp-server",
21
21
  "runtimeHint": "node",
22
- "version": "0.2.4",
22
+ "version": "0.3.0",
23
23
  "packageArguments": [
24
24
  {
25
25
  "type": "positional",
@@ -55,7 +55,7 @@
55
55
  "registryBaseUrl": "https://registry.npmjs.org",
56
56
  "identifier": "@cyanheads/federal-regulations-mcp-server",
57
57
  "runtimeHint": "node",
58
- "version": "0.2.4",
58
+ "version": "0.3.0",
59
59
  "packageArguments": [
60
60
  {
61
61
  "type": "positional",