Vaquill MCP Server

The Vaquill MCP server gives any Model Context Protocol client - Claude.ai, Claude Desktop, Claude Code, Cursor, VS Code, Windsurf - direct access to the Vaquill statutes API. It covers US federal and 50-state statutes (the US Code, the CFR, and all 50 state statute codes). Source: github.com/Vaquill-AI/vaquill-mcp.

GitHub

Source code and issues

PyPI

uvx vaquill-mcp

Hosted endpoint

https://mcp.vaquill.ai

Quickstart

The fastest path is the hosted remote MCP on Claude.ai web - no install, no local Python, no config files.

Install Vaquill MCP in Claude Code with one paste. Replaces a manual config edit.

Get an API key

Generate a vq_key_... token from your dashboard settings. See Authentication.

Open Claude.ai Customize > Connectors

Click Add custom connector.

Paste the URL

Use either the path-token form:

https://mcp.vaquill.ai/s/vq_key_your_key_here

Or keep the key out of the URL by opening Request headers in the same dialog and adding it there:

URL:            https://mcp.vaquill.ai/s/_
Header name:    Authorization
Header value:   Bearer vq_key_your_key_here

Claude sends the value exactly as you type it and adds no scheme of its own, so the value field holds Bearer vq_key_... and not Authorization: Bearer vq_key_....

Look up a statute

Try: “What does 17 CFR 240.10b-5 say about insider trading?” - Claude will call search_us_statutes and pull the section text.

Remote MCP connectors are available on Claude Pro, Max, Team, and Enterprise plans. The Request headers section is in beta and is enabled per account, it accepts a short allowlist of header names, and it holds at most four. If you do not see it, use the path-token URL, or connect from Claude Code, Cursor, VS Code, or Windsurf, which all carry the header as written. On Team and Enterprise an owner adds the connector under Organization settings first.

Client setup

Pick your client below. The remote endpoint needs no install. The local uvx package reads the variables in Environment variables.

// Settings > Developer > Edit Config opens this file.
//   macOS    ~/Library/Application Support/Claude/claude_desktop_config.json
//   Windows  %APPDATA%\Claude\claude_desktop_config.json
//   Linux    ~/.config/Claude/claude_desktop_config.json
// Quit Claude completely and reopen it. It does not reload the file.
{
  "mcpServers": {
    "vaquill": {
      "command": "uvx",
      "args": ["vaquill-mcp"],
      "env": {
        "VAQUILL_API_KEY": "vq_key_your_key_here"
      }
    }
  }
}

# --scope user registers it for every project. The default is the current directory only.
claude mcp add --transport http --scope user vaquill \
  https://mcp.vaquill.ai/s/_ \
  --header "Authorization: Bearer vq_key_your_key_here"

# -e stores the key with the registration, so it survives Claude Code being launched from an IDE.
claude mcp add --scope user vaquill -e VAQUILL_API_KEY=vq_key_your_key_here \
  -- uvx vaquill-mcp

// ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
{
  "mcpServers": {
    "vaquill": {
      "url": "https://mcp.vaquill.ai/s/_",
      "headers": {
        "Authorization": "Bearer vq_key_your_key_here"
      }
    }
  }
}

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "vaquill": {
      "command": "uvx",
      "args": ["vaquill-mcp"],
      "env": {
        "VAQUILL_API_KEY": "vq_key_your_key_here"
      }
    }
  }
}

// .vscode/mcp.json. For every project, run the "MCP: Open User Configuration"
// command and use the same shape there.
{
  "inputs": [
    {
      "type": "promptString",
      "id": "vaquill-authorization",
      "description": "Authorization header value",
      "password": true
    }
  ],
  "servers": {
    "vaquill": {
      "type": "http",
      "url": "https://mcp.vaquill.ai/s/_",
      "headers": {
        "Authorization": "${input:vaquill-authorization}"
      }
    }
  }
}

// .vscode/mcp.json
{
  "servers": {
    "vaquill": {
      "type": "stdio",
      "command": "uvx",
      "args": ["vaquill-mcp"],
      "env": {
        "VAQUILL_API_KEY": "vq_key_your_key_here"
      }
    }
  }
}

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "vaquill": {
      "serverUrl": "https://mcp.vaquill.ai/s/_",
      "headers": {
        "Authorization": "Bearer vq_key_your_key_here"
      }
    }
  }
}

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "vaquill": {
      "command": "uvx",
      "args": ["vaquill-mcp"],
      "env": {
        "VAQUILL_API_KEY": "vq_key_your_key_here"
      }
    }
  }
}

VS Code asks for the header value on first start and remembers it, which keeps the credential out of a file you commit. ${env:VAQUILL_API_KEY} works in Windsurf if you would rather read it from the environment. Both clients need the server restarted after you save the file before the tools appear.

