{"openapi":"3.0.3","info":{"title":"Gnist Context — Regulations.gov (US Federal Rulemaking)","description":"US federal rulemaking — search proposed rules, final rules, notices, and public comments across all federal agencies via Regulations.gov.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/regulations-gov/`\n- **Toolkit page:** `/toolkits/regulations-gov`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/regulations-gov/search_documents":{"post":{"tags":["Government"],"summary":"search_documents","description":"Search US federal regulatory documents on Regulations.gov.\n\nCovers proposed rules, final rules, notices, and supporting materials from all\nfederal agencies (EPA, FDA, SEC, DOT, etc.). Use to find active rulemaking,\ncomment periods, and regulatory actions.\n\nReturns:\n    List of matching documents with title, agency, docket, posting date, and\n    whether the document is open for public comment. Use document id with\n    get_document for full details.","operationId":"regulations_gov_search_documents","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"search_term":{"description":"Search term for federal regulatory documents (e.g. \"clean air\", \"data privacy\", \"drug safety\").","type":"string"},"agency_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by agency abbreviation (e.g. 'EPA', 'FDA', 'DOT', 'SEC', 'NHTSA')."},"document_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by type: 'Proposed Rule', 'Rule', 'Supporting & Related Material', 'Other'."},"posted_date_from":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter documents posted on or after this date (YYYY-MM-DD)."},"posted_date_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter documents posted on or before this date (YYYY-MM-DD)."},"docket_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by docket ID (e.g. 'EPA-HQ-OAR-2023-0434')."},"page_size":{"default":25,"description":"Number of results (5–25, default 25).","type":"integer"}},"required":["search_term"],"type":"object"}}}}}},"/rest/regulations-gov/get_document":{"post":{"tags":["Government"],"summary":"get_document","description":"Get detailed information about a specific federal regulatory document.\n\nReturns the full document record including agency, docket, dates, Federal Register\nnumber, and comment period details.\n\nReturns:\n    Document details including agency, docket, posting and comment dates,\n    and Federal Register number. Returns found=false if not found.","operationId":"regulations_gov_get_document","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"document_id":{"description":"Regulations.gov document ID (e.g. \"EPA-HQ-OAR-2023-0434-1020\"). Found in search results.","type":"string"}},"required":["document_id"],"type":"object"}}}}}},"/rest/regulations-gov/search_dockets":{"post":{"tags":["Government"],"summary":"search_dockets","description":"Search US federal regulatory dockets (rulemaking proceedings).\n\nA docket is a container for all documents related to a single rulemaking action.\nUse to find ongoing regulatory proceedings, track rulemaking history, and\nunderstand the scope of regulatory activity by agency.\n\nReturns:\n    List of matching dockets with title, agency, type, and last modified date.\n    Use docket id with get_docket for details, or filter search_documents by docket_id.","operationId":"regulations_gov_search_dockets","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"search_term":{"description":"Search term for regulatory dockets (e.g. \"emissions standards\", \"drug approval\", \"financial reporting\").","type":"string"},"agency_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by agency abbreviation (e.g. 'EPA', 'FDA', 'SEC')."},"page_size":{"default":25,"description":"Number of results (5–25, default 25).","type":"integer"}},"required":["search_term"],"type":"object"}}}}}},"/rest/regulations-gov/get_docket":{"post":{"tags":["Government"],"summary":"get_docket","description":"Get details for a specific regulatory docket.\n\nReturns:\n    Docket details including title, agency, type, and last modified date.\n    Returns found=false if not found.","operationId":"regulations_gov_get_docket","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"docket_id":{"description":"Docket ID (e.g. \"EPA-HQ-OAR-2023-0434\"). Found in search results or document records.","type":"string"}},"required":["docket_id"],"type":"object"}}}}}},"/rest/regulations-gov/search_comments":{"post":{"tags":["Government"],"summary":"search_comments","description":"Search public comments submitted on federal regulations.\n\nComments are submitted by individuals, organizations, and other stakeholders\nduring public comment periods on proposed rules and notices.\n\nReturns:\n    List of matching comments with title, agency, docket, and posting date.","operationId":"regulations_gov_search_comments","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"search_term":{"description":"Search term for public comments (e.g. \"oppose\", \"support\", \"environmental impact\").","type":"string"},"agency_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by agency abbreviation."},"docket_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by docket ID to see comments on a specific rulemaking."},"page_size":{"default":25,"description":"Number of results (5–25, default 25).","type":"integer"}},"required":["search_term"],"type":"object"}}}}}},"/rest/regulations-gov/report_feedback":{"post":{"tags":["Government"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"regulations_gov_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Government","description":"Data sources: Government"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}