@cyanheads/federal-regulations-mcp-server 0.1.0

package/dist/services/regulations-gov/regulations-gov-service.js

@@ -0,0 +1,283 @@
+/**
+ * @fileoverview RegulationsGovService — keyed client for the Regulations.gov v4
+ * API (api.regulations.gov/v4, `X-Api-Key`). Backs `get_docket` and
+ * `find_comments`, and enriches `list_open_comments`. JSON:API responses are
+ * unwrapped to flat domain objects. The key is optional at the service level
+ * (`hasKey()` lets keyless tools degrade or throw `auth_required`); 429s carry a
+ * distinct `rate_limited` signal via `Retry-After`. Comment bodies are
+ * HTML-stripped and attachment-primary submissions flagged.
+ * @module services/regulations-gov/regulations-gov-service
+ */
+import { internalError, notFound, rateLimited } from '@cyanheads/mcp-ts-core/errors';
+import { httpErrorFromResponse, withRetry } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from '../../config/server-config.js';
+import { toRequestContext } from '../../services/request-context.js';
+const BASE_DELAY_MS = 1500;
+export class RegulationsGovService {
+    baseUrl;
+    apiKey;
+    constructor(_config, _storage) {
+        const cfg = getServerConfig();
+        this.baseUrl = cfg.regulationsGovBaseUrl.replace(/\/$/, '');
+        this.apiKey = cfg.regulationsGovApiKey;
+    }
+    /** Whether a Regulations.gov API key is configured. */
+    hasKey() {
+        return typeof this.apiKey === 'string' && this.apiKey.length > 0;
+    }
+    /** Fetch a docket's metadata plus the documents filed in it. */
+    async getDocket(params, ctx) {
+        const docketUrl = `${this.baseUrl}/dockets/${encodeURIComponent(params.docketId)}`;
+        const docketRaw = await this.fetchJson(docketUrl, ctx, 'RegulationsGovService.getDocket');
+        const attrs = docketRaw.data?.attributes ?? {};
+        const docSearch = new URLSearchParams({
+            'filter[docketId]': params.docketId,
+            'page[size]': String(params.perPage),
+            'page[number]': String(params.page),
+            sort: '-postedDate',
+        });
+        for (const type of params.documentTypes ?? []) {
+            docSearch.append('filter[documentType]', type);
+        }
+        const docsUrl = `${this.baseUrl}/documents?${docSearch.toString()}`;
+        const docsRaw = await this.fetchJson(docsUrl, ctx, 'RegulationsGovService.getDocketDocuments');
+        const documents = (docsRaw.data ?? [])
+            .map((d) => normalizeDocument(d))
+            .filter((d) => d !== null);
+        return {
+            docketId: params.docketId,
+            title: attrs.title ?? '(untitled docket)',
+            docketType: attrs.docketType ?? null,
+            agencyId: attrs.agencyId ?? null,
+            rin: attrs.rin ?? null,
+            abstract: attrs.dkAbstract ?? null,
+            modifyDate: attrs.modifyDate ?? null,
+            objectId: attrs.objectId ?? null,
+            documentCount: docsRaw.meta?.totalElements ?? documents.length,
+            documents,
+        };
+    }
+    /** List comments on a document (by object ID) or a docket (by docket ID). */
+    async listComments(params, ctx) {
+        const search = new URLSearchParams({
+            'page[size]': String(params.perPage),
+            'page[number]': String(params.page),
+            sort: '-postedDate',
+        });
+        if ('commentOnId' in params.filter) {
+            search.set('filter[commentOnId]', params.filter.commentOnId);
+        }
+        else {
+            search.set('filter[docketId]', params.filter.docketId);
+        }
+        const url = `${this.baseUrl}/comments?${search.toString()}`;
+        const raw = await this.fetchJson(url, ctx, 'RegulationsGovService.listComments');
+        const comments = (raw.data ?? [])
+            .map((c) => normalizeCommentSummary(c))
+            .filter((c) => c !== null);
+        return { totalCount: raw.meta?.totalElements ?? comments.length, comments };
+    }
+    /** Fetch one comment's full detail and attachments by comment ID. */
+    async getComment(commentId, ctx) {
+        const url = `${this.baseUrl}/comments/${encodeURIComponent(commentId)}?include=attachments`;
+        const raw = await this.fetchJson(url, ctx, 'RegulationsGovService.getComment');
+        return normalizeCommentDetail(commentId, raw);
+    }
+    /**
+     * Resolve a Federal Register document number to its Regulations.gov primary
+     * document object ID, via `filter[searchTerm]` on the FR number. Returns null
+     * when no matching document is found.
+     */
+    async resolveFrDocumentObjectId(frDocumentNumber, ctx) {
+        const search = new URLSearchParams({
+            'filter[searchTerm]': frDocumentNumber,
+            'page[size]': '5',
+            'page[number]': '1',
+        });
+        const url = `${this.baseUrl}/documents?${search.toString()}`;
+        const raw = await this.fetchJson(url, ctx, 'RegulationsGovService.resolveFrDocument');
+        for (const d of raw.data ?? []) {
+            if (d.attributes?.frDocNum === frDocumentNumber && d.attributes?.objectId) {
+                return d.attributes.objectId;
+            }
+        }
+        // Fall back to the first result's objectId if present.
+        const first = (raw.data ?? [])[0];
+        return first?.attributes?.objectId ?? null;
+    }
+    /** Fetch + parse JSON with key header and retry; maps 429 → rate_limited. */
+    fetchJson(url, ctx, operation) {
+        const key = this.apiKey;
+        if (!key) {
+            // Unreachable in normal operation: both keyed tools gate on hasKey() and
+            // throw auth_required before any service call. An invariant violation here
+            // is a programmer error (a caller bypassed the gate), not an operational one.
+            throw internalError('RegulationsGovService called without an API key.', { operation });
+        }
+        const reqCtx = toRequestContext(ctx, operation);
+        return withRetry(async () => {
+            const response = await fetch(url, {
+                headers: { 'X-Api-Key': key, Accept: 'application/vnd.api+json' },
+                signal: ctx.signal,
+            });
+            if (!response.ok) {
+                if (response.status === 429) {
+                    const retryAfter = response.headers.get('retry-after');
+                    // Fail fast on the shared key's hourly limit: surface rate_limited so
+                    // the agent backs off, rather than retry-storming the same key.
+                    // `retryable: false` opts this throw out of withRetry's retry loop.
+                    throw rateLimited('Regulations.gov rate limit hit (1,000 requests/hour per key).', {
+                        reason: 'rate_limited',
+                        retryable: false,
+                        ...(retryAfter ? { retryAfter } : {}),
+                    });
+                }
+                if (response.status === 404) {
+                    // Translate the bare 404 into an actionable not_found so the tool's
+                    // contract recovery surfaces, rather than "returned HTTP 404".
+                    throw notFound('No matching docket, document, or comment found on Regulations.gov. Verify the ID (e.g. "EPA-HQ-OAR-2025-0194" for a docket).', { operation });
+                }
+                throw await httpErrorFromResponse(response, {
+                    service: 'Regulations.gov',
+                    data: { operation },
+                });
+            }
+            return (await response.json());
+        }, { operation, context: reqCtx, baseDelayMs: BASE_DELAY_MS, signal: ctx.signal });
+    }
+}
+function normalizeDocument(d) {
+    const a = d.attributes;
+    if (!d.id || !a?.objectId)
+        return null;
+    return {
+        documentId: d.id,
+        objectId: a.objectId,
+        title: a.title ?? '(untitled)',
+        documentType: a.documentType ?? 'Unknown',
+        postedDate: a.postedDate ?? '',
+        frDocNum: a.frDocNum ?? null,
+        commentEndDate: a.commentEndDate ?? null,
+        withdrawn: a.withdrawn ?? false,
+    };
+}
+function normalizeCommentSummary(c) {
+    const a = c.attributes;
+    if (!c.id)
+        return null;
+    return {
+        commentId: c.id,
+        title: a?.title ?? '(untitled comment)',
+        documentType: a?.documentType ?? 'Public Submission',
+        postedDate: a?.postedDate ?? '',
+        agencyId: a?.agencyId ?? null,
+        objectId: a?.objectId ?? '',
+        withdrawn: a?.withdrawn ?? false,
+    };
+}
+/** Collect attachments from a JSON:API `included[]` block. */
+function collectAttachments(included) {
+    return (included ?? [])
+        .filter((r) => r.type === 'attachments')
+        .map((r) => {
+        const formats = (r.attributes?.fileFormats ?? [])
+            .filter((f) => typeof f?.fileUrl === 'string' && f.fileUrl.length > 0)
+            .map((f) => ({
+            format: f.format ?? 'unknown',
+            fileUrl: f.fileUrl,
+            size: typeof f.size === 'number' ? f.size : null,
+        }));
+        return { title: r.attributes?.title ?? '(untitled attachment)', formats };
+    })
+        .filter((a) => a.formats.length > 0);
+}
+const HTML_NAMED_ENTITIES = {
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+    nbsp: ' ',
+    mdash: '—',
+    ndash: '–',
+    rsquo: '’',
+    lsquo: '‘',
+    ldquo: '“',
+    rdquo: '”',
+    hellip: '…',
+};
+/** Strip HTML tags + decode entities from a comment body. */
+function stripHtml(html) {
+    const text = html
+        .replace(/<\s*br\s*\/?>/gi, '\n')
+        .replace(/<\/(p|div|li)\s*>/gi, '\n')
+        .replace(/<[^>]+>/g, '');
+    return text
+        .replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z]+);/g, (match, body) => {
+        if (body.startsWith('#x') || body.startsWith('#X')) {
+            const code = Number.parseInt(body.slice(2), 16);
+            return Number.isNaN(code) ? match : String.fromCodePoint(code);
+        }
+        if (body.startsWith('#')) {
+            const code = Number.parseInt(body.slice(1), 10);
+            return Number.isNaN(code) ? match : String.fromCodePoint(code);
+        }
+        return HTML_NAMED_ENTITIES[body] ?? match;
+    })
+        .replace(/[ \t]+/g, ' ')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+/**
+ * A body that is empty or a "see attached" stub signals attachment-primary
+ * content. Regulations.gov emits several stub phrasings for attachment-only
+ * submissions — "See attached", "See attached file", "See attached file(s)",
+ * "See attachment(s)", "See attached document(s)", "Please see attached", etc.
+ * Match the whole family: an optional lead-in, "see attach(ed|ment)", an optional
+ * noun (file/document/comment, singular or plural with optional "(s)"), and
+ * trailing punctuation — nothing substantive beyond that.
+ */
+function isStubBody(text) {
+    if (!text)
+        return true;
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return true;
+    // (please) see (the) attach{ed|ment(s)|ments} (file|document|comment){s|(s)}? .
+    return /^(please\s+)?see\s+(the\s+)?attach(ed|ment\(s\)|ments?)(\s+(file|document|comment)s?(\(s\))?)?\.?$/i.test(trimmed);
+}
+function normalizeCommentDetail(commentId, raw) {
+    const a = raw.data?.attributes ?? {};
+    const attachments = collectAttachments(raw.included);
+    const bodyText = typeof a.comment === 'string' && a.comment.length > 0 ? stripHtml(a.comment) : null;
+    const submitterName = [a.firstName, a.lastName]
+        .filter((s) => typeof s === 'string' && s.length > 0)
+        .join(' ');
+    return {
+        commentId,
+        title: a.title ?? '(untitled comment)',
+        docketId: a.docketId ?? null,
+        commentOnDocumentId: a.commentOnDocumentId ?? null,
+        postedDate: a.postedDate ?? '',
+        receivedDate: a.receivedDate ?? null,
+        submitterName: submitterName.length > 0 ? submitterName : null,
+        organization: a.organization ?? null,
+        bodyText,
+        attachmentOnly: attachments.length > 0 && isStubBody(bodyText),
+        attachments,
+        withdrawn: a.withdrawn ?? false,
+        restrictReason: a.restrictReason ?? null,
+    };
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initRegulationsGovService(config, storage) {
+    _service = new RegulationsGovService(config, storage);
+}
+export function getRegulationsGovService() {
+    if (!_service) {
+        throw new Error('RegulationsGovService not initialized — call initRegulationsGovService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=regulations-gov-service.js.map

package/dist/services/regulations-gov/regulations-gov-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regulations-gov-service.js","sourceRoot":"","sources":["../../../src/services/regulations-gov/regulations-gov-service.ts"],"names":[],"mappings":"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"}

package/dist/services/regulations-gov/types.d.ts

@@ -0,0 +1,148 @@
+/**
+ * @fileoverview Domain and raw JSON:API types for the Regulations.gov v4 service
+ * (dockets, documents, comments). Raw types mirror the real (sparse) payloads.
+ * @module services/regulations-gov/types
+ */
+/** Generic JSON:API resource object. */
+export interface JsonApiResource<A> {
+    attributes?: A;
+    id?: string;
+    relationships?: Record<string, {
+        data?: Array<{
+            id?: string;
+            type?: string;
+        }> | null;
+    }>;
+    type?: string;
+}
+/** JSON:API list envelope. */
+export interface JsonApiList<A> {
+    data?: Array<JsonApiResource<A>>;
+    included?: Array<JsonApiResource<RawAttachmentAttributes>>;
+    meta?: {
+        totalElements?: number;
+        totalPages?: number;
+        hasNextPage?: boolean;
+        pageNumber?: number;
+        pageSize?: number;
+    } | null;
+}
+/** JSON:API single-resource envelope. */
+export interface JsonApiSingle<A> {
+    data?: JsonApiResource<A>;
+    included?: Array<JsonApiResource<RawAttachmentAttributes>>;
+}
+/** Raw docket attributes. */
+export interface RawDocketAttributes {
+    agencyId?: string | null;
+    dkAbstract?: string | null;
+    docketType?: string | null;
+    modifyDate?: string | null;
+    objectId?: string | null;
+    program?: string | null;
+    rin?: string | null;
+    title?: string | null;
+}
+/** Raw document attributes. */
+export interface RawDocumentAttributes {
+    commentEndDate?: string | null;
+    docketId?: string | null;
+    documentType?: string | null;
+    frDocNum?: string | null;
+    objectId?: string | null;
+    openForComment?: boolean | null;
+    postedDate?: string | null;
+    title?: string | null;
+    withdrawn?: boolean | null;
+}
+/** Raw comment attributes (list + detail). */
+export interface RawCommentAttributes {
+    agencyId?: string | null;
+    comment?: string | null;
+    commentOnDocumentId?: string | null;
+    docketId?: string | null;
+    documentType?: string | null;
+    firstName?: string | null;
+    lastName?: string | null;
+    objectId?: string | null;
+    organization?: string | null;
+    postedDate?: string | null;
+    receivedDate?: string | null;
+    restrictReason?: string | null;
+    title?: string | null;
+    withdrawn?: boolean | null;
+}
+/** Raw attachment record (from `included[]` when `?include=attachments`). */
+export interface RawAttachmentAttributes {
+    fileFormats?: Array<{
+        format?: string | null;
+        fileUrl?: string | null;
+        size?: number | null;
+    }> | null;
+    title?: string | null;
+}
+/** Normalized docket document. */
+export interface RegDocument {
+    commentEndDate: string | null;
+    documentId: string;
+    documentType: string;
+    frDocNum: string | null;
+    objectId: string;
+    postedDate: string;
+    title: string;
+    withdrawn: boolean;
+}
+/** Normalized docket result. */
+export interface DocketResult {
+    abstract: string | null;
+    agencyId: string | null;
+    docketId: string;
+    docketType: string | null;
+    documentCount: number;
+    documents: RegDocument[];
+    modifyDate: string | null;
+    objectId: string | null;
+    rin: string | null;
+    title: string;
+}
+/** Normalized comment summary (list mode). */
+export interface CommentSummary {
+    agencyId: string | null;
+    commentId: string;
+    documentType: string;
+    objectId: string;
+    postedDate: string;
+    title: string;
+    withdrawn: boolean;
+}
+/** Normalized comment list. */
+export interface CommentListResult {
+    comments: CommentSummary[];
+    totalCount: number;
+}
+/** Normalized attachment. */
+export interface CommentAttachment {
+    formats: Array<{
+        format: string;
+        fileUrl: string;
+        size: number | null;
+    }>;
+    title: string;
+}
+/** Normalized comment detail. */
+export interface CommentDetailResult {
+    attachmentOnly: boolean;
+    attachments: CommentAttachment[];
+    bodyText: string | null;
+    commentId: string;
+    commentOnDocumentId: string | null;
+    docketId: string | null;
+    organization: string | null;
+    postedDate: string;
+    receivedDate: string | null;
+    restrictReason: string | null;
+    submitterName: string | null;
+    title: string;
+    withdrawn: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/regulations-gov/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/regulations-gov/types.ts"],"names":[],"mappings":"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"}

package/dist/services/regulations-gov/types.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Domain and raw JSON:API types for the Regulations.gov v4 service
+ * (dockets, documents, comments). Raw types mirror the real (sparse) payloads.
+ * @module services/regulations-gov/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/regulations-gov/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/regulations-gov/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/services/request-context.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Shared helper to derive a framework `RequestContext` from the
+ * handler `Context` for the HTTP utilities (`fetchWithTimeout`, `withRetry`),
+ * which are typed against the open `RequestContext` bag rather than the closed
+ * handler `Context`. Centralizes the canonical-field projection so the three
+ * data-source services don't each repeat it.
+ * @module services/request-context
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { RequestContext } from '@cyanheads/mcp-ts-core/utils';
+/** Build a correlated `RequestContext` from a handler `Context` for an operation. */
+export declare function toRequestContext(ctx: Context, operation: string): RequestContext;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/services/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/services/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAWhF"}

package/dist/services/request-context.js

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Shared helper to derive a framework `RequestContext` from the
+ * handler `Context` for the HTTP utilities (`fetchWithTimeout`, `withRetry`),
+ * which are typed against the open `RequestContext` bag rather than the closed
+ * handler `Context`. Centralizes the canonical-field projection so the three
+ * data-source services don't each repeat it.
+ * @module services/request-context
+ */
+import { requestContextService } from '@cyanheads/mcp-ts-core/utils';
+/** Build a correlated `RequestContext` from a handler `Context` for an operation. */
+export function toRequestContext(ctx, operation) {
+    return requestContextService.createRequestContext({
+        operation,
+        parentContext: {
+            requestId: ctx.requestId,
+            timestamp: ctx.timestamp,
+            ...(ctx.traceId ? { traceId: ctx.traceId } : {}),
+            ...(ctx.spanId ? { spanId: ctx.spanId } : {}),
+            ...(ctx.tenantId ? { tenantId: ctx.tenantId } : {}),
+        },
+    });
+}
+//# sourceMappingURL=request-context.js.map

package/dist/services/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/services/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,qFAAqF;AACrF,MAAM,UAAU,gBAAgB,CAAC,GAAY,EAAE,SAAiB;IAC9D,OAAO,qBAAqB,CAAC,oBAAoB,CAAC;QAChD,SAAS;QACT,aAAa,EAAE;YACb,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpD;KACF,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@cyanheads/federal-regulations-mcp-server",
+  "version": "0.1.0",
+  "mcpName": "io.github.cyanheads/federal-regulations-mcp-server",
+  "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.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "federal-regulations-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "scripts/_mirror-context.ts",
+    "scripts/ecfr-mirror-init.ts",
+    "scripts/ecfr-mirror-refresh.ts",
+    "scripts/ecfr-mirror-verify.ts",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "bun run scripts/tree.ts",
+    "list-skills": "bun run scripts/list-skills.ts",
+    "format": "biome check --write .",
+    "format:unsafe": "biome check --write --unsafe .",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/federal-regulations-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/federal-regulations-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "release:github": "bun run scripts/release-github.ts",
+    "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
+    "mirror:init": "bun run scripts/ecfr-mirror-init.ts",
+    "mirror:refresh": "bun run scripts/ecfr-mirror-refresh.ts",
+    "mirror:verify": "bun run scripts/ecfr-mirror-verify.ts",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "federal-register",
+    "ecfr",
+    "cfr",
+    "regulations",
+    "regulations-gov",
+    "rulemaking",
+    "administrative-law"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/federal-regulations-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cyanheads/federal-regulations-mcp-server/issues"
+  },
+  "homepage": "https://github.com/cyanheads/federal-regulations-mcp-server#readme",
+  "license": "Apache-2.0",
+  "engines": {
+    "bun": ">=1.3.0",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.10.6",
+    "pino-pretty": "^13.1.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.0",
+    "@types/node": "25.9.3",
+    "better-sqlite3": "^12.0.0",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.17",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  }
+}