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.
Prompts to try with US Senate financial disclosure search in opencode
Copy an example into opencode, or ask in your own words.
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
- 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.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- 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.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- 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
- Create an API key
In the console, under API keys.
- Run US Senate financial disclosure 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": "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.
US Senate financial disclosure search providers and prices
Spiral runs US Senate financial disclosure search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Acknowledge use prohibitions | on or off | Must be true: the caller affirms the prohibitions on obtaining and using financial disclosure reports in 5 U.S.C. app. 105(c) (no unlawful or commercial use other than by news media, no credit rating, no solicitation of money). The program submits the site's acknowledgement only on the caller's behalf after this affirmation. | |
| Sort by | first_name, last_name, filer, report, or date_received | date_received | Sort column. Default date_received. |
| Sort dir | asc or desc | desc | Sort direction. Default desc (newest first). |
| Page size | 1 to 100 | 25 | Rows per page, 1-100 (the site's maximum). |
Every API field of US Senate financial disclosures (eFD) · Search reports is on its tool page: open its card above.
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.
More on US Senate financial disclosure search and opencode
Overview
US Senate financial disclosure search in other agents
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.
Start using US Senate financial disclosure search in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


