Washington State Legislature MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to Washington State Legislature data, enabling civic engagement through conversational interfaces.

Overview

This MCP server connects AI assistants to the Washington State Legislative Web Services (WSLWS), providing tools for:

Bill tracking and information retrieval
Committee meeting schedules and agendas
Legislator lookup and sponsor information
Bill status and history tracking
Legislative document access

Features

Core Tools

getBillInfo - Retrieve detailed information about specific bills
searchBills - Search for bills using keywords and optional filtering
getBillsByYear - Retrieve all bills from a specific year with filtering options
getCommitteeMeetings - Get committee meeting schedules and agendas
findLegislator - Find legislators by district or lookup sponsors
getBillStatus - Get current status and history of a bill
getBillDocuments - Retrieve bill document metadata with links
getBillContent - Retrieve the actual content of a bill in AI-friendly format

MCP Resources

bill://xml/{biennium}/{chamber}/{bill_number} - Access bill documents in structured XML format
bill://htm/{biennium}/{chamber}/{bill_number} - Access bill documents in HTML format
bill://pdf/{biennium}/{chamber}/{bill_number} - Get URLs for bill PDF documents
bill://document/{format}/{biennium}/{chamber}/{bill_number} - Generic format for accessing bill documents

Installation

Prerequisites

Python 3.10+
pip package manager

Development Installation

pip install -e ".[dev]"

Production Installation

pip install .

Quick Start

Local Development

# Test with MCP Inspector
mcp dev src/wa_leg_mcp/server.py

# Run with stdio transport
python src/wa_leg_mcp/server.py

Remote Deployment

For cloud deployment on AWS Lambda, you can use the mcp-remote adapter to enable Claude Desktop connectivity:

{
  "mcpServers": {
    "wa-leg": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-api-gateway-url/sse"
      ]
    }
  }
}

Basic Configuration

Create a .env file:

WSL_API_TIMEOUT=30
WSL_CACHE_TTL=300
LOG_LEVEL=INFO
SERVER_NAME="Washington State Legislature MCP Server"

Repository Structure

wa-leg-mcp/
├── src/
│   ├── wa_leg_mcp/
│   │   ├── __init__.py
│   │   ├── server.py           # Main MCP server implementation
│   │   ├── tools/              # Tool implementations
│   │   │   ├── __init__.py
│   │   │   ├── bill_tools.py
│   │   │   ├── committee_tools.py
│   │   │   └── legislator_tools.py
│   │   ├── resources/          # MCP resource implementations
│   │   │   ├── __init__.py
│   │   │   └── bill_resources.py # Bill document resources
│   │   ├── clients/            # API clients
│   │   │   ├── __init__.py
│   │   │   └── wsl_client.py   # WA State Legislature API client
│   │   └── utils/              # Utility functions
│   │       ├── __init__.py
│   │       └── formatters.py
├── tests/                      # Test suite
│   ├── __init__.py
│   ├── test_bill_tools.py
│   ├── test_bill_resources.py  # Tests for bill resources
│   ├── test_committee_tools.py
│   ├── test_legislator_tools.py
│   ├── test_server.py
│   ├── test_utils_formatters.py
│   └── test_wsl_client.py
├── pyproject.toml              # Project configuration and dependencies
├── Makefile                    # Development workflow commands
├── README.md
└── LICENSE

Development

Setting Up Development Environment

Clone the repository:

git clone https://github.com/awalcutt/wa-leg-mcp.git
cd wa-leg-mcp

Create virtual environment:

python -m venv venv
source venv/bin/activate  # Or `venv\Scripts\activate` on Windows

Install development dependencies:

pip install -e ".[dev]"

Run tests:

make test

Adding New Tools

Create a new file in src/wa_leg_mcp/tools/
Implement tool using the MCP decorator:

from mcp.server.fastmcp import Tool

@Tool("toolName", description="Tool description")
def tool_function(param1: str, param2: str = None):
    # Implementation
    return {"result": data}

Register tool in server.py by adding it to the get_default_tools() function
Add tests in tests/

Deployment Options

Local Deployment

Run directly with Python
Use with MCP Inspector for development

Cloud Deployment

AWS Lambda with API Gateway (supports remote connections via mcp-remote adapter)
Google Cloud Functions
Azure Functions

Environment Variables

Variable	Description	Default
`WSL_API_TIMEOUT`	API request timeout (seconds)	30
`WSL_CACHE_TTL`	Cache time-to-live (seconds)	300
`LOG_LEVEL`	Logging level	INFO
`SERVER_NAME`	Custom server name	Washington State Legislature MCP Server

Usage Examples

With Claude Desktop

Add to Claude Desktop configuration:

{
  "mcpServers": {
    "wa-leg": {
      "command": "python",
      "args": ["path/to/src/wa_leg_mcp/server.py"],
      "env": {
        "WSL_CACHE_TTL": "600"
      }
    }
  }
}

With Other AI Clients

# Example client integration
from mcp.client import ClientSession
import asyncio

async def connect_to_legislature_mcp():
    async with ClientSession(server_command=["python", "src/wa_leg_mcp/server.py"]) as session:
        # List available tools
        tools = await session.list_tools()
        
        # Call a tool
        result = await session.call_tool("getBillInfo", {
            "bill_number": "HB1234",
            "biennium": "2025-26"
        })
        
        print(result)
        
        # Access a resource
        bill_xml = await session.read_resource(
            "bill://xml/2025-26/House/1234"
        )
        
        print(f"Bill XML content length: {len(bill_xml)}")

asyncio.run(connect_to_legislature_mcp())

API Documentation

Tools

getBillInfo

