> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to the Vaquill MCP server

The Vaquill MCP connector routes your AI agent's tool calls to Vaquill's own MCP server through Scalekit. Each user signs in to Vaquill once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 37 tools.

**Authentication:** OAuth 2.1/DCR
**Categories:** Search, Files & Documents
**Tools:** 37: 37 read, 0 write, 0 destructive
**Users sign in with:** OAuth
**OAuth app:** Your own Vaquill MCP server app
**Built by:** Vendor MCP
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=VAQUILLMCP)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Vaquill MCP connection

   In **AgentKit > Connections**, create a Vaquill MCP connection and copy its redirect URI. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Register an OAuth app

   Vaquill MCP server connections use your own OAuth app. Register one with Vaquill MCP server and add the redirect URI you copied.

   Then enter the app's Client ID and Client Secret on the Vaquill MCP connection.

5. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'vaquillmcp'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Vaquill MCP:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'vaquillmcp_count_statute_sections',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "vaquillmcp"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Vaquill MCP:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="vaquillmcp_count_statute_sections",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'vaquillmcp_count_statute_sections',
  toolInput: {},
  connector: 'vaquillmcp',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="vaquillmcp_count_statute_sections",
    tool_input={},
    connection_name="vaquillmcp",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `vaquillmcp_count_statute_sections`

Count Sections in a Scope · Read-only

Exact section count for a jurisdiction, corpus, code, title, chapter or part, or the number of sections matching a Boolean expression (`query` with matchType `boolean`, syntax as search_us_statutes). Use to size a job before walking divisions or paging a Boolean search. A natural-language question cannot be counted. `isExact` false means an upper bound (phrases, proximity, or filters beyond corpusType, state and status). A zero count may indicate a wrong filter.  Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `actStatus` (`string`, optional): Count only sections carrying this status.
- `article` (`string`, optional): Article label (`Amendment XIV`) on CONSTITUTION / STATE_CONSTITUTION, or article number (`2-A`) on a STATE / REGULATION code divided by article. Same values and pairing rules as `article` on `/search`.
- `chapter` (`string`, optional): Chapter identifier. Pair with `titleNumber` or `code`.
- `code` (`string`, optional): State code identifier, e.g. `tx_26`. With `corpusType=FEDERAL_RULES`, a rule set instead (`frcp`, `uscapp_t28a_fre`). Same values and checks as `code` on `/search`.
- `corpusType` (`string`, optional): Corpus to count, single or list. Omit to count every corpus.
- `excludeRepealed` (`boolean`, optional): Only sections with an affirmatively dead status are excluded. Sections with no recorded status are kept. US Code uses a stored annual edition, so sections repealed after that edition closed are still counted. Default: `false`.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `matchType` (`string`, optional): `"boolean"` to count the sections satisfying `query`. Required with `query`.
- `part` (`string`, optional): CFR part identifier. Pair with `titleNumber`.
- `query` (`string`, optional): A Boolean expression to count, with matchType `boolean` (syntax as on search_us_statutes). Omit to count the whole scope. A natural-language question cannot be counted: rank it with search_us_statutes.
- `state` (`string`, optional): Two-letter jurisdiction code or `federal`, single or list.
- `titleNumber` (`string`, optional): USC or CFR title number.

Example input: `{}`

### `vaquillmcp_extract_statute_citations`

Extract Citations from Text · Read-only

Paste text (a brief, memo or answer) and get each distinct US statute, regulation, court rule and constitution citation, resolved to its section. Not case citations; extraction can miss one. Extraction is free (resolve=false); each distinct citation resolved is charged. Rows carry charStart/charEnd, rangeRole/rangePartner (range ends are two charged rows; `interior` rows are never charged) and counts.distinctSections. Up to 200,000 characters, never stored. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `text` (`string`, required): The text to read, 1 to 200,000 characters (a brief is about 30,000). Longer is a 422, never a silent truncation: a partial list reported as the whole is a wrong answer. Plain text; a body that is mostly binary is a 422.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `includeUnresolved` (`boolean`, optional): `false` drops rows that were sent to the resolver and did not resolve; rows with `skipped` set are always kept. `counts` and the charge are unchanged. Ignored when `resolve` is false. Default: `true`.
- `resolve` (`boolean`, optional): Resolve each distinct citation to its section (priced per distinct citation, see the endpoint's Cost). `false` returns the extraction alone, which is free. Default: `true`.
- `state` (`string`, optional): The document's jurisdiction as a two-letter state code (the forum of a filing). It scopes a citation that names no jurisdiction, such as `Civil Rule 56.1`; a citation naming its own is always checked against that one.

Example input: `{"text":"<text>"}`

### `vaquillmcp_fetch`

Fetch Document · Read-only

Fetch the full text of one US law section by the `id` from a `search` result, returning `{id, title, text, url, metadata}`. Also accepts a citation URL, a bare path, or a Bluebook citation such as '42 U.S.C. 1983'. Present for clients that require the standard search/fetch pair; prefer `get_us_statute_section_text` if available. Charged as a section lookup plus a body read.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): No description.

Example input: `{"id":"<id>"}`

### `vaquillmcp_get_credit_balance`

Credit Balance · Read-only

The credits this API key can spend now, calculated from live credit buckets under the same expiry rules used for billing. Use for pre-flight checks or low-balance alerts. creditsRemaining is a spendable balance, not a cached estimate. Any valid API key works without a particular scope, and normal rate limits still apply.  Free.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `vaquillmcp_get_part_rulemaking`

Federal Register Documents for a CFR Part · Read-only

Every Federal Register rule, proposed rule and notice whose CFR references include one title and part, newest first. The window is bounded to the `years` most recent publication years (default 5, max 12), and `coverage` says when a year was truncated. Use get_section_rulemaking for one section, and get_rulemaking_rin for the whole rulemaking behind a RIN. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `part` (`string`, required): CFR part number, e.g. `314`.
- `title` (`integer`, required): CFR title number (1 to 50).
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `years` (`integer`, optional): How many CALENDAR years of Federal Register publications to read: the current calendar year and the `years - 1` before it. It is not a trailing window of 365-day periods, so early in a year `years=1` covers only the days elapsed so far. The years read are echoed in `years`. Default: `5`.

Example input: `{"part":"314","title":1}`

### `vaquillmcp_get_pricing`

Credit Pricing · Read-only

Current API credit pricing: per-endpoint credit costs and the credit-to-currency conversion rate (1 credit = $0.01 USD). Free, and no authentication required. Use to check what a call will cost before making it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `region` (`string`, optional): Defaults to the jurisdiction of the documentation you are reading. If omitted, returns pricing only for that jurisdiction's endpoints, not prices across jurisdictions.

Example input: `{}`

### `vaquillmcp_get_rulemaking_committee_record`

Rules Committee Record · Read-only

