Skip to content
VA BillsVirginia legislation, within reach.
← Bill chat

Connect your own AI agent

Use VA Bills’s bill sources from an agent that supports the Model Context Protocol (MCP).

Search Virginia legislation and read the cited bill text from your own AI assistant. The public connector is read-only and requires no VA Bills account.

Connect by URL

In your agent’s MCP settings, add a server named VA Bills. Choose Streamable HTTP and enter:

https://vabills.org/mcp

Choose No authentication (or No sign in). Your AI provider may require a supported plan or workspace administrator approval.

Connect in Claude

Open Claude connectors ↗

  1. Open Customize → Connectors, then + Add → Add custom connector.
  2. Name it VA Bills and paste https://vabills.org/mcp.
  3. Continue, choose No sign in, and finish adding it.
  4. In a chat, open + → Connectors and enable VA Bills.

Team accounts may need an owner to add it first. Claude’s setup guide.

Connect in ChatGPT

Open ChatGPT plugins ↗

  1. Select + → Add custom MCP server.
  2. Name it VA Bills, set the server URL to https://vabills.org/mcp, and choose No authentication.
  3. Review the permissions, create the plugin, and install it.
  4. In a new chat, type @ and select VA Bills.

Your workspace may restrict custom servers. Labels can vary by account. ChatGPT’s setup guide.

For developers: connect through a local checkout

For agents supporting stdio servers, use this configuration. Replace the console path with your RSun checkout and use the absolute path to PHP if your desktop app cannot find it.

{
  "mcpServers": {
    "va-bills": {
      "command": "php",
      "args": [
        "/absolute/path/to/rsun/bin/console",
        "mcp:server",
        "bills",
        "--no-debug",
        "--no-interaction"
      ]
    }
  }
}

The app reads its existing local database and AI configuration. You do not need to paste its provider keys into your agent. The agent uses its own model to answer; semantic searches may use the app’s embedding provider.

What your agent can do

find_bills
Search sections with full-text and semantic retrieval. Supply year and optionally billId; check the returned coverage for the selected session’s catalog and semantic indexing.
find_bill_summaries
Find bills by title or summary in an imported session.
read_bill
Read a bill by numeric id, including its sponsor, status, source text and version references.
read_bill_section
Read a specific section by its returned id, including proposed wording and marked changes.

These tools read bill sources; they do not modify legislation data. Unlike the website’s bill chat, an external agent must pass the desired session and bill scope itself.

Try this prompt

Use VA Bills to find 2026 bills proposing changes to tobacco taxes. Read the relevant sections, distinguish proposed changes from enacted law, and cite the returned sources. Don’t infer that no other bills exist from ranked search results.

For a quick connection check, ask your agent to call read_bill with id: 83553. It should return 2026 HB1, version CHAP0350.

Sources return site-relative citation links. Resolve them against https://vabills.org. Historical version references may have no available body; a reference alone cannot support a comparison.