> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dncscrub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# search_compliance_guide Tool

> Search DNCScrub's Compliance Guide and return ranked, citable regulatory content for AI agents

The `search_compliance_guide` tool performs a retrieval-augmented (RAG) search over DNCScrub's Compliance Guide — the authoritative source for federal and state telemarketing, TCPA, and Do Not Call regulatory guidance — and returns the most relevant content chunks, each with a source name and a link to the Compliance Guide.

Use it to **ground compliance answers in source material** before responding. Do not answer regulatory questions from memory alone; search the guide first to ensure accuracy.

## When to Use

* Answering questions about DNC rules, TCPA requirements, or state-specific calling restrictions
* Looking up call-time windows, holiday restrictions, or registration requirements
* Researching EBR (Established Business Relationship), consent rules, or penalties
* Grounding an AI agent's compliance decisions in DNCScrub's authoritative guidance

<Note>
  For checking whether a specific phone number can legally be called, use [`scrub_phone_numbers`](/mcp/applications/scrub-phones) instead. This tool returns regulatory *guidance*, not a per-number compliance result.
</Note>

## Parameters

<ParamField body="query" type="string" required>
  Natural-language question to search the Compliance Guide for, e.g. "What are the call time restrictions in Florida?" Include any state, topic, or channel directly in the query text — the search is semantic.
</ParamField>

<ParamField body="topN" type="number">
  Maximum number of ranked chunks to return (1-25, default 20).
</ParamField>

<ParamField body="loginId" type="string">
  API key. Only required if not provided via the `x-dncscrub-api-key` HTTP header.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the search succeeded.
</ResponseField>

<ResponseField name="results" type="array">
  Ranked content chunks, most relevant first.

  <Expandable title="result object">
    <ResponseField name="text" type="string">
      Relevant excerpt of Compliance Guide content.
    </ResponseField>

    <ResponseField name="source" type="string">
      Human-readable name of the source document.
    </ResponseField>

    <ResponseField name="sourceUrl" type="string">
      Link into the Compliance Guide for citation.
    </ResponseField>

    <ResponseField name="relevanceScore" type="number">
      Semantic relevance score (higher is more relevant).
    </ResponseField>

    <ResponseField name="chunkId" type="string">
      Stable identifier of the chunk within the search index.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="resultCount" type="number">
  Number of chunks returned.
</ResponseField>

<ResponseField name="searchTimeMs" type="number">
  Time the search took, in milliseconds.
</ResponseField>

<ResponseField name="errorCode" type="string">
  Machine-readable error code (when failed): `MISSING_INPUT`, `MISSING_API_KEY`, `INVALID_API_KEY`, or `API_ERROR`.
</ResponseField>

<ResponseField name="errorMessage" type="string">
  Human-readable error description (when failed).
</ResponseField>

## Examples

<Tabs>
  <Tab title="Request">
    ```json theme={null}
    {
      "query": "What are the call time restrictions in Florida?",
      "topN": 3
    }
    ```
  </Tab>

  <Tab title="Response">
    ```json theme={null}
    {
      "success": true,
      "results": [
        {
          "text": "Florida prohibits telephone solicitation calls before 8:00 AM or after 8:00 PM local time...",
          "source": "Time Restriction",
          "sourceUrl": "https://www.dncscrub.com/compliance-guide/regulatory-guide",
          "relevanceScore": 3.42,
          "chunkId": "call-times-0"
        }
      ],
      "resultCount": 1,
      "searchTimeMs": 88
    }
    ```
  </Tab>
</Tabs>

## Usage Notes

* Access requires a DNCScrub API key with Compliance Guide entitlement, the same authorization used by the other Compliance Guide tools.
* The search is semantic — put any state, topic, or channel directly in the `query` text (e.g. "SMS call-time restrictions in Florida") rather than as separate parameters.
* Always cite the returned `sourceUrl` when relaying guidance to an end user.
* Results are excerpts of authoritative guidance; treat them as the most accurate source and prefer them over model priors.