One Rules Committee record by recordId (rcr_ plus 24 hex): its comment dockets, linked Federal Rules (method, confidence) and a window of page text (pageFrom, pageLimit; nextPage continues). Drafting history, not law. quality needs_ocr: no text yet; quality blank: really empty. Comments and suggestions (textWithheld: true) withhold title, filename, URLs and text. An unknown record is a refunded 404. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `record_id` (`string`, required): Committee record id from the list, `rcr_` and 24 hex characters.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `pageFrom` (`integer`, optional): First page of the record's text to return, counting from 1. Page through a long record by passing the page after the last one you received. Default: `1`.
- `pageLimit` (`integer`, optional): Pages per call. Default: `50`.

Example input: `{"record_id":"<record_id>"}`

### `vaquillmcp_get_rulemaking_coverage`

Rulemaking Coverage · Read-only

What the rulemaking store holds, per source: row counts, newest change, last successful refresh and a freshness verdict (ok, stale or unmeasured), the Unified Agenda editions held, and what is not included and why. Read it before treating a missing docket or RIN as absent. Free.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `vaquillmcp_get_rulemaking_docket`

Regulations.gov Docket · Read-only

One Regulations.gov docket, rulemaking or non-rulemaking: agency, type, title, abstract, the RIN when the agency entered one, when it was last modified, how many documents we hold and of which types, and the comment count when we measured it (null means not measured, never zero). Current state only; no comment text. Takes a docket_id such as EPA-HQ-OAR-2021-0208. An unknown docket is a 404 and is refunded. Read the documents with list_docket_documents. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `docket_id` (`string`, required): Regulations.gov docket id, for example `EPA-HQ-OAR-2021-0208`. Case is kept as printed.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.

Example input: `{"docket_id":"<docket_id>"}`

### `vaquillmcp_get_rulemaking_rin`

Rulemaking by RIN · Read-only

Everything we hold for one Regulation Identifier Number (NNNN-AANN, such as 2060-AV16): the latest Unified Agenda entry, OIRA reviews, Regulations.gov dockets, Federal Register documents by role (proposed, final, correction), CFR parts, public laws and related RINs, each link with its basis and quality. An ambiguous link carries no pick. `coverage` lists what we do not hold. An unknown RIN is a 404 and is refunded. For edition history use list_rin_agenda. Cost: 3 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `rin` (`string`, required): Regulation Identifier Number `NNNN-XXNN`; lower case is accepted.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.

Example input: `{"rin":"<rin>"}`

### `vaquillmcp_get_section_changes`

Section Change History · Read-only

What our refreshes have observed changing on one section over time: when it was added, amended or removed, newest first. This is our capture history, not the publisher's -- an empty list means we recorded no change, never that the section was never amended. For the publisher's own history, read amendmentHistory on the section. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `act_id` (`string`, required): Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.
- `beforeId` (`string`, optional): Return only changes with an `id` less than this: the cursor for walking BACK through history, which is what a newest-first reader needs. Pass the smallest `id` on your last page.
- `changeKind` (`string`, optional): Filter to these kinds. Repeat the parameter to pass several (`?changeKind=amended&changeKind=removed`). Omit for all three.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `limit` (`integer`, optional): Max changes to return on this page. Default: `50`.
- `order` (`string`, optional): `desc` (default) is newest first, the natural reading order for a history. Use `asc` to replay a section's life forward, or when catching up from a cursor. One of: `asc`, `desc`. Default: `desc`.
- `sinceId` (`string`, optional): Return only changes with an `id` greater than this, to poll forward. Implies `order=asc`. Ids only grow, so this is exact; carry the response `cursor` forward.

Example input: `{"act_id":"USC_T42_C21_S1983"}`

### `vaquillmcp_get_section_cited_by`

Sections Citing This One · Read-only

The USC and CFR sections whose text cross-references a given section: the inverse of the crossReferences already returned on a section lookup. Use to find where a definition or requirement is actually invoked, or to gauge how load-bearing a provision is across the code. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `act_id` (`string`, required): Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `limit` (`integer`, optional): Page size: maximum citing sections to return. Default: `25`.
- `offset` (`integer`, optional): Rows to skip. Resume with the previous response's `nextOffset`. A page past the end is empty and not charged. Default: `0`.

Example input: `{"act_id":"USC_T42_C21_S1983"}`

### `vaquillmcp_get_section_cross_state`

Same Rule in Other States · Read-only

Provisions in OTHER states that address the same subject as a given state statute section, ranked by similarity. State statutes only. Use for fifty-state surveys, multi-jurisdiction compliance, or to check whether a client's home-state rule is typical or an outlier. Cost: 6 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `act_id` (`string`, required): Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `limit` (`integer`, optional): Maximum states to return, one provision each. Default: `5`.

Example input: `{"act_id":"USC_T42_C21_S1983"}`

### `vaquillmcp_get_section_definitions`

Defined Terms in Section · Read-only

The term definitions that govern a section, parsed from its chapter's definitions section. Use whenever a provision turns on a term of art ('covered entity', 'security', 'employer') and you need the statute's own definition rather than the ordinary meaning. Cost: 4 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `act_id` (`string`, required): Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.

Example input: `{"act_id":"USC_T42_C21_S1983"}`

### `vaquillmcp_get_section_enactments`

Session Laws Affecting a Section · Read-only

The state session laws that a publisher's own 'sections affected' tables list against one code section: which act added, amended or repealed it, the act's effective dates, and a sessionLawId to read with get_session_law. Never a complete amendment history: only acts and sessions we hold. Only some states are supported; any other section answers supported: false and is not charged. Empty with supported: true means no held table lists it. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `act_id` (`string`, required): Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.

Example input: `{"act_id":"USC_T42_C21_S1983"}`

### `vaquillmcp_get_section_neighbors`

Adjacent Sections · Read-only

The sections immediately before and after a given section within its own chapter or code, in statutory order. Use to read a provision in context, to find a definitions or penalties sibling, or to check whether the operative language continues into the next section. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `act_id` (`string`, required): Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `limit` (`integer`, optional): How many sections to return on EACH side. Default: `3`.

Example input: `{"act_id":"USC_T42_C21_S1983"}`

### `vaquillmcp_get_section_rulemaking`

Federal Register Documents for a CFR Section · Read-only

The Federal Register documents behind one CFR section, from the section's printed source note and from eCFR amendment dates. `matchBasis` says which signal matched and `quality` is `verified` only when both agree; a `candidate` is a lead, not a finding. `noteIsStale` means eCFR records an amendment newer than the note prints. Read `coverage` before treating a missing document as absent. A document with one valid RIN carries `rulemakingUrl`, a pointer to get_rulemaking_rin. CFR sections only. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `act_id` (`string`, required): Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.

Example input: `{"act_id":"USC_T42_C21_S1983"}`

### `vaquillmcp_get_sections_batch`

Statute Sections (Batch) · Read-only

Metadata for up to 50 sections in one call, by a list of act_ids. Same fields as get_us_statute_section. Use instead of looping that tool when you already hold several act_ids, for example every result of one search. Sections that are not found are skipped and not charged. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `actIds` (`array`, required): Section identifiers from a prior search, up to 50 per call. Duplicates are collapsed and order is preserved. DO NOT BUILD THESE FROM A CITATION: the chapter/article segments exist only in the data, so assembled ids miss. To start from a citation, use resolve_statute_citation.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `includeBody` (`boolean`, optional): Adds the ordinary body price for each row that returns text. Unresolved text returns `body: null` with no body charge. Use `creditsConsumed` for the total rather than calculating from the number of IDs. Default: `false`.