The uvx runner requires Python 3.10+ and uv on PATH. uvx vaquill-mcp downloads and executes the package in an isolated env on first run; subsequent runs are instant.

Tools

The server exposes statute tools across three categories.

General

Tool	Description	Credits
`get_pricing`	Get current API credit pricing. No auth required.	Free

US law (USC + CFR)

Tool	Description	Credits
`search_us_statutes`	Semantic search across the United States Code (USC) and Code of Federal Regulations (CFR). Filter by `corpusType` and `titleNumber`.	4
`get_us_statute_section`	Metadata for a specific USC / CFR section by `act_id` - citation, title hierarchy, links.	2
`get_us_statute_section_text`	Full HTML and plain text of a USC or CFR section.	6

Acts and legislation

Tool	Description	Credits
`search_legislation`	Semantic search across acts, regulations, and state legislation. Filter by category, state, department, year.	1
`list_legislation`	Browse acts to discover `act_id` values. Filter by category, state, department, status.	1
`get_act_text`	URLs for full text, PDF, and HTML versions of an act.	1
`get_amendments`	Complete amendment history for an act (substitutions, insertions, omissions).	1

Authentication

The Vaquill MCP server authenticates with your Vaquill API key. Three options, in priority order:

Bearer header (remote): Authorization: Bearer vq_key_...
Path token (remote): https://mcp.vaquill.ai/s/vq_key_... - convenient when your client cannot send custom headers.
Environment variable (local): VAQUILL_API_KEY=vq_key_... for uvx / stdio launches.

Keys are scoped per workspace and revocable from the dashboard. For the full auth model, request signing, and rotation policy, see Authentication.

Treat the path-token URL as a secret - anyone with the URL can spend credits from your account. Prefer the bearer-token form whenever the client supports it.

Self-hosting

The MCP server is a thin wrapper around the public Vaquill API, so most users will not need to self-host. Run from source when you want to pin a version, add custom telemetry, or modify tool descriptions.

git clone https://github.com/Vaquill-AI/vaquill-mcp.git
cd vaquill-mcp
uv sync --all-extras

# Run locally over stdio
VAQUILL_API_KEY=vq_key_... uv run vaquill-mcp

# Inspect tools interactively
uv run fastmcp dev src/vaquill_mcp/server.py

The package fetches the OpenAPI spec from https://api.vaquill.ai at startup and auto-generates MCP tools with FastMCP. New API endpoints appear as tools automatically without a package upgrade.

Environment variables

Variable	Required	Default	Description
`VAQUILL_API_KEY`	Yes	-	Your API key (`vq_key_...`) from vaquill.ai/settings
`VAQUILL_BASE_URL`	No	`https://api.vaquill.ai`	API base URL. Override for staging or self-hosted API instances.
`VAQUILL_TIMEOUT`	No	`120`	Per-request timeout in seconds. Increase for large section-text fetches.

Usage examples

Type these directly to Claude, Cursor, or any connected assistant. US law

“What does 17 CFR 240.10b-5 say about insider trading?” “Find USC sections on equal protection under the Fourteenth Amendment.” “What are the federal penalties for wire fraud under 18 USC 1343?” “Pull the full text of 26 USC 501(c)(3).”

Ready-to-run research prompt

Map a federal statute across USC and CFR. Paste into any Vaquill-connected assistant. Replace the citation.

MCP overview

All Vaquill MCP servers at a glance

Integrations

Chatbots, widgets, browser extensions, and automation

Authentication

API key setup and rotation

Search US statutes (API)

The underlying REST endpoint

GET STARTED

CONTRACTS & DRAFTING

COMPLIANCE & LEGAL TOOLS

MATTERS & WORKSPACES

DOCUMENTS & INGESTION

PERSONALIZATION

RESEARCH

INTEGRATIONS

GitHub

PyPI

Hosted endpoint

Quickstart

Client setup

Tools

General

US law (USC + CFR)

Acts and legislation

Authentication

Self-hosting

Environment variables

Usage examples

Ready-to-run research prompt

MCP overview

Integrations

Authentication

Search US statutes (API)

GitHub

PyPI

Hosted endpoint

​Quickstart

​Client setup

​Tools

​General

​US law (USC + CFR)

​Acts and legislation

​Authentication

​Self-hosting

​Environment variables

​Usage examples

​Ready-to-run research prompt

​Related

MCP overview

Integrations

Authentication

Search US statutes (API)

Quickstart

Client setup

Tools

General

US law (USC + CFR)

Acts and legislation

Authentication

Self-hosting

Environment variables

Usage examples

Ready-to-run research prompt

Related