`get_votes`

Pack: propublica-congress · Endpoint: https://gateway.pipeworx.io/propublica-congress/mcp

Get recent votes in a chamber for a specific year and month. Returns vote question, result, vote counts (yes/no), and related bill info. Example: get_votes(“senate”, 2024, 3).

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	ProPublica Congress API key
`chamber`	string	yes	Chamber: “senate” or “house”
`year`	number	yes	Year (e.g., 2024)
`month`	number	yes	Month (1-12)

Example call

Arguments

{
  "_apiKey": "your-propublica-congress-api-key",
  "chamber": "senate",
  "year": 2024,
  "month": 3
}

curl

curl -X POST https://gateway.pipeworx.io/propublica-congress/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_votes","arguments":{"_apiKey":"your-propublica-congress-api-key","chamber":"senate","year":2024,"month":3}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_votes', {
  "_apiKey": "your-propublica-congress-api-key",
  "chamber": "senate",
  "year": 2024,
  "month": 3
});

More examples

{
  "_apiKey": "your-propublica-congress-api-key",
  "chamber": "house",
  "year": 2024,
  "month": 1
}

Response shape

Always returns: chamber, year, month, count, votes

Field	Type	Description
`chamber`	string	Chamber (senate or house)
`year`	number	Year
`month`	number	Month
`count`	number	Number of votes
`votes`	array	List of votes

Full JSON Schema

{
  "type": "object",
  "properties": {
    "chamber": {
      "type": "string",
      "description": "Chamber (senate or house)"
    },
    "year": {
      "type": "number",
      "description": "Year"
    },
    "month": {
      "type": "number",
      "description": "Month"
    },
    "count": {
      "type": "number",
      "description": "Number of votes"
    },
    "votes": {
      "type": "array",
      "description": "List of votes",
      "items": {
        "type": "object",
        "properties": {
          "congress": {
            "type": [
              "number",
              "null"
            ],
            "description": "Congress number"
          },
          "chamber": {
            "type": [
              "string",
              "null"
            ],
            "description": "Chamber"
          },
          "session": {
            "type": [
              "number",
              "null"
            ],
            "description": "Session number"
          },
          "roll_call": {
            "type": [
              "number",
              "null"
            ],
            "description": "Roll call number"
          },
          "question": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vote question"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vote description"
          },
          "result": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vote result (Agreed to, Failed, etc.)"
          },
          "date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vote date"
          },
          "time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vote time"
          },
          "bill_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Related bill ID"
          },
          "bill_title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Related bill title"
          },
          "yes": {
            "type": [
              "number",
              "null"
            ],
            "description": "Yes votes"
          },
          "no": {
            "type": [
              "number",
              "null"
            ],
            "description": "No votes"
          },
          "not_voting": {
            "type": [
              "number",
              "null"
            ],
            "description": "Not voting"
          },
          "present": {
            "type": [
              "number",
              "null"
            ],
            "description": "Present votes"
          }
        }
      }
    }
  },
  "required": [
    "chamber",
    "year",
    "month",
    "count",
    "votes"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "propublica-congress": {
      "url": "https://gateway.pipeworx.io/propublica-congress/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_votes