`search_documents`

Pack: federal-register · Endpoint: https://gateway.pipeworx.io/federal-register/mcp

Search the US Federal Register for proposed rules, final rules, notices, and presidential documents. Returns title, abstract, agency, publication date, and links. Example: search_documents(“artificial intelligence”, type=“rule”)

Parameters

Name	Type	Required	Description
`query`	string	yes	Search keywords (e.g., “clean energy tax credit”)
`type`	string	no	Document type filter: “rule”, “proposed_rule”, “notice”, “presidential_document”
`agency`	string	no	Agency slug filter (e.g., “environmental-protection-agency”, “securities-and-exchange-commission”)

Example call

Arguments

{
  "query": "clean energy tax credit"
}

curl

curl -X POST https://gateway.pipeworx.io/federal-register/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_documents","arguments":{"query":"clean energy tax credit"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_documents', {
  "query": "clean energy tax credit"
});

More examples

{
  "query": "artificial intelligence",
  "type": "proposed_rule",
  "agency": "environmental-protection-agency"
}

Response shape

Always returns: query, total, returned, documents

Field	Type	Description
`query`	string	The search query string
`total`	number	Total count of matching documents
`returned`	number	Number of documents returned in this response
`documents`	array	Array of formatted Federal Register documents

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query string"
    },
    "total": {
      "type": "number",
      "description": "Total count of matching documents"
    },
    "returned": {
      "type": "number",
      "description": "Number of documents returned in this response"
    },
    "documents": {
      "type": "array",
      "description": "Array of formatted Federal Register documents",
      "items": {
        "type": "object",
        "properties": {
          "document_number": {
            "type": [
              "string",
              "null"
            ],
            "description": "Federal Register document number"
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Document title"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Document type (rule, notice, etc.)"
          },
          "abstract": {
            "type": [
              "string",
              "null"
            ],
            "description": "Document abstract or summary"
          },
          "citation": {
            "type": [
              "string",
              "null"
            ],
            "description": "Citation reference"
          },
          "publication_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Publication date (ISO format)"
          },
          "agencies": {
            "type": "array",
            "description": "List of responsible agencies",
            "items": {
              "type": "string"
            }
          },
          "html_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL to HTML version of document"
          },
          "pdf_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "URL to PDF version of document"
          },
          "action": {
            "type": [
              "string",
              "null"
            ],
            "description": "Action description"
          },
          "dates": {
            "type": [
              "string",
              "null"
            ],
            "description": "Key dates related to document"
          },
          "docket_ids": {
            "type": "array",
            "description": "Associated docket identifiers",
            "items": {
              "type": "string"
            }
          },
          "page_length": {
            "type": [
              "number",
              "null"
            ],
            "description": "Number of pages in document"
          },
          "significant": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether document is marked as significant"
          }
        }
      }
    }
  },
  "required": [
    "query",
    "total",
    "returned",
    "documents"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "federal-register": {
      "url": "https://gateway.pipeworx.io/federal-register/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_documents