Retrieves detailed information about a specific bill using the GetLegislation API.

Parameters:

bill_number (string, required): Bill number (e.g., "HB1234", "SB5678")
biennium (string, required): Legislative biennium in format "2025-26"

Returns: Bill details including description, sponsor, status, fiscal notes, and companions

searchBills

Searches for bills using keywords and optional filtering via the WSL Search API.

Parameters:

query (string, required): Search query text (e.g., "climate change", "transportation")
bienniums (array, optional): List of bienniums to search (format: "YYYY-YY"), defaults to current
agency (string, optional): Filter by originating agency ("House", "Senate", or "Both")
max_results (integer, optional): Maximum number of total results to return (max 100)

Returns: List of bills matching the search criteria

getBillsByYear

Retrieves all bills from a specific year with optional filtering using the GetLegislationByYear API.

Parameters:

year (string, optional): Year in format "YYYY" (e.g., "2025"), defaults to current
agency (string, optional): Filter by originating agency ("House" or "Senate")
active_only (boolean, optional): If True, only return active bills

Returns: List of bills matching the criteria

getCommitteeMeetings

Retrieves committee meetings and agendas using the GetCommitteeMeetings API.

Parameters:

start_date (string, required): Start date in YYYY-MM-DD format
end_date (string, required): End date in YYYY-MM-DD format
committee (string, optional): Filter by specific committee

Returns: List of committee meetings with dates, times, locations, and agenda items

findLegislator

Finds legislators using the GetSponsors API.

Parameters:

biennium (string, required): Legislative biennium in format "2025-26"
chamber (string, optional): "house" or "senate"

Returns: List of legislators with ID, name, party, and contact information

getBillStatus

Gets current status and history using the GetCurrentStatus API.

Parameters:

bill_number (string, required): Bill number (e.g., "HB1234")
biennium (string, required): Legislative biennium in format "2025-26"

Returns: Current status, history, action dates, and status descriptions

getBillDocuments

Retrieves bill documents metadata (functionality based on Document service endpoints).

Parameters:

bill_number (string, required): Bill number
biennium (string, required): Legislative biennium in format "2025-26"
document_type (string, optional): "bill", "amendment", "report"

Returns: Document metadata with links to HTML and PDF versions

getBillContent

Retrieves the actual content of a bill in an AI-friendly format.

Parameters:

bill_number (integer, required): Bill number as an integer (e.g., 1234 for HB1234)
biennium (string, optional): Legislative biennium in format "2025-26" (defaults to current)
chamber (string, optional): Chamber name - "House" or "Senate" (optional if bill_number is unique across chambers)
bill_format (string, optional): Document format - "xml" (default), "htm", or "pdf"

Returns: For XML and HTM formats: Dict containing the document content and metadata. For PDF format: Dict containing the URL to access the PDF and metadata.

Resources

Bill Document Resources

The MCP server provides direct access to bill documents through URI templates:

bill://xml/{biennium}/{chamber}/{bill_number}

Access bill documents in structured XML format (recommended for AI processing).

Parameters:

biennium (string): Legislative biennium in format "YYYY-YY" (e.g., "2025-26")
chamber (string): Chamber name - must be exactly "House" or "Senate"
bill_number (string): Bill number as numeric string (e.g., "1234")

Returns: XML content of the bill document

bill://htm/{biennium}/{chamber}/{bill_number}

Access bill documents in HTML format with hyperlinks to referenced laws.

Parameters:

biennium (string): Legislative biennium in format "YYYY-YY"
chamber (string): "House" or "Senate"
bill_number (string): Bill number

Returns: HTML content of the bill document

bill://pdf/{biennium}/{chamber}/{bill_number}

Get URLs for bill PDF documents (content not fetched).

Parameters:

biennium (string): Legislative biennium in format "YYYY-YY"
chamber (string): "House" or "Senate"
bill_number (string): Bill number

Returns: Dictionary with URL to access the PDF document

bill://document/{format}/{biennium}/{chamber}/{bill_number}

Generic format for accessing bill documents in any supported format.

Parameters:

format (string): Document format - "xml", "htm", or "pdf"
biennium (string): Legislative biennium in format "YYYY-YY"
chamber (string): "House" or "Senate"
bill_number (string): Bill number

Returns: Document content or URL based on format

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Name		Name	Last commit message	Last commit date
Latest commit History 21 Commits
.github/workflows		.github/workflows
examples		examples
src/wa_leg_mcp		src/wa_leg_mcp
tests		tests
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
MANIFEST.in		MANIFEST.in
Makefile		Makefile
README.md		README.md
pyproject.toml		pyproject.toml

License

awalcutt/wa-leg-mcp

Folders and files

Latest commit

History

Repository files navigation

Washington State Legislature MCP Server

Overview

Features

Core Tools

MCP Resources

Installation

Prerequisites

Development Installation

Production Installation

Quick Start

Local Development

Remote Deployment

Basic Configuration

Repository Structure

Development

Setting Up Development Environment

Adding New Tools

Deployment Options

Local Deployment

Cloud Deployment

Environment Variables

Usage Examples

With Claude Desktop

With Other AI Clients

API Documentation

Tools

getBillInfo

searchBills

getBillsByYear

getCommitteeMeetings

findLegislator

getBillStatus

getBillDocuments

getBillContent

Resources

Bill Document Resources

bill://xml/{biennium}/{chamber}/{bill_number}

bill://htm/{biennium}/{chamber}/{bill_number}

bill://pdf/{biennium}/{chamber}/{bill_number}

bill://document/{format}/{biennium}/{chamber}/{bill_number}

Contributing

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Languages

Packages