[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [US Senate financial disclosure search](https://spiral.ai/integrations/opencode/us-senate-financial-disclosure-search)

# How to Use US Senate financial disclosure search in opencode

Finds public filings from senators, former senators, and Senate candidates, with report titles, received dates, and links. Use it to locate annual reports or transaction disclosures before reading their contents.

|  |  |
| --- | --- |
| Model | US Senate financial disclosure search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with US Senate financial disclosure search in opencode

- Use US Senate financial disclosure search to find Elizabeth Warren's annual filings received in 2025, then add their titles, received dates, and source links to this project's research index.
- Use US Senate financial disclosure search to find Ron Wyden's periodic transaction reports received in 2025 and create a source-linked filing list in this project's civic research viewer.
- Use US Senate financial disclosure search to find Sheldon Whitehouse's filings received in 2025 and add a report-type selector based on the returned filing titles.
- Use US Senate financial disclosure search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from US Senate financial disclosure search and tell me what changed since last week.

## How to set up US Senate financial disclosure search in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run US Senate financial disclosure search**: One request; the result comes back by polling or a webhook.

```bash
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": "efdsearch-senate-gov/financial-disclosures/search_reports",
    "input": {
      "acknowledge_use_prohibitions": false
    }
  }'
```

Then paste one of the prompts above: opencode finds US Senate financial disclosure search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## US Senate financial disclosure search tools and prices

- [US Senate financial disclosures (eFD) · Search reports](https://spiral.ai/tools/alexandria/efdsearch-senate-gov/financial-disclosures/search_reports) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort_by | first_name, last_name, filer, report, date_received | date_received | Sort column. Default date_received. |
| sort_dir | asc, desc | desc | Sort direction. Default desc (newest first). |
| last_name |  | — | Filer last name, prefix match as on the site (for example 'Warren'). |
| page_size | 1 to 100 | 25 | Rows per page, 1-100 (the site's maximum). |
| first_name |  | — | Filer first name, prefix match. |
| filer_types |  | — | Restrict to filer types (site codes 1, 4, 5). Empty or absent: all. |

## What can you do with US Senate financial disclosure search in opencode?

Build a public-interest research viewer that lets readers find Senate filings and inspect the underlying disclosures. Your coding agent can organize filing references and display electronic tables or scanned page links.

### Annual disclosure reporting

Find a senator's annual filing, then examine its asset and income sections for a public news article. Keep disclosed amount categories intact.

### Explain a reported transaction

Locate a senator's PTR and read the transaction table. Build a public-interest explanation around the reported asset, transaction date, transaction type, and amount category.

### Check an issuer mention

Find relevant Senate filings and inspect their contents for a named public company such as Microsoft. Use the actual disclosure to check an issuer mention before publishing it.

### Document a paper filing

Locate a scanned Senate disclosure and retrieve its page-image links. Prepare page-specific references for a public-interest article or research report.

### Explain a filing extension

Find an annual-report extension notice and read its new due date. Use the notice to explain the filing timeline in public coverage.

### Teach readers how disclosures differ

Locate an annual report and a PTR from the same senator, then compare their contents. Show why an annual asset disclosure and a transaction report answer different questions.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## US Senate financial disclosure search in other agents

- [Amp](https://spiral.ai/integrations/amp/us-senate-financial-disclosure-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/us-senate-financial-disclosure-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/us-senate-financial-disclosure-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/us-senate-financial-disclosure-search)
- [Cline](https://spiral.ai/integrations/cline/us-senate-financial-disclosure-search)
- [Codex](https://spiral.ai/integrations/codex/us-senate-financial-disclosure-search)
- [Cursor](https://spiral.ai/integrations/cursor/us-senate-financial-disclosure-search)
- [Devin](https://spiral.ai/integrations/devin/us-senate-financial-disclosure-search)
- [dots](https://spiral.ai/integrations/dots/us-senate-financial-disclosure-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/us-senate-financial-disclosure-search)
- [Gemini](https://spiral.ai/integrations/gemini/us-senate-financial-disclosure-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/us-senate-financial-disclosure-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/us-senate-financial-disclosure-search)
- [goose](https://spiral.ai/integrations/goose/us-senate-financial-disclosure-search)
- [Grok](https://spiral.ai/integrations/grok/us-senate-financial-disclosure-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/us-senate-financial-disclosure-search)
- [Hermes](https://spiral.ai/integrations/hermes/us-senate-financial-disclosure-search)
- [Instinct](https://spiral.ai/integrations/instinct/us-senate-financial-disclosure-search)
- [Manus](https://spiral.ai/integrations/manus/us-senate-financial-disclosure-search)
- [Muse](https://spiral.ai/integrations/muse/us-senate-financial-disclosure-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/us-senate-financial-disclosure-search)
- [n8n](https://spiral.ai/integrations/n8n/us-senate-financial-disclosure-search)
- [Notion](https://spiral.ai/integrations/notion/us-senate-financial-disclosure-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/us-senate-financial-disclosure-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/us-senate-financial-disclosure-search)
- [Raycast](https://spiral.ai/integrations/raycast/us-senate-financial-disclosure-search)
- [VS Code](https://spiral.ai/integrations/vscode/us-senate-financial-disclosure-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/us-senate-financial-disclosure-search)
- [Zapier](https://spiral.ai/integrations/zapier/us-senate-financial-disclosure-search)

## More opencode guides

- [US Senate financial disclosure report](https://spiral.ai/integrations/opencode/us-senate-financial-disclosure-report)
- [USAspending agency profile](https://spiral.ai/integrations/opencode/usaspending-agency-profile)
- [UNGM tender search](https://spiral.ai/integrations/opencode/ungm-tender-search)
- [USAspending award details](https://spiral.ai/integrations/opencode/usaspending-award-details)
- [UNGM tender notice details](https://spiral.ai/integrations/opencode/ungm-tender-notice-details)
- [USAspending award search](https://spiral.ai/integrations/opencode/usaspending-award-search)

## Questions about US Senate financial disclosure search in opencode

**Can opencode use US Senate financial disclosure search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run US Senate financial disclosure search like any built-in tool.

**How much does US Senate financial disclosure search cost in opencode?**

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

**Do I need an Alexandria account to use US Senate financial disclosure search in opencode?**

No. Spiral runs US Senate financial disclosure 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 US Senate financial disclosure search in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while US Senate financial disclosure search runs?**

US Senate financial disclosure search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**How far back does the Senate's online disclosure coverage go?**

The online publication requirement covers senator and Senate candidate reports filed since 2012. This is Senate disclosure coverage; it does not cover House filings.

**How soon after a transaction can it appear?**

PTRs have an outside filing deadline of 45 days after the transaction. The Senate then has up to 30 calendar days after filing to make a report public, so a newly published filing can describe older activity.

**Do reports stay online permanently?**

The Senate's instructions specify availability until six years after a senator leaves office. Candidate reports have a shorter window: one year after the individual is no longer a candidate.

**Does a PTR show every investment transaction?**

No. Transactions involving Excepted Investment Funds belong in annual or termination reports rather than PTRs; publicly traded mutual funds and ETFs generally qualify for that exception.

**Can I calculate exact current holdings from these reports?**

Disclosures can use amount categories instead of exact figures. Annual asset values are measured as of December 31 of the preceding year, so they do not establish current holdings.