Example input: `{"actIds":[]}`

### `vaquillmcp_get_session_law`

State Session Law Record · Read-only

One US state session law's record: citation, session, approval and effective dates, code sections it affects, official sources and textStatus. v1 covers state acts; federal session laws are on the statute tools. Accepts a sessionLawId or a citation (adds the resolve price, kept even if it does not resolve). A withheld law is still returned, textStatus withheld with withheldReason: we hold its text but a measured defect keeps it from being served. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `session_law_id` (`string`, required): A state session law id from list_session_laws, e.g. `SSL_MN_2025R_G_Y2025_C1`, or a citation such as `S.F.No. 1552` (resolved, at the extra resolve price). A citation naming several laws is a 404 listing candidates in `didYouMean`. Federal `SAL_` ids 404.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `jurisdiction` (`string`, optional): Optional two-letter state code, `dc` or `pr`, used only when a citation is sent in place of the id: it supplies a state the citation omits and rejects one that conflicts (a 404, resolve fee kept). Ignored for an id. `federal` or an unknown code is a 422, never charged.

Example input: `{"session_law_id":"SSL_MN_2025R_G_Y2025_C1"}`

### `vaquillmcp_get_session_law_body`

State Session Law Text · Read-only

The text of one US state session law exactly as printed, about 30,000 characters per page; follow nextCursor while hasMore is true, each page charged. Check amendatoryMarkup: if lost, struck language may read as law. A withheld or not-held law answers available: false with a reason and is not charged: withheld means we hold the text but a measured defect keeps it back, so read the source instead. Cost: 6 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `session_law_id` (`string`, required): A state session law id, e.g. `SSL_MN_2025R_G_Y2025_C1`, from list_session_laws or get_session_law. Pass the id, not a citation: resolve a citation with get_session_law first. Federal `SAL_` ids 404.
- `cursor` (`string`, optional): The previous page's nextCursor, unchanged; omit for the first page. Tied to the exact text: an unknown or expired cursor is a 422, one from before the text was re-collected is a 409 (start again). Never charged. Send cursor or startChar, not both.
- `expectTextSha256` (`string`, optional): The textSha256 you read under, lowercase hex, 16 to 64 characters. If the text has since been re-collected the answer is a 409 and nothing is charged. Use with startChar, which has no version binding of its own.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `includeUnverified` (`boolean`, optional): Opt in to the text of a law we hold but do not serve (`textStatus: withheld`). Default `false`: it answers `available: false`. With `true` the text is returned when the reason is one we can label, and every page carries `textReliability`, `reasonCode` and a `notice` to show beside it: the text MAY show deleted or vetoed law as enacted. A law whose licence bars use, or whose text failed validation, is never served. Default: `false`.
- `startChar` (`string`, optional): Start the page at this 0-based character offset (the scale of pageStart and totalChars) to jump to a known place without paging. Same page size and price as any page. Send startChar or cursor, not both. At or past the end of the text is a 422, refunded.
- `version` (`string`, optional): Read this version of the text instead of the current one: a `version` from get_session_law_versions. Omit for the current version. A cursor belongs to its version (a 409 on another), an unlisted number is a refunded 404 and a value below 1 is a 422. A withheld law's older version needs `includeUnverified=true`, as its current text does.

Example input: `{"session_law_id":"SSL_MN_2025R_G_Y2025_C1"}`

### `vaquillmcp_get_session_law_changes`

Session Law Change Feed · Read-only

A sync feed of the US state session-law registry: every law that began to be served, gained text, was corrected, unserved, withdrawn or merged, oldest first. Start with sinceId=0, then pass the returned cursor while hasMore is true. detectedAt is when we recorded the change, never an effective date. State laws only. An empty page is still charged. Read a law from the feed with get_session_law or get_session_laws_batch. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `jurisdiction` (`string`, optional): Limit the feed to one two-letter state code, `dc` or `pr`; omit for all. `federal` or an unknown code is a 422, never charged. The cursor is a position in the whole feed, so a filtered page can skip ids.
- `limit` (`integer`, optional): Most entries on this page: 1 to 200, default 50. The price is per page, however many entries it holds, so a larger page is cheaper per entry. Out of range is a 422 and is never charged. Default: `50`.
- `sinceId` (`integer`, optional): Return entries with an id greater than this. Send 0 (the default) to start, then the cursor of your last page; exact and immune to clock skew. A value past the newest id returns an empty page, which is charged. Default: `0`.

Example input: `{}`

### `vaquillmcp_get_session_law_versions`

State Session Law Versions · Read-only

Every version of one STATE session law that we served or adopted, newest first, and which is current. A law's text can be corrected after it is first served, so the version read yesterday may not be the one a plain body call returns today. Lists when each was recorded, its length, hash and how the text was taken; carries no text. Read one version with get_session_law_body and its `version`. Takes an id, not a citation. Charged once per call; a law with a single version still answers. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `session_law_id` (`string`, required): A state session law id, e.g. `SSL_MN_2025S1_G_Y2025_C1`, from list_session_laws or get_session_law. Pass the id, not a citation: resolve a citation with get_session_law first. Federal `SAL_` ids 404.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.

Example input: `{"session_law_id":"SSL_MN_2025S1_G_Y2025_C1"}`

### `vaquillmcp_get_session_laws_batch`

State Session Laws (Batch) · Read-only

Read up to 50 US state session laws in one call, by sessionLawId or citation: the record get_session_law returns, for each. Every entry is answered: served laws in `laws`, each carrying the `input` it answers, and the rest in `notFound` with a status. Duplicates collapse first. includeBody adds the first page of each law's text at the body price. To identify citations use resolve_statute_citations_batch; use this to read the records. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ids` (`array`, required): Session law ids or citations (`Minn. Laws 2025, ch. 1`, `S.F.No. 1552`), at most 50 distinct entries after duplicates collapse (200 raw, 300 characters each). A citation also pays the resolve price. Federal `SAL_` ids are misses and are never charged.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `includeBody` (`boolean`, optional): true adds the first page (about 30,000 characters) of each served law's text as `body`, at the body price per law served. A withheld or not-held law gets body: null and is not charged for it. Continue a long act with get_session_law_body from bodyNextCursor. Default: `false`.
- `jurisdiction` (`string`, optional): Optional two-letter state code, `dc` or `pr`, applied to every citation in ids: it supplies a state a citation omits and rejects one that conflicts. Ignored for ids. `federal` or an unknown code is a 422, nothing charged.

Example input: `{"ids":[]}`

### `vaquillmcp_get_us_statute_section`

Statute Section Metadata · Read-only

Metadata for one US statute, regulation or rule section by act_id: citation, title hierarchy, breadcrumb, amendment history, and links to HTML, PDF and XML. Does NOT include the section text -- use get_us_statute_section_text for that. Good for confirming you have the right section before paying for its full body. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `act_id` (`string`, required): Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.
- `full` (`boolean`, optional): Return every list entry and the whole `history` credit line. By default lists are capped at 50 items and `history` at 4,000 characters, and `responseBounds` reports each cut with its total. No extra charge. Default: `false`.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.

