Skip to main content
Glama
Sign In

CongressMCP-full

by amurshak
GitHub
Python
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Congress.gov API MCP Server

🎉 Production Ready - Complete Legislative Data Access via 6 Toolsets

This Model Context Protocol (MCP) server provides comprehensive access to the Congress.gov API through 6 organized toolsets, enabling AI systems to retrieve and interact with legislative data from the United States Congress with a clean, unified interface.

🎯 Complete Access: 6 Toolsets • 92 Operations • All Functions Available

🚀 Quick Start

1. Get Your API Key

Visit congressmcp.lawgiver.ai to register and get your API key.

npm install -g congressmcp

3. Configure Your MCP Client

Add this to your MCP client configuration (e.g., Claude Desktop):

{ "mcpServers": { "congressional-mcp": { "command": "npx", "args": ["-y", "congressmcp"], "env": { "CONGRESSMCP_API_KEY": "your-api-key-here" } } } }

4. Restart Your MCP Client

You'll now have access to 6 organized toolsets covering 92 congressional operations!

🗂️ Toolset Architecture (v1.6.0)

🎯 Major Achievement: 87+ Tools → 6 Organized Toolsets

We've successfully consolidated 87+ individual tools into 6 logical, organized toolsets for a dramatically improved user experience. All operations are now available to all users, with rate limiting based on tier:

1. 📋 Legislation Hub (legislation_hub)

Consolidates: Bills, Amendments, Summaries, Treaties
Operations: 24 total (all available)

  • Bills: Search, details, text, actions, amendments, cosponsors, subjects
  • Amendments: Search, details, actions, sponsors
  • Summaries: Bill summaries with keyword search
  • Treaties: Search, actions, committees, text
2. 👥 Members and Committees (members_and_committees)

Consolidates: Congressional Members, Committees, Committee Operations
Operations: 13 total (all available)

  • Members: Search, details, sponsored/cosponsored legislation
  • Committees: Search, bills, reports, communications, nominations
3. 🗳️ Voting and Nominations (voting_and_nominations)

Consolidates: House Votes, Nominations
Operations: 14 total (all available)

  • House Votes: By Congress/session, details, member votes, XML data
  • Nominations: Search, details, actions, committees, hearings
4. 📰 Records and Hearings (records_and_hearings)

Consolidates: Congressional Records, Communications, Hearings
Operations: 16 total (all available)

  • Congressional Records: Daily/bound records, search functionality
  • Communications: House/Senate communications, requirements
  • Hearings: Search, details, content by Congress/chamber
5. 📊 Committee Intelligence (committee_intelligence)

Consolidates: Committee Reports, Prints, Meetings
Operations: 19 total (all available)

  • Committee Reports: Latest, by Congress/type, details, content
  • Committee Prints: Latest, by Congress/chamber, details
  • Committee Meetings: Latest, by Congress/chamber/committee, search
6. 🔬 Research and Professional (research_and_professional)

Consolidates: Congress Information, CRS Reports
Operations: 6 total (all available)

  • Congress Info: Basic and enhanced Congress information
  • CRS Reports: Congressional Research Service report search
  • Professional Analytics: Enhanced research capabilities

🏗️ Architecture Overview

Toolset Design

Each toolset accepts an operation parameter to route to specific functionality:

# Example usage await legislation_hub( operation="search_bills", keywords="climate change", congress=118, limit=10 ) await members_and_committees( operation="search_members", name="Smith", state="CA" )

Access Control

  • Universal Access: All operations available to all users
  • Rate Limiting: Free tier gets 200 calls/month, Pro tier gets 5000 calls/month
  • Usage Tracking: Clear monitoring of API call usage and limits

API Reliability Framework

  • Parameter Validation: Comprehensive input validation for all operations
  • Defensive API Calls: Retry logic and timeout handling for external requests
  • Response Processing: Standardized deduplication and error handling
  • Enhanced Error Messages: User-friendly error responses with operation guidance

📁 Project Structure

