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.
- Tools
- 37
- What they doRead · write · destructive
- 37 · 0 · 037 read0 write0 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Vaquill MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>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_nameyour code passes. See Configure connections.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.
Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'vaquillmcp'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'vaquillmcp_count_statute_sections',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "vaquillmcp"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="vaquillmcp_count_statute_sections",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolvaquillmcp_count_statute_sectionsExact 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).Read-onlyCount Sections in a Scope
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.
Inputs
actStatusstring- Count only sections carrying this status.
articlestring- 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`.
chapterstring- Chapter identifier. Pair with `titleNumber` or `code`.
codestring- 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`.
corpusTypestring- Corpus to count, single or list. Omit to count every corpus.
excludeRepealedboolean- 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-Keystring- 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.
matchTypestring- `"boolean"` to count the sections satisfying `query`. Required with `query`.
partstring- CFR part identifier. Pair with `titleNumber`.
querystring- 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.
statestring- Two-letter jurisdiction code or `federal`, single or list.
titleNumberstring- USC or CFR title number.
vaquillmcp_extract_statute_citationsPaste text (a brief, memo or answer) and get each distinct US statute, regulation, court rule and constitution citation, resolved to its section.Read-onlyExtract Citations from Text
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.
Inputs
textstringrequired- 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-Keystring- 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.
includeUnresolvedboolean- `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 resolveboolean- 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 statestring- 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.
vaquillmcp_fetchFetch the full text of one US law section by the `id` from a `search` result, returning `{id, title, text, url, metadata}`.Read-onlyFetch Document
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.
Inputs
idstringrequired- No description.
vaquillmcp_get_credit_balanceThe credits this API key can spend now, calculated from live credit buckets under the same expiry rules used for billing.Read-onlyCredit Balance
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.
Inputs
This tool takes no inputs.
vaquillmcp_get_part_rulemakingEvery Federal Register rule, proposed rule and notice whose CFR references include one title and part, newest first.Read-onlyFederal Register Documents for a CFR Part
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.
Inputs
partstringrequired- CFR part number, e.g. `314`.
titleintegerrequired- CFR title number (1 to 50).
Idempotency-Keystring- 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.
yearsinteger- 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
vaquillmcp_get_pricingCurrent API credit pricing: per-endpoint credit costs and the credit-to-currency conversion rate (1 credit = $0.01 USD).Read-onlyCredit Pricing
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.
Inputs
regionstring- Defaults to the jurisdiction of the documentation you are reading. If omitted, returns pricing only for that jurisdiction's endpoints, not prices across jurisdictions.
vaquillmcp_get_rulemaking_committee_recordOne 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).Read-onlyRules Committee Record
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.
Inputs
record_idstringrequired- Committee record id from the list, `rcr_` and 24 hex characters.
Idempotency-Keystring- 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.
pageFrominteger- 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 pageLimitinteger- Pages per call.default
50
vaquillmcp_get_rulemaking_coverageWhat 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-onlyRulemaking Coverage
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.
Inputs
This tool takes no inputs.
vaquillmcp_get_rulemaking_docketOne 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).Read-onlyRegulations.gov Docket
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.
Inputs
docket_idstringrequired- Regulations.gov docket id, for example `EPA-HQ-OAR-2021-0208`. Case is kept as printed.
Idempotency-Keystring- 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.
vaquillmcp_get_rulemaking_rinEverything 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.Read-onlyRulemaking by RIN
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.
Inputs
rinstringrequired- Regulation Identifier Number `NNNN-XXNN`; lower case is accepted.
Idempotency-Keystring- 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.
vaquillmcp_get_section_changesWhat our refreshes have observed changing on one section over time: when it was added, amended or removed, newest first.Read-onlySection Change History
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.
Inputs
act_idstringrequired- 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.
beforeIdstring- 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.
changeKindstring- Filter to these kinds. Repeat the parameter to pass several (`?changeKind=amended&changeKind=removed`). Omit for all three.
Idempotency-Keystring- 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.
limitinteger- Max changes to return on this page.default
50 orderstring- `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
ascdescdefaultdesc sinceIdstring- 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.
vaquillmcp_get_section_cited_byThe USC and CFR sections whose text cross-references a given section: the inverse of the crossReferences already returned on a section lookup.Read-onlySections Citing This One
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.
Inputs
act_idstringrequired- 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-Keystring- 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.
limitinteger- Page size: maximum citing sections to return.default
25 offsetinteger- Rows to skip. Resume with the previous response's `nextOffset`. A page past the end is empty and not charged.default
0
vaquillmcp_get_section_cross_stateProvisions in OTHER states that address the same subject as a given state statute section, ranked by similarity.Read-onlySame Rule in Other States
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.
Inputs
act_idstringrequired- 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-Keystring- 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.
limitinteger- Maximum states to return, one provision each.default
5
vaquillmcp_get_section_definitionsThe term definitions that govern a section, parsed from its chapter's definitions section.Read-onlyDefined Terms in Section
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.
Inputs
act_idstringrequired- 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-Keystring- 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.
vaquillmcp_get_section_enactmentsThe 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.Read-onlySession Laws Affecting a Section
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.
Inputs
act_idstringrequired- 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-Keystring- 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.
vaquillmcp_get_section_neighborsThe sections immediately before and after a given section within its own chapter or code, in statutory order.Read-onlyAdjacent Sections
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.
Inputs
act_idstringrequired- 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-Keystring- 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.
limitinteger- How many sections to return on EACH side.default
3
vaquillmcp_get_section_rulemakingThe Federal Register documents behind one CFR section, from the section's printed source note and from eCFR amendment dates.Read-onlyFederal Register Documents for a CFR Section
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.
Inputs
act_idstringrequired- 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-Keystring- 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.
vaquillmcp_get_sections_batchMetadata for up to 50 sections in one call, by a list of act_ids.Read-onlyStatute Sections (Batch)
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.
Inputs
actIdsarrayrequired- 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-Keystring- 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.
includeBodyboolean- 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
vaquillmcp_get_session_lawOne US state session law's record: citation, session, approval and effective dates, code sections it affects, official sources and textStatus.Read-onlyState Session Law Record
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.
Inputs
session_law_idstringrequired- 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-Keystring- 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.
jurisdictionstring- 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.
vaquillmcp_get_session_law_bodyThe 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.Read-onlyState Session Law Text
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.
Inputs
session_law_idstringrequired- 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.
cursorstring- 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.
expectTextSha256string- 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-Keystring- 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.
includeUnverifiedboolean- 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 startCharstring- 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.
versionstring- 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.
vaquillmcp_get_session_law_changesA 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.Read-onlySession Law Change Feed
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.
Inputs
Idempotency-Keystring- 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.
jurisdictionstring- 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.
limitinteger- 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 sinceIdinteger- 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
vaquillmcp_get_session_law_versionsEvery version of one STATE session law that we served or adopted, newest first, and which is current.Read-onlyState Session Law Versions
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.
Inputs
session_law_idstringrequired- 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-Keystring- 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.
vaquillmcp_get_session_laws_batchRead up to 50 US state session laws in one call, by sessionLawId or citation: the record get_session_law returns, for each.Read-onlyState Session Laws (Batch)
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.
Inputs
idsarrayrequired- 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-Keystring- 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.
includeBodyboolean- 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 jurisdictionstring- 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.
vaquillmcp_get_us_statute_sectionMetadata for one US statute, regulation or rule section by act_id: citation, title hierarchy, breadcrumb, amendment history, and links to HTML, PDF and XML.Read-onlyStatute Section Metadata
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.
Inputs
act_idstringrequired- 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.
fullboolean- 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-Keystring- 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.
vaquillmcp_get_us_statute_section_textThe full text of a US statute, regulation or rule section by act_id.Read-onlyStatute Section Text
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.
Inputs
act_idstringrequired- 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.
asOfstring- 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.
formatstring- 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
allbothhtmlmarkdownplaincontentoperativedefaultboth Idempotency-Keystring- 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.
pinpointstring- 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.
structuredboolean- 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
vaquillmcp_list_docket_documentsThe documents of one Regulations.gov docket, oldest first: the proposal, notices, final rule and supporting material, with comment periods and Federal Register document numbers.Read-onlyDocuments in a Docket
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.
Inputs
docket_idstringrequired- Regulations.gov docket id, for example `EPA-HQ-OAR-2021-0208`. Case is kept as printed.
cursorstring- `nextCursor` of the previous page; same filters.
documentTypestring- Only documents of this Regulations.gov document type. Case is ignored.
Idempotency-Keystring- 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.
limitinteger- Page size, 1 to 100.default
50 openForCommentstring- `true` keeps only documents whose comment period is open.
postedFromstring- Only documents posted at or after this ISO-8601 instant.
postedTostring- 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`.
vaquillmcp_list_rin_agendaThe 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.Read-onlyUnified Agenda History of a RIN
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.
Inputs
rinstringrequired- Regulation Identifier Number `NNNN-XXNN`; lower case is accepted.
cursorstring- `nextCursor` of the previous page; same filters.
fromstring- Oldest Unified Agenda edition to include, as an edition id `YYYYMM`, for example `202010`. Must not be later than `to`.
Idempotency-Keystring- 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.
limitinteger- Editions per page, 1 to 100. Default 25.default
25 tostring- Newest Unified Agenda edition to include, as an edition id `YYYYMM`, for example `202510`. Must not be earlier than `from`.
vaquillmcp_list_rulemaking_committee_recordsList Judicial Conference Rules Committee records (minutes, agenda books, reports, rules packages, comments), newest first.Read-onlyRules Committee Records
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.
Inputs
committeestring- The Judicial Conference committee that produced the record: Standing, Appellate, Bankruptcy, Civil, Criminal, Evidence or General.
cursorstring- `nextCursor` of the previous page; same filters.
docketIdstring- Only records linked to this rulemaking docket id, for example `USC-RULES-CV-2025-0004`.
docTypestring- 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-Keystring- 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.
limitinteger- Page size, 1 to 100.default
50 rulestring- Rule number, for example `26`; needs `ruleSet`.
ruleSetstring- FRCP, FRAP, FRBP, FRCRP or FRE: records that discuss a rule of this set.
yearstring- Year of the record, for example `2024`.
vaquillmcp_list_rulemaking_docketsList and filter Regulations.gov dockets, most recently modified first, by agencyId, docketType (Rulemaking or Nonrulemaking), rin, hasRin and a modifiedSince/modifiedUntil window.Read-onlyRegulations.gov Dockets
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.
Inputs
agencyIdstring- Only dockets of this agency, by Regulations.gov agency acronym. Case is ignored.
cursorstring- `nextCursor` of the previous page; same filters.
docketTypestring- Only dockets of this type: `Rulemaking` or `Nonrulemaking`.
hasRinstring- `true` keeps only dockets that carry a RIN, `false` only those without one.
Idempotency-Keystring- 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.
limitinteger- Page size, 1 to 100.default
50 modifiedSincestring- Only dockets modified at or after this ISO-8601 instant.
modifiedUntilstring- 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`.
rinstring- Regulation Identifier Number `NNNN-XXNN`; lower case is accepted.
vaquillmcp_list_session_lawsList one US state's session laws (acts as enacted, v1 covers state acts only).Read-onlyState Session Laws
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.
Inputs
jurisdictionstringrequired- 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
alakasazarcacoctdedcflgaguhiidiliniakskylamemdmamimnmsmomtnenvnhnjnmnyncndmpohokorpaprriscsdtntxutvtvivawawvwiwy approvedFromstring- 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.
approvedTostring- 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.
cursorstring- 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.
effectiveFromstring- 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.
effectiveTostring- 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).
enactmentOutcomestring- 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.
hasTextstring- 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-Keystring- 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.
instrumentTypestring- 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.
isLawstring- 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.
limitinteger- 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 orderstring- `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
ascdescdefaultasc qstring- 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.
seriesstring- 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.
sessionstring- 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.
textStatusstring- 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.
updatedSincestring- 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.
vaquillmcp_list_statute_divisionsWalk the statutory hierarchy: list the level directly below what you pass, in statutory order.Read-onlyBrowse Code Structure
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.
Inputs
corpusTypestringrequired- Corpus to browse. Case-insensitive. The browsable subset of the `corpusType` tokens on `/us/statutes/coverage`.one of
USCCFRSTATEREGULATIONSTATE_RULESCONSTITUTIONSTATE_CONSTITUTIONFEDERAL_RULES actstring- 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`.
actStatusstring- 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.
agencystring- 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`.
articlestring- 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.
chapterstring- 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.
codestring- 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`).
cursorstring- Resume token from a previous response's `nextCursor`, passed back with the same filters. Omit it to start at the beginning of the listing.
divisionstring- 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).
excludeRepealedboolean- 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-Keystring- 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.
partstring- 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.
programstring- 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`.
statestring- 2-letter jurisdiction code, required for the state-scoped corpora (STATE, REGULATION, STATE_RULES, STATE_CONSTITUTION). Case-insensitive.
subchapterstring- 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.
subdivisionstring- U.S. Code only: the subdivision to list (`kind: subdivision`, Title 54). Needs the `division` it belongs to.
subjectGroupstring- 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.
subpartstring- 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.
subtitlestring- 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).
titlestring- 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`.
titleNumberstring- 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).
umbrellastring- 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`.
vaquillmcp_list_statutes_coverageCoverage matrix: every corpusType we hold and its per-jurisdiction section counts, split by recorded status in `statusBreakdown`.Read-onlyCorpus Coverage
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.
Inputs
statestring- One jurisdiction: a two-letter state code or `federal`. Omit for every jurisdiction (about a megabyte).
vaquillmcp_resolve_statute_citationResolve a Bluebook citation string ('42 U.S.C.Read-onlyResolve Citation
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.
Inputs
citestringrequired- A Bluebook citation string, e.g. '42 U.S.C. 1983' or '16 C.F.R. 444.1'.
corpusTypestring- 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-Keystring- 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.
statestring- 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.
vaquillmcp_resolve_statute_citations_batchResolve up to 50 Bluebook citations in one call, returning the same confirmed section, official source link and act_id as the single-citation tool.Read-onlyResolve Citations (Batch)
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.
Inputs
citationsarrayrequired- 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.
corpusTypestring- 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-Keystring- 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.
statestring- 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.
vaquillmcp_searchGeneric corpus search over US primary law, returning `{id, title, url}` records for citation.Read-onlySearch US Law
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.
Inputs
querystringrequired- No description.
vaquillmcp_search_session_lawsKeyword search (BM25, not semantic) over the ENACTED text of US state session laws, best first, each with the passage that matched and a snippet.Read-onlySearch State Session Laws
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.
Inputs
querystringrequired- 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.
approvedFromstring- 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.
approvedTostring- Only laws approved on or before this date, `YYYY-MM-DD`, inclusive. An end before `approvedFrom` is a 422, never charged.
Idempotency-Keystring- 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.
includeUnverifiedboolean- 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 instrumentTypestring- 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.
jurisdictionstring- 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.
limitinteger- 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 offsetinteger- 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 seriesstring- 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.
sessionstring- 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.
vaquillmcp_search_us_statutesSearch US federal and state statutes, regulations, constitutions and court rules.Read-onlySearch US Statutes
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.
Inputs
querystringrequired- 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.
actStatusstring- 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.
agencystring- 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.
articlestring- 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.
changedSincestring- 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.
chapterstring- 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.
codestring- 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.
corpusTypestring- 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.
documentTypestring- 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_`).
excerptCharsinteger- 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 excludeRepealedboolean- 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 fieldsstring- 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-Keystring- 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.
includeBodyboolean- 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 includePinpointboolean- 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 limitinteger- Number of results to return per page.default
10 matchTypestring- `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
anyallphrasebooleandefaultany offsetinteger- 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 partstring- 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.
publishedFromstring- 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.
publishedTostring- Only return Federal Register documents published on or before this date.
sourcestring- 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.
statestring- 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.
titleNumberstring- 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).
yearFromstring- 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.
yearTostring- 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.
No tools match.