Example input: `{"act_id":"USC_T42_C21_S1983"}`

### `vaquillmcp_get_us_statute_section_text`

Statute Section Text · Read-only

The full text of a US statute, regulation or rule section by act_id. Returns styled HTML (with cross-references and paragraph numbering as officially published) and plain text. Use when you need the actual statutory language to quote, draft against, or analyze rather than just cite. A section the publisher prints as images answers `bodyUnavailable: true` with `image_only_source` and no text, and is not charged. Cost: 6 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `act_id` (`string`, required): Section identifier, e.g. `USC_T42_C21_S1983` (Title 42, Chapter 21, Section 1983, written 42 U.S.C. 1983). Take it from a search result rather than assembling it: the title and section are derivable from a citation but the CHAPTER is not, so hand-built ids usually 404.
- `asOf` (`string`, optional): Text as it stood on this date (`YYYY-MM-DD`), same cost. Read `asOf.engine` first. `observed_change` is a RECONSTRUCTION from observed changes, not an archive: `asOf.isBounded` true means no change affecting the date was observed, limited by when capture began, not by the law. `stored_edition` (U.S. Code, CFR_ANNUAL, Copyright Compendium, OFAC FAQs) is a held published edition, and there `isBounded` true means the date is inside one; the U.S. Code holds two dates, so most are out of coverage. A section we cannot rebuild, or a date no held edition governs, returns `source: "unavailable"` with no text and is refunded.
- `format` (`string`, optional): Which representations to return. `both` (default) is `html` + `plain`, the same text twice, so `plain` or `html` alone roughly halves the payload at the same price. `all` adds `markdown` (a third full copy, opt-in). `markdown` returns only `markdown`, falling back to `plain` with a `note` when the section has no structured rendering. `content` and `operative` return only the split text, about 1 KB instead of 30 KB on a long section, but ONLY United States Code sections can be split: elsewhere they return `plain` with a `note`, and `content` is null, so read `note` instead of assuming it is empty. One of: `all`, `both`, `html`, `markdown`, `plain`, `content`, `operative`. Default: `both`.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `pinpoint` (`string`, optional): Return one subsection in `pinpoint` beside the whole body. Parenthesised labels, outermost first, without the section number: `(c)`, `(c)(1)`, `(d-1)`. Same cost. Malformed, or sent with `asOf`, is an uncharged 422. Read `pinpoint.matched`: a missing subsection is `matched: false`, never the whole section.
- `structured` (`boolean`, optional): When true, also returns a `subsections` tree for pincite addressing and `markdown` as that tree in nested lists, at the same cost. It overrides the table-preserving markdown that `format=all` or `markdown` would otherwise give, so leave it off when you need the tables. Default: `false`.

Example input: `{"act_id":"USC_T42_C21_S1983"}`

### `vaquillmcp_list_docket_documents`

Documents in a Docket · Read-only

The documents of one Regulations.gov docket, oldest first: the proposal, notices, final rule and supporting material, with comment periods and Federal Register document numbers. Metadata only, no document text and no comments. Filter by documentType, openForComment and a postedFrom/postedTo window. Charged per page; an unknown docket is a 404 and is refunded. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `docket_id` (`string`, required): Regulations.gov docket id, for example `EPA-HQ-OAR-2021-0208`. Case is kept as printed.
- `cursor` (`string`, optional): `nextCursor` of the previous page; same filters.
- `documentType` (`string`, optional): Only documents of this Regulations.gov document type. Case is ignored.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `limit` (`integer`, optional): Page size, 1 to 100. Default: `50`.
- `openForComment` (`string`, optional): `true` keeps only documents whose comment period is open.
- `postedFrom` (`string`, optional): Only documents posted at or after this ISO-8601 instant.
- `postedTo` (`string`, optional): Only documents posted before this ISO-8601 instant (exclusive). The window is half-open, `postedFrom` <= posted < `postedTo`, so equal bounds select nothing and are refused with a 422: `postedTo` must be after `postedFrom`.

Example input: `{"docket_id":"<docket_id>"}`

### `vaquillmcp_list_rin_agenda`

Unified Agenda History of a RIN · Read-only

The Unified Agenda history of one RIN: one entry per edition that carried it (Fall 1995 onward), newest first, each with the stage, priority and timetable the agency printed in that edition. Narrow with from and to (edition ids YYYYMM, such as 202510). Charged per page; a RIN no edition carries is a 404 and is refunded. Use get_rulemaking_rin for the linked dockets and Federal Register documents. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `rin` (`string`, required): Regulation Identifier Number `NNNN-XXNN`; lower case is accepted.
- `cursor` (`string`, optional): `nextCursor` of the previous page; same filters.
- `from` (`string`, optional): Oldest Unified Agenda edition to include, as an edition id `YYYYMM`, for example `202010`. Must not be later than `to`.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `limit` (`integer`, optional): Editions per page, 1 to 100. Default 25. Default: `25`.
- `to` (`string`, optional): Newest Unified Agenda edition to include, as an edition id `YYYYMM`, for example `202510`. Must not be earlier than `from`.

Example input: `{"rin":"<rin>"}`

### `vaquillmcp_list_rulemaking_committee_records`

Rules Committee Records · Read-only

List Judicial Conference Rules Committee records (minutes, agenda books, reports, rules packages, comments), newest first. Filter by committee, docType, year, ruleSet, rule (needs ruleSet) and docketId. Drafting history, not law. Public comments and suggestions (textWithheld: true) withhold title, filename, sourceUrl, itemUrl and text: they name private people. Charged per page; an empty page is refunded. Read one with get_rulemaking_committee_record. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `committee` (`string`, optional): The Judicial Conference committee that produced the record: Standing, Appellate, Bankruptcy, Civil, Criminal, Evidence or General.
- `cursor` (`string`, optional): `nextCursor` of the previous page; same filters.
- `docketId` (`string`, optional): Only records linked to this rulemaking docket id, for example `USC-RULES-CV-2025-0004`.
- `docType` (`string`, optional): One of: meeting_minutes, agenda_books, committee_reports, rules_packages, preliminary_drafts, superseded_pamphlets, rules_comments, rules_suggestions, fjc_studies, past_members, special_projects, style_resources, transcripts_testimony, rules_comments_archive.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `limit` (`integer`, optional): Page size, 1 to 100. Default: `50`.
- `rule` (`string`, optional): Rule number, for example `26`; needs `ruleSet`.
- `ruleSet` (`string`, optional): FRCP, FRAP, FRBP, FRCRP or FRE: records that discuss a rule of this set.
- `year` (`string`, optional): Year of the record, for example `2024`.

Example input: `{}`

### `vaquillmcp_list_rulemaking_dockets`

Regulations.gov Dockets · Read-only

