cdgmcp

A Model Context Protocol (MCP) server that exposes a Congress.gov-style legislative GraphQL API to MCP clients (such as VS Code, Claude Desktop, or other agents). It provides high-level tools for querying bills, actions, committee activities and cosponsors, plus a raw GraphQL escape hatch for advanced queries.

Features

Tools

The API is built with Hot Chocolate 16.2.0 and follows Relay conventions. The search tools are connection-based: each returns pageInfo.endCursor, which you can pass back as the after argument to fetch the next page.

Resources

Example questions it can answer

• What bills have been recently introduced in the House or Senate?
• What bills have passed the House or Senate and became law recently?
• What bills have been referred to the Commerce Committee recently?
• Of the bills referred to the Agriculture Committee, which cosponsors recur

across them?

Configuration

The GraphQL endpoint defaults to http://dotnet10-dev:5208/graphql/. Override it with the CDG_GRAPHQL_ENDPOINT environment variable.

Build & run

npm install
npm run build
npm start          # or: node dist/index.js

For development (no build step) use:

npm run dev        # runs src/index.ts via tsx

Use with VS Code

Add to your .vscode/mcp.json (or user mcp.json):

{
  "servers": {
    "cdgmcp": {
      "command": "node",
      "args": ["${workspaceFolder}/cdgmcp/dist/index.js"],
      "env": {
        "CDG_GRAPHQL_ENDPOINT": "http://dotnet10-dev:5208/graphql/"
      }
    }
  }
}

The server communicates over stdio.

This is supposed to be a standalone testing something, but I haven't seen it work.

HOST=0.0.0.0 npx @modelcontextprotocol/inspector node dist/index.js