Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Vaquill MCP server

Vendor MCP
Open markdown

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 app
Your own Vaquill MCP server app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  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.

  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

    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.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)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • vaquillmcp_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-only

    Count 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-only

    Extract 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-only

    Fetch 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-only

    Credit 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-only

    Federal 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-only

    Credit 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-only

    Rules 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-only

    Rulemaking 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.