List and filter Regulations.gov dockets, most recently modified first, by agencyId, docketType (Rulemaking or Nonrulemaking), rin, hasRin and a modifiedSince/modifiedUntil window. Charged per page; an empty page is still charged. nextCursor is bound to the filters that produced it, so pass it back with the same filters. Read one with get_rulemaking_docket. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `agencyId` (`string`, optional): Only dockets of this agency, by Regulations.gov agency acronym. Case is ignored.
- `cursor` (`string`, optional): `nextCursor` of the previous page; same filters.
- `docketType` (`string`, optional): Only dockets of this type: `Rulemaking` or `Nonrulemaking`.
- `hasRin` (`string`, optional): `true` keeps only dockets that carry a RIN, `false` only those without one.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `limit` (`integer`, optional): Page size, 1 to 100. Default: `50`.
- `modifiedSince` (`string`, optional): Only dockets modified at or after this ISO-8601 instant.
- `modifiedUntil` (`string`, optional): Only dockets modified before this ISO-8601 instant (exclusive). The window is half-open, `modifiedSince` <= modified < `modifiedUntil`, so equal bounds select nothing and are refused with a 422: `modifiedUntil` must be after `modifiedSince`.
- `rin` (`string`, optional): Regulation Identifier Number `NNNN-XXNN`; lower case is accepted.

Example input: `{}`

### `vaquillmcp_list_session_laws`

State Session Laws · Read-only

List one US state's session laws (acts as enacted, v1 covers state acts only). jurisdiction is REQUIRED, a two-letter state code. Filter by session, approval date or effective date, for example everything taking effect on a date. Rows include laws whose text is not served (textStatus not_held or withheld); pass hasText=true for readable ones. Page with cursor = nextCursor. An empty page is still charged. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `jurisdiction` (`string`, required): REQUIRED. The two-letter code of the state to list, `dc` or `pr`, case-insensitive; one jurisdiction per call. `federal` or an unknown code is a 422. A state with no held session laws returns an empty page with a coverage note, not charged. One of: `al`, `ak`, `as`, `az`, `ar`, `ca`, `co`, `ct`, `de`, `dc`, `fl`, `ga`, `gu`, `hi`, `id`, `il`, `in`, `ia`, `ks`, `ky`, `la`, `me`, `md`, `ma`, `mi`, `mn`, `ms`, `mo`, `mt`, `ne`, `nv`, `nh`, `nj`, `nm`, `ny`, `nc`, `nd`, `mp`, `oh`, `ok`, `or`, `pa`, `pr`, `ri`, `sc`, `sd`, `tn`, `tx`, `ut`, `vt`, `vi`, `va`, `wa`, `wv`, `wi`, `wy`.
- `approvedFrom` (`string`, optional): Only laws approved (signed) on or after this date, `YYYY-MM-DD`, inclusive. A law with no printed approval date, or a derived one (approvedDateDerived: true), never matches. Pair with approvedTo; an end before the start is a 422.
- `approvedTo` (`string`, optional): Only laws approved (signed) on or before this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). Like `approvedFrom`, it matches a derived `approvedDate` too.
- `cursor` (`string`, optional): The previous page's nextCursor, unchanged, sent with the same filters (limit may change). A cursor we did not issue, an expired one or one sent with different filters is a 422; restart without it. Omit for the first page.
- `effectiveFrom` (`string`, optional): Only laws with an effective date on or after this date, `YYYY-MM-DD`, inclusive; a law matches when its effectiveFirst to effectiveLast span overlaps the window. A law with no held effective date never matches, though it may be in force. For one day, send it as both bounds.
- `effectiveTo` (`string`, optional): Only laws with an effective date on or before this date. Format `YYYY-MM-DD`, inclusive; it must be a real calendar date (`2025-02-30` is a 422). Overlap rule as for `effectiveFrom`. An end before `effectiveFrom` is a 422 (never charged).
- `enactmentOutcome` (`string`, optional): Only laws with one of these outcomes (OR), for example `vetoed` or `pocket_veto`, as enactmentOutcome reports it. An unknown value is a 422; a valid outcome that matches nothing is an empty, charged page.
- `hasText` (`string`, optional): true: only laws whose text is served (textStatus held), the ones get_session_law_body returns. false: only laws without served text. Omit for both. Combines with textStatus by AND.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `instrumentType` (`string`, optional): Only these kinds of measure (OR); `act` is an ordinary law. An unknown value is a 422; a valid kind that matches nothing is an empty, charged page.
- `isLaw` (`string`, optional): true: only measures that are law. false: only numbered measures that are not (a vetoed bill, a pocket veto). Omit for both. A measure whose outcome is unsettled matches neither; use enactmentOutcome for those.
- `limit` (`integer`, optional): Rows per page, 1 to 200; default 50. A page costs the same however many rows it holds, so a larger `limit` is cheaper per law. Outside the range is a 422. Default: `50`.
- `order` (`string`, optional): `asc` (default) sorts by session code, then law id; `desc` is the exact reverse (newest session first). Law ids sort as text. Keep the same `order` across pages: changing it with a cursor is a 422. One of: `asc`, `desc`. Default: `asc`.
- `q` (`string`, optional): Only laws whose title or printed bill number contains this text, case-insensitive. A plain substring, with no stemming or ranking (use search_session_laws for that). Bill numbers match as printed (`S.F.No. 1552`). 3 to 100 characters.
- `series` (`string`, optional): Only laws in these numbering series (OR), as a result's series reports it; `general` is most states' ordinary chapter sequence. Not every state uses every series. An unknown value is a 422; a valid one that matches nothing is an empty, charged page.
- `session` (`string`, optional): Only laws from this session, with the code exactly as session.code reports it (`2025R` regular, `2025S1` first special). Case-sensitive. A code that matches nothing returns an empty page, which is charged.
- `textStatus` (`string`, optional): Only laws with this text status: `held` (served), `withheld` (held but kept back for a measured defect), `not_held` (known, no text) or `pending` (collected, not yet verified). Omit for all.
- `updatedSince` (`string`, optional): Only laws whose record changed on or after this date (`YYYY-MM-DD`, midnight UTC, by updatedAt), for sync jobs. A day with no change returns an empty page, which is charged.

Example input: `{"jurisdiction":"al"}`

### `vaquillmcp_list_statute_divisions`

Browse Code Structure · Read-only