CongressMCP/ ├── congress_api/ │ ├── core/ # Core infrastructure │ │ ├── auth.py # Authentication & authorization │ │ ├── config.py # Configuration management │ │ ├── database.py # Database connections │ │ └── middleware.py # ASGI middleware │ ├── features/ # Feature implementations │ │ ├── buckets/ # 🆕 Toolset implementations │ │ │ ├── legislation_hub.py │ │ │ ├── members_and_committees.py │ │ │ ├── voting_and_nominations.py │ │ │ ├── records_and_hearings.py │ │ │ ├── committee_intelligence.py │ │ │ └── research_and_professional.py │ │ ├── bills.py # Internal bill functions │ │ ├── members.py # Internal member functions │ │ ├── committees.py # Internal committee functions │ │ └── [other features] # Internal feature functions │ ├── reliability/ # API reliability framework │ │ ├── validators.py # Parameter validation │ │ ├── api_wrapper.py # Defensive API calls │ │ ├── exceptions.py # Error handling │ │ └── response_utils.py # Response processing │ └── utils/ # Utility functions ├── tests/ # Comprehensive test suite ├── documentation/ # Technical documentation ├── requirements.txt # Python dependencies ├── Procfile # Heroku deployment └── README.md # This file

🚀 Deployment

Production Deployment

The server is deployed at api-cmcp.lawgiver.ai with:

  • SSL/TLS encryption
  • Automatic scaling
  • Environment-based configuration
  • Health monitoring

Local Development

  1. Clone the repository:
    git clone <repository-url> cd CongressMCP
  2. Set up environment:
    cp .env.example .env # Edit .env with your configuration
  3. Install dependencies:
    pip install -r requirements.txt
  4. Run the server:
    python run_server.py

Environment Configuration

Core Configuration:

  • CONGRESS_API_KEY: Your Congress.gov API key (required)
  • ENABLE_AUTH: Enable authentication (default: true)
  • ENABLE_DATABASE: Enable database features (default: true)
  • ENABLE_STRIPE: Enable payment integration (default: true)

Authentication:

  • LAWGIVER_JWT_SECRET: JWT secret for authentication
  • LAWGIVER_API_KEYS: API keys for user authentication (format: tier:user:key)
  • ADMIN_API_KEY: Admin API key for key management
  • ENABLE_KEY_MANAGEMENT: Enable admin key management (default: false)

Database (Supabase):

  • SUPABASE_URL: Supabase project URL
  • SUPABASE_ANON_KEY: Supabase anonymous key
  • SUPABASE_SERVICE_KEY: Supabase service role key

Payment Processing (Stripe):

  • STRIPE_SECRET_KEY: Stripe secret key
  • STRIPE_WEBHOOK_SECRET: Stripe webhook secret
  • STRIPE_PRICE_PRO_MONTHLY: Stripe price ID for Pro monthly
  • STRIPE_PRICE_PRO_ANNUAL: Stripe price ID for Pro annual

Email Service (Resend):

  • RESEND_API_KEY: Resend API key
  • RESEND_FROM_EMAIL: From email address
  • FRONTEND_BASE_URL: Frontend URL for magic links
  • MAGIC_LINK_EXPIRY_MINUTES: Magic link expiry time (default: 60)

See .env.example for complete configuration with examples.

🧪 Testing

Run Tests

# Run all tests pytest # Run specific toolset tests pytest tests/test_legislation_hub_toolset.py pytest tests/test_members_committees_toolset.py # Run with coverage pytest --cov=congress_api

Test Coverage

  • Toolset Operations: Operation routing and validation tests for each of the 6 toolsets
  • Core Features: Selected tests for key functionality (amendments, email system)
  • Authentication: User registration, email templates, and API key validation tests
  • Integration: Basic endpoint testing with real API responses

📚 Documentation

Repository Documentation

  • API_RELIABILITY_GUIDE.md: Comprehensive reliability framework documentation
  • TOOL_CONSOLIDATION_PLAN.md: Bucket architecture implementation details

External Documentation

  • GitHub Issues: Bug reports and feature requests
  • Website: congressmcp.lawgiver.ai for setup guides and API documentation

🔧 Development

Adding New Operations

  1. Implement internal function in appropriate feature file
  2. Add operation to toolset in relevant toolset tool
  3. Update operation sets (add to FREE_OPERATIONS and ALL_OPERATIONS)
  4. Add comprehensive tests for the new operation
  5. Update documentation with operation details

Toolset Pattern

