Spiral gives your agent every tool with one account. Browse the tools →

Muse Code · Lead Gen

How to Use U.S. House roll call search in Muse Code

Returns a paginated list of House roll calls for a congressional session, including bill references, vote questions, and results. Use it to discover the roll call numbers needed for a detailed vote lookup.

Prompts to try with U.S. House roll call search in Muse Code

Copy an example into Muse Code, or ask in your own words.

Use U.S. House roll call search to find H.R. 1 votes in the 119th Congress, first session, and add a results table to this project that excludes other bill numbers matched by the prefix.

U.S. House roll call searchMuse Code
Try asking
  • Use U.S. House roll call search to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from U.S. House roll call search and tell me what changed since last week.

  • Check U.S. House roll call search and summarize what you find in three bullet points.

  • Pull the newest data from U.S. House roll call search and give me the result as a table.

How to set up U.S. House roll call search in Muse Code

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Install Muse Code
    curl -fsSL https://dev.meta.ai/install.sh | bash
  2. Ask Muse to add the server

    Start muse and ask:

    Add the Spiral MCP server at https://api.spiral.ai/mcp
  3. Sign in

    In your terminal, run:

    muse mcp login spiral

Use the Spiral skill

  1. Send Muse Code this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run U.S. House roll call search

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "clerk-house-gov/legislative-votes/votes",
        "input": {
          "session": 1,
          "congress": 101
        }
      }'

Then paste one of the prompts above: Muse Code finds U.S. House roll call search on Spiral, shows the price and runs it.

U.S. House roll call search providers and prices

Spiral runs U.S. House roll call search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaLead Gen
U.S. House Clerk roll call votes and members · Votes
clerk-house-gov/legislative-votes/votes

Settings you can ask for

Ask Muse Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Session1 to 2

session

Congress101 to 200

Congress number; the listing covers the 101st Congress onwards.

Page1 to 1000

Page of 10 results, 1 by default. The output's continuation cursor is the next page number.

Roll1 to 9999

Only this roll call number.

Vote typeYea-And-Nay, Recorded Vote, 2/3 Yea-And-Nay, 2/3 Recorded Vote, 3/5 Yea-And-Nay, 3/5 Recorded Vote, or Quorum

vote_type

Every API field of U.S. House Clerk roll call votes and members · Votes is on its tool page: open its card above.

What can you do with U.S. House roll call search in Muse Code?

Build a House voting dashboard that connects roll call results with current representatives and their districts. Coding agents can turn the Clerk’s records into searchable tables and links between a representative’s position and the complete vote.

Local newsroom delegation coverage

Identify a state’s current delegation, add district and committee context, and review recent voting activity. Find the relevant roll calls, check individual positions, and explain the chamber’s result in a local legislative report.

Trade association legislative briefing

Prepare a factual briefing on House action affecting an industry. Combine the relevant delegation and committee assignments with recent voting records, bill roll calls, individual positions, and overall results.

Civics lesson with actual House records

Build a lesson around a state delegation and a real bill. Introduce the representatives and their committee work, review recent activity, then compare a specific representative’s position with the complete roll call.

Public legislative reporting dashboard

Populate a dashboard with a current delegation directory, representative profiles, recent voting records, searchable roll calls, and detailed results. Let readers move from a representative’s recorded position to the chamber-wide vote.

Check a claim about a legislative vote

Find a bill’s roll calls and verify the precise vote being discussed. Compare a named public official’s recorded position with the complete result before writing a correction or explanation.

Questions about U.S. House roll call search in Muse Code

Can Muse Code use U.S. House roll call search?

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run U.S. House roll call search like any built-in tool.

How much does U.S. House roll call search cost in Muse Code?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Muse Code plan is separate.

Do I need an Alexandria account to use U.S. House roll call search in Muse Code?

No. Spiral runs U.S. House roll call search on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up U.S. House roll call search in Muse Code?

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

Does Muse Code wait while U.S. House roll call search runs?

U.S. House roll call search runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.

How far back do the House Clerk’s online voting records go?

The online roll call archive begins in 1990, the second session of the 101st Congress. That historical coverage differs from the current roster and recent voting records.

How quickly does the House publish vote results?

House roll call tallies are posted online directly following the vote. This describes the House’s publication timing, not a guaranteed refresh interval for an API response.

Does the representative directory include historical rosters?

The documented roster covers current representatives. Use the roll call archive for historical votes rather than treating today’s roster as the House’s composition in an earlier Congress.

How many voting records appear on one page?

U.S. House roll call search returns 10 results per page. U.S. House representative voting history also returns 10 rows per page and continues with the next page number.

Why can a search for H.R. 1 return other bills?

The Clerk’s bill search matches prefixes. HR1 can also match HR1366, so check the complete bill number before using a result.

Get started

Start using U.S. House roll call search in Muse Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Muse Code:

Set up Muse Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options