Walk the statutory hierarchy: list the level directly below what you pass, in statutory order. Which level that is depends on the code, so read `level` and each node's `kind` and pass its `identifier` back as the filter that kind names, until `isLeaf` is true and `actId` is set. One listing can mix kinds. `name` is null when the publisher prints no heading. A filter that does not fit the corpus is a 422 before any charge; an empty level is refunded; `nextCursor` means page on. Cost: 1 credit.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `corpusType` (`string`, required): Corpus to browse. Case-insensitive. The browsable subset of the `corpusType` tokens on `/us/statutes/coverage`. One of: `USC`, `CFR`, `STATE`, `REGULATION`, `STATE_RULES`, `CONSTITUTION`, `STATE_CONSTITUTION`, `FEDERAL_RULES`.
- `act` (`string`, optional): State codes and court rules only: the act to list, from a node with `kind: act` (an Illinois act inside an ILCS chapter, a Pennsylvania unconsolidated act). Needs `code`.
- `actStatus` (`string`, optional): List only sections carrying this status, e.g. `repealed`. The inverse of `excludeRepealed`, and useful for auditing what a container holds that is no longer operative.
- `agency` (`string`, optional): State regulations only: the agency to list (`kind: agency`), as a listing returned it, e.g. Maine `144`. A chapter number repeats under different agencies, so name the agency to open the right chapter. Needs `code`.
- `article` (`string`, optional): Article to drill into: a constitution's article or amendment (`Article III`, `Amendment XIV`), or any state-code node with `kind: article` (New York's codes, Delaware's UCC articles outside a chapter). Can be combined with `chapter`. Pass the `identifier` exactly as the listing returned it.
- `chapter` (`string`, optional): Chapter to drill into (USC, CFR and state codes), or the first level inside a court rule set (`kind: chapter`; needs `code`). On CFR it lists the chapter's parts and needs `titleNumber`; with `part` it is not needed.
- `code` (`string`, optional): Code to drill into, from a node with `kind: code`: a state code (`tx_pe`), a federal rule set (`frcp`), or a state court rule set (`SCR61`, with `corpusType=STATE_RULES` and `state`).
- `cursor` (`string`, optional): Resume token from a previous response's `nextCursor`, passed back with the same filters. Omit it to start at the beginning of the listing.
- `division` (`string`, optional): Division to list, from a node with `kind: division`: a U.S. Code division (Title 54, 42 U.S.C. ch. 157; needs `titleNumber`) or a state or regulation code division (California; needs `code` and the levels above it).
- `excludeRepealed` (`boolean`, optional): Only sections with an affirmatively dead status, including repealed, superseded or renumbered, are excluded. Sections with no recorded status are kept, not treated as repealed. Default: `false`.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `part` (`string`, optional): Part to drill into, from a node with `kind: part`: a CFR part, a U.S. Code part (needs `titleNumber`), or a part of a state code or court rule set (needs `code`). Pass the `identifier` exactly as the listing returned it.
- `program` (`string`, optional): State regulations only: the program to list (`kind: program`), as a listing returned it. Wyoming prints a program between an agency and its chapters, and chapter `1` repeats under every program. Needs `code`.
- `state` (`string`, optional): 2-letter jurisdiction code, required for the state-scoped corpora (STATE, REGULATION, STATE_RULES, STATE_CONSTITUTION). Case-insensitive.
- `subchapter` (`string`, optional): Subchapter to list, from a node with `kind: subchapter`: a U.S. Code subchapter (with `titleNumber` and `chapter`) or a state or court-rule subchapter (with `code`). Case-insensitive.
- `subdivision` (`string`, optional): U.S. Code only: the subdivision to list (`kind: subdivision`, Title 54). Needs the `division` it belongs to.
- `subjectGroup` (`string`, optional): CFR only: the subject group to list (`kind: subjectGroup`), as the heading the listing returned or its eCFR id (`ECFR` and 15 hex digits), which needs no `subpart`. Needs `titleNumber` and `part`. Case-insensitive.
- `subpart` (`string`, optional): Subpart to list (`kind: subpart`): a U.S. Code or CFR subpart (needs `part` and `titleNumber`), or a state regulation subpart such as Louisiana's or Mississippi's (needs `code` and the `part`). Case-insensitive.
- `subtitle` (`string`, optional): Subtitle to list, from a node with `kind: subtitle`: a U.S. Code subtitle (needs `titleNumber`) or a state code subtitle (needs `code` and the `title` it sits in).
- `title` (`string`, optional): State codes and regulations only: the title inside a code to list, as a listing returned it (`kind: title`), such as Title 5 of the Texas Penal Code. Needs `code`. A U.S. Code or CFR title is `titleNumber`.
- `titleNumber` (`string`, optional): USC/CFR title number to drill into. On the U.S. Code, `5a` and `18a` name the Appendix to Title 5 and Title 18 (a title list returns them as their own rows).
- `umbrella` (`string`, optional): State regulations only: the umbrella to list (`kind: umbrella`), as a listing returned it. Maine groups its agencies under a department umbrella (`10` is the Department of Health and Human Services). Needs `code`.

Example input: `{"corpusType":"USC"}`

### `vaquillmcp_list_statutes_coverage`

Corpus Coverage · Read-only

Coverage matrix: every corpusType we hold and its per-jurisdiction section counts, split by recorded status in `statusBreakdown`. Use before answering a jurisdiction question. A corpusType missing from `corpora` means no documents of that type are held for it yet; counts show what is held, not completeness. Pass state (a two-letter code, or federal) to read one jurisdiction; the full matrix is about a megabyte. Free.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `state` (`string`, optional): One jurisdiction: a two-letter state code or `federal`. Omit for every jurisdiction (about a megabyte).

Example input: `{}`

### `vaquillmcp_resolve_statute_citation`

Resolve Citation · Read-only