@mcp.tool("toolset_name") async def toolset_tool(ctx: Context, operation: str, **kwargs) -> str: # Validate operation exists if operation not in ALL_OPERATIONS: raise ValueError(f"Unknown operation: {operation}") # Rate limiting check (all operations available) await check_rate_limit(ctx) # Route to internal function if operation == "example_operation": return await _example_operation(ctx, **kwargs) # Handle routing return await route_operation(operation, ctx, **kwargs)

🎯 Key Benefits

For Users

  • Simplified Discovery: 6 logical toolsets instead of 87+ scattered tools
  • Universal Access: All 92 operations available regardless of tier
  • Consistent Interface: Unified parameter handling across all operations
  • Clear Documentation: Detailed operation descriptions and examples
  • Reliable Performance: Comprehensive error handling and retry logic

For Developers

  • Easier Maintenance: Centralized logic and consistent patterns
  • Better Testing: Focused test suites per toolset
  • Reduced Complexity: Eliminated 87 individual tool registrations
  • Improved Organization: Clear separation between interfaces and implementations
  • Open Source Ready: Easy configuration for self-hosting without commercial features

📊 Version History

v1.6.0 - Universal Free Access

  • Major Achievement: All 92 operations now available to free users
  • Simplified Tiers: Rate limiting (200/5000 calls) instead of function restrictions
  • Open Source Ready: Architecture supports easy deployment without commercial features
  • Enhanced UX: Simplified tool discovery and universal access

v1.5.0 - Toolset Architecture Complete

  • Major Achievement: Consolidated 87+ tools into 6 organized toolsets
  • Enhanced UX: Simplified tool discovery and consistent interfaces
  • Access Control: Operation-level tier management within toolsets
  • API Reliability: Full reliability framework integration

Previous Versions

See CHANGELOG.md for complete version history.

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Implement changes with tests
  4. Update documentation
  5. Submit a pull request

📄 License

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

🆘 Support

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

The open Congress.gov MCP server. Provides comprehensive access to the Congress.gov API through 6 organized toolsets, enabling AI systems to retrieve and interact with legislative data from the United States Congress with a clean, unified interface.

  1. 🚀 Quick Start
    1. Get Your API Key
    2. Install via NPM (Recommended)
    3. Configure Your MCP Client
    4. Restart Your MCP Client
  2. 🗂️ Toolset Architecture (v1.6.0)
    1. 🎯 Major Achievement: 87+ Tools → 6 Organized Toolsets
  3. 🏗️ Architecture Overview
    1. Toolset Design
    2. Access Control
    3. API Reliability Framework
  4. 📁 Project Structure
    1. 🚀 Deployment
      1. Production Deployment
      2. Local Development
      3. Environment Configuration
    2. 🧪 Testing
      1. Run Tests
      2. Test Coverage
    3. 📚 Documentation
      1. Repository Documentation
      2. External Documentation
    4. 🔧 Development
      1. Adding New Operations
      2. Toolset Pattern
    5. 🎯 Key Benefits
      1. For Users
      2. For Developers
    6. 📊 Version History
      1. v1.6.0 - Universal Free Access
      2. v1.5.0 - Toolset Architecture Complete
      3. Previous Versions
    7. 🤝 Contributing
      1. 📄 License
        1. 🆘 Support

          Related MCP Servers

          • MCP-OpenAPI

            rmasters
            -
            security
            A
            license
            -
            quality
            An MCP server that exposes HTTP methods defined in an OpenAPI specification as tools, enabling interaction with APIs via the Model Context Protocol.
            Last updated -
            2
            Python
            MIT License

          • Data.gov MCP Server

            melaodoidao
            A
            security
            A
            license
            A
            quality
            An MCP server that provides access to government datasets from Data.gov, enabling users to search packages, view dataset details, list groups and tags, and access resources by URL.
            Last updated -
            4
            7
            5
            JavaScript
            MIT License
            • Apple

          • CoinStats MCP Serverofficial

            CoinStatsHQ
            A
            security
            A
            license
            A
            quality
            MCP Server for the CoinStats API. Provides access to cryptocurrency market data, portfolio tracking, and news.
            Last updated -
            30
            17
            3
            TypeScript
            MIT License

          View all related MCP servers

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/amurshak/congressMCP'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server