Resolve a Bluebook citation string ('42 U.S.C. 1983', '16 C.F.R. 444.1', 'Cal. Code Regs. tit. 22, 76227') to the exact section, confirmed, with an official source link and the act_id. Use this whenever the user gives you a citation rather than a question -- it is far more reliable than searching for the citation text. `matchLevel` means `section` is NOT the exact unit cited. A shared acronym (`G.S. 52-577`) is resolved: false until you pass `state`. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cite` (`string`, required): A Bluebook citation string, e.g. '42 U.S.C. 1983' or '16 C.F.R. 444.1'.
- `corpusType` (`string`, optional): Optional corpus to resolve WITHIN: `STATE`, `REGULATION`, `STATE_RULES`, `CONSTITUTION`, `STATE_CONSTITUTION`. Narrows a citation whose form several corpora share; like `state`, a citation belonging to another corpus resolves to nothing instead.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `state` (`string`, optional): Optional jurisdiction to resolve WITHIN: a 2-letter state code, e.g. `tx`, or `federal` for USC, CFR, federal rules and the U.S. Constitution. Some citation forms are shared: `8 CCR 1206-2` is Colorado and `22 CCR 76227` is California. A constraint, not a hint: a citation naming a different jurisdiction returns `resolved: false` rather than being forced into this one, so a federal citation (`42 U.S.C.`, `C.F.R.`, `Fed. R. Civ. P.`, `U.S. Const.`) under a state returns `resolved: false`. Leave it unset when the citation already names its jurisdiction, and never carry a state over from an earlier question. When the scope is why it missed, `citationOutsideFilters` names the section and the scope that excluded it.

Example input: `{"cite":"42 U.S.C. 1983"}`

### `vaquillmcp_resolve_statute_citations_batch`

Resolve Citations (Batch) · Read-only

Resolve up to 50 Bluebook citations in one call, returning the same confirmed section, official source link and act_id as the single-citation tool. Use when a document or answer cites several provisions: one call instead of a loop. Priced per citation, the same as one at a time, so it buys latency, not a discount. Cost: 2 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `citations` (`array`, required): Bluebook citation strings, up to 50 per call. Duplicates are collapsed and order preserved, so `results` lines up with the de-duplicated input. Priced PER CITATION at the single-resolve rate: batching is a round-trip and latency win, not a discount.
- `corpusType` (`string`, optional): Restricts every citation to one corpus: `STATE`, `REGULATION`, `STATE_RULES`, `CONSTITUTION`, `STATE_CONSTITUTION`. `STATE` covers federal and state statutes, and the two constitution values are synonyms here, with `state` distinguishing the jurisdiction.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `state` (`string`, optional): Optional jurisdiction to resolve every citation WITHIN: a 2-letter state code, or `federal` for USC, CFR, federal rules and the U.S. Constitution. A constraint, not a hint. Omit it for a batch that spans jurisdictions.

Example input: `{"citations":[]}`

### `vaquillmcp_search`

Search US Law · Read-only

Generic corpus search over US primary law, returning `{id, title, url}` records for citation. Present so this server works in clients that require the standard search/fetch pair. If you can call `search_us_statutes`, prefer it: it filters by jurisdiction, corpus, date and status, which this cannot. Pair with `fetch` to read a result.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): No description.

Example input: `{"query":"<query>"}`

### `vaquillmcp_search_session_laws`

Search State Session Laws · Read-only

Keyword search (BM25, not semantic) over the ENACTED text of US state session laws, best first, each with the passage that matched and a snippet. Send plain words, a quoted phrase (verbatim), a citation, a code section or a bill number. Words must match the act's own vocabulary: `teeth cleaning` will not find `dental hygienist`. Struck language is never searched. There is no 'no good match' flag, so read the snippet. An empty result is still charged. Cost: 4 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): Plain words, a quoted phrase (matched verbatim), a citation (`63-3004`), a code section or a bill number (`S.F.No. 1552`). Unquoted words are stemmed and matched as the legislature wrote them, so use the act's vocabulary. 2 to 300 characters.
- `approvedFrom` (`string`, optional): Only laws approved on or after this date, `YYYY-MM-DD`, inclusive; a real calendar date (`2025-02-30` is a 422). A law with no printed approval date never matches.
- `approvedTo` (`string`, optional): Only laws approved on or before this date, `YYYY-MM-DD`, inclusive. An end before `approvedFrom` is a 422, never charged.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `includeUnverified` (`boolean`, optional): Opt in to results for laws we hold but do not serve for their text (`textStatus: withheld`). Default `false` leaves them out. With `true` they are returned and each carries `textReliability`, `reasonCode` and a `notice`; the text MAY show deleted or vetoed law as enacted. A law whose licence bars use is never returned. Default: `false`.
- `instrumentType` (`string`, optional): Limit to these kinds of measure, one or more (OR). One of `act`, `joint_resolution`, `concurrent_resolution`, `resolution`, `resolve`, `memorial`, `other`. Any other value is a 422, never charged.
- `jurisdiction` (`string`, optional): Limit to one jurisdiction: the 56 jurisdictions (the 50 states, `dc` and the territories `pr`, `gu`, `vi`, `as`, `mp`). Two-letter code, case-insensitive. Omit to search every jurisdiction we hold. `federal` and an unknown code are a 422, never charged.
- `limit` (`integer`, optional): Laws per page, 1 to 25. A page costs the same however many laws it holds, so a larger `limit` is cheaper per law. Default: `10`.
- `offset` (`integer`, optional): Laws to skip, for the next page: `offset` plus `limit` can reach at most the 60 best matches. Each page is a new search and is charged. Deeper than 60 is a 422, never charged: narrow the search with a filter instead. Default: `0`.
- `series` (`string`, optional): Limit to these numbering series (OR), as a result's series reports it; `general` is most states' ordinary chapter sequence. An unknown value is a 422, never charged.
- `session` (`string`, optional): One session, by the code `session.code` reports (`2025R`, `2025S1`). Case-sensitive. Applies to every kind of match, so a narrow session can leave fewer than `limit` laws on a page.

Example input: `{"query":"<query>"}`

### `vaquillmcp_search_us_statutes`

Search US Statutes · Read-only

Search US federal and state statutes, regulations, constitutions and court rules. Default ranks by meaning; matchType `boolean` returns only sections satisfying a terms-and-connectors expression, pageable to the end. A result's act_id feeds the other statute tools; never hand-build one. For a citation, use resolve_statute_citation. `citationOutsideFilters`: the cited section exists outside your filters. 422: change the request, never resend it unchanged. 503: retry with backoff. Cost: 4 credits.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, required): A natural-language question or a citation; with matchType `boolean`, an expression such as `"security deposit" /s (return OR refund) NOT commercial`. 2 to 500 characters.
- `actStatus` (`string`, optional): Positively scope to raw publisher statuses: `repealed` for dead law only, `in_force` for sections affirmatively marked current. The inverse of `excludeRepealed`, and what a compliance diff asking what was LOST needs. Combining a dead status with `excludeRepealed: true` is rejected 422.
- `agency` (`string`, optional): Federal Register agency: slug (`environmental-protection-agency`), full name or acronym (`EPA`); a list matches any. An ambiguous acronym (`FS`) or an unknown agency is a 422, never a charge. Only `FEDERAL_REGISTER` and `EXECUTIVE_ACTION` carry an agency.
- `article` (`string`, optional): Article label(s) to scope to, exactly as `list_statute_divisions` returns them (`Amendment XIV`, `Article IV`, New York's `2-A`). Needs `corpusType` `CONSTITUTION`, `STATE_CONSTITUTION` (plus `state`), or `STATE` / `REGULATION` (plus `code`); otherwise 422 before any charge.
- `changedSince` (`string`, optional): Only sections we OBSERVED changing on or after this date (`YYYY-MM-DD`). Observed, not effective: the date we saw it, an upper bound on when it took effect. Capture began long after the corpus did and events sweep at 24 months, so empty means no captured change, never that nothing was amended.
- `chapter` (`string`, optional): One or more chapters within a title or code, e.g. `21` for USC Title 42 Chapter 21. Pass a hit's `parent.chapter` back to search its neighbors. Chapter numbers repeat across titles, so pair with `titleNumber` (USC) or `code` (state); an unpaired chapter is rejected.
- `code` (`string`, optional): Restrict to specific state statutory codes, e.g. `tx_pe` for the Texas Penal Code. Values are the `actId`s from list_statute_divisions. List allowed, across states. The only way to scope below a whole jurisdiction: `state=tx` alone searches all ~15 Texas codes.
- `corpusType` (`string`, optional): Restrict to one corpus, or several as a list. Federal: `USC`, `USC_ANNUAL` (published past editions), `CFR`, `CFR_ANNUAL` (same, superseded by construction), `CONSTITUTION`, `FEDERAL_RULES`, `FEDERAL_REGISTER`, `FEDERAL_REGISTER_NOTICE` (a curated slice, not the whole series), `EXECUTIVE_ACTION`, `AGENCY_GUIDANCE`, `SENTENCING_GUIDELINES`, `US_TAX_TREATY` (IRS income tax treaties and technical explanations), `US_TREATY` (the Senate treaty record: treaties, resolutions of advice and consent, Treaty Documents), `SESSION_LAW` (Statutes at Large, as enacted), `STATUTE_COMPILATION` (an act as amended through a stated later law), `AGENCY_ADJUDICATION` (DOJ Office of Legal Counsel opinions and MSPB decisions), `FEDERAL_LOCAL_RULES` (courts of appeals' circuit rules). Pair with `state`: `STATE`, `REGULATION`, `STATE_RULES`, `STATE_CONSTITUTION`, `STATE_AGENCY_GUIDANCE`, `STATE_AG_OPINION`, `STATE_REGISTER` (register notices as printed, not codified law). Omit for all. Currency: attorney general opinions (`STATE_AG_OPINION`), register notices (`STATE_REGISTER`) and statute compilations (`STATUTE_COMPILATION`) return `goodLawStatus` `unknown` by design. Annual editions (`CFR_ANNUAL`, `USC_ANNUAL`) return `not_good_law` because a later edition supersedes them.
- `documentType` (`string`, optional): Federal Register document stage: `final` (a rule in force), `proposed` (an NPRM), or `presidential` (a Presidential Document, the `EXECUTIVE_ACTION` corpus). The same distinction appears in each row's `actId` prefix (`FR_RULE_` vs `FR_PRORULE_`).
- `excerptChars` (`integer`, optional): Characters of matching text in each `excerpt`, 100 to 600 (default 500). A ranking preview, not the section: use `includeBody` or `get_us_statute_section_text` for the full text. Default: `500`.
- `excludeRepealed` (`boolean`, optional): Drop sections whose own status says they are not operative (repealed, renumbered, transferred, expired, superseded, omitted, and the rest). Removes what we KNOW is dead; it does not promise the remainder is good law. Read `goodLawStatus` per result to tell them apart: `good_law` is checked, `unknown` means no currency verdict is asserted. Default: `false`.
- `fields` (`string`, optional): Return only these result fields, e.g. `["title", "excerpt"]`. A result carries 40+ fields, most null on any given row. `actId` and `citation` are always included. Unknown names are rejected 422. Omit for the full object.
- `Idempotency-Key` (`string`, optional): Optional, 16 to 255 visible ASCII characters (a UUIDv4 is ideal). A retry with the same key and request replays the original 2xx for 24 hours without charging again; the same key with a different request is rejected.
- `includeBody` (`boolean`, optional): Return each hit's full text inline on `body`, instead of one `/section/{actId}/body` call per hit. Buys latency, not a discount: the 4-credit search PLUS 6 credits for every row that returns text, so ten rows is 64. ⚠️ It multiplies with `limit`; 50 rows is 304 credits in one call. Rows with no text are not charged, so read `creditsConsumed`. Prefer this over a bigger `excerptChars`: an excerpt is windowed around the match and can start mid-section, so it is not safe to quote. Default: `false`.
- `includePinpoint` (`boolean`, optional): Name the subsection each hit matched, in `pinpoints` keyed by `actId` (e.g. `625 ILCS 5/11-601(c)(1)`, with its text and offsets). Free: the price and the results do not change, and it never fails the search. A hit it cannot name says why in `reason`; `located: false` means your words did not point at a subsection. Adds a few hundred ms per page. Default: `false`.
- `limit` (`integer`, optional): Number of results to return per page. Default: `10`.
- `matchType` (`string`, optional): `any` (default) ranks by meaning, for a question. `all`: every word; `phrase`: the words in order. `boolean`: `query` is a terms-and-connectors expression and ONLY sections satisfying it return, ranked; use it for exact logic (alternatives, exclusions, proximity, word forms), not for a question or a citation. Operators are UPPERCASE: `AND` `OR` `NOT`, `/s` same sentence, `/p` same paragraph, `/5` within 5 words (`+s` `+p` `+5`: left term first), `"exact phrase"`, `retaliat*` (3+ characters first, at most 20), `wom?n`, `atleast3(term)`, `( )`. Adjacent bare words are a PHRASE, so write `AND`; lowercase and/or/not are words; no stemming. OR binds tightest, then /N, /s, /p, AND, NOT: parenthesize. Check `parsedQuery`, and fix what `queryWarnings` names. A 422 is free and names the error and position, or says the expression is too heavy to verify: narrow `state`/`corpusType` or use fewer /s /p. Empty means no match in scope; loosen before calling it absent. One of: `any`, `all`, `phrase`, `boolean`. Default: `any`.
- `offset` (`integer`, optional): Results to skip. Pages never repeat or drop a result. Ranked modes stop at 70. `boolean` pages to the end (up to 10,000): send the response's `nextOffset` until it is absent and `hasMore` is false; never compute it, as a page can hold fewer rows than `limit`. `totalMatches` counts every match across pages: exact when `totalMatchesExact` is true, an upper bound when false. Default: `0`.
- `part` (`string`, optional): One or more parts within a title, e.g. `240` for 17 C.F.R. Part 240. The CFR counterpart to `chapter`: pass a hit's `parent.part` back. Pair with `titleNumber`; an unpaired part is rejected.
- `publishedFrom` (`string`, optional): Only return Federal Register documents published on or after this date (`YYYY-MM-DD`). This is the PUBLICATION date, which is not the same as `yearFrom`: that filters the version year of a section.
- `publishedTo` (`string`, optional): Only return Federal Register documents published on or before this date.
- `source` (`string`, optional): The named body of law within a `corpusType` that folds several together: `FEDERAL_RULES` into `frcp`/`fre`/`sct`, `CFR` into `far`/`dfars`, `AGENCY_GUIDANCE` into ~34 agency sources, `AGENCY_ADJUDICATION` into `olc_opinion`/`mspb_precedential`/`mspb_nonprecedential`. Every result carries its own `source`, so a hit's value can be passed straight back.
- `state` (`string`, optional): Jurisdiction. A 2-letter code for one of the 52 supported US jurisdictions (50 states + DC + PR), or `federal` for USC / CFR / Constitution / federal rules. Pass a list to search several at once. Case-insensitive. Omit to search every jurisdiction. Leave it unset when the query is a citation that already names its jurisdiction (`42 U.S.C.`, `C.F.R.`, `Fed. R. Civ. P.`, `U.S. Const.`): a state filter excludes federal law. Never carry a state over from an earlier question.
- `titleNumber` (`string`, optional): Filter by USC/CFR title number (e.g., 17 for SEC, 42 for civil rights). Only meaningful for `USC`/`CFR`; ignored for state corpora whose titles are alphabetic (e.g. Texas `pe` = Penal Code).
- `yearFrom` (`string`, optional): Only sections last amended in or after this year; pair with `yearTo` for a window. Tracks the publisher's own amendment credit, not when we rebuilt the corpus. About a fifth of sections carry no credit and are excluded once either bound is set.
- `yearTo` (`string`, optional): Only sections last amended in or before this year. This filters the LAST amendment, so a section amended in 2025 is excluded by `yearTo=2024` even though it existed in 2024. A currency filter, not point-in-time retrieval.

Example input: `{"query":"<query>"}`

## Related

Other Search connectors ([all 89](/agentkit/connectors/?category=search)):

- [Supadata](/agentkit/connectors/supadata/): Scalekit connector, API key, 21 tools
- [Exa](/agentkit/connectors/exa/): Scalekit connector, API key, 21 tools
- [Brave Search](/agentkit/connectors/brave/): Scalekit connector, API key, 18 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
