streamable-httpupdated 1mo ago
Official lightweight clients for Bargo Free APIs.
What can you do with Bargo Congress Trades?
Bargo Free API Packages
Official lightweight clients for Bargo Free APIs.
Packages
packages/npm- npm package:@bargo-ai/congresspackages/python- Python package:bargo-congress
Both packages currently support the Bargo Congress Trades API.
API docs: https://www.bargo.ai/free-apis/congress
Quickstart
No key is required to try the API. A free key raises your quota — get one at https://www.bargo.ai/free-apis/dash
Python
pip install bargo-congress
from bargo_congress import BargoCongressClient
client = BargoCongressClient() # or BargoCongressClient(api_key="...")
# Recent disclosures for one ticker
data = client.ticker_trades("NVDA", limit=5)
for trade in data["trades"]:
print(trade["member"], trade["type"], trade["amount_range"], trade["transaction_date"])
# Filter across both chambers
senate_buys = client.trades(chamber="senate", type="buy", limit=10)
# Members, one member's disclosures, aggregates, dataset freshness
client.members(limit=50)
client.member("gilbert-cisneros")
client.stats()
client.health()
JavaScript / TypeScript
npm install @bargo-ai/congress
import { BargoCongressClient } from "@bargo-ai/congress";
const client = new BargoCongressClient({ apiKey: process.env.BARGO_API_KEY });
const { trades } = await client.tickerTrades("NVDA", { limit: 5 });
for (const t of trades) {
console.log(t.member, t.type, t.amount_range, t.transaction_date);
}
const senateBuys = await client.trades({ chamber: "senate", type: "buy", limit: 10 });
Also published on JSR as @bargo-ai/congress.
curl
curl "https://www.bargo.ai/free-apis/congress/v1/trades?ticker=NVDA&limit=5"
# With a free key
curl -H "X-Api-Key: $BARGO_API_KEY" \
"https://www.bargo.ai/free-apis/congress/v1/trades?chamber=senate&type=buy&limit=10"
Endpoints
| Endpoint | Returns |
|---|---|
GET /trades |
Disclosures, filterable by member, chamber, type, and date |
GET /trades/{ticker} |
Disclosures for a single ticker |
GET /members |
Members of Congress with disclosure activity |
GET /members/{member_slug} |
One member's disclosures |
GET /stats |
Aggregate trading statistics |
GET /health |
API status and dataset freshness |
Every trade includes member and chamber, ticker and asset description, transaction type, disclosed value range, transaction and disclosure dates, the official filing portal, and price-performance fields where available.
Agent Skill
bargo-congress-api— research and explain recent U.S. congressional stock-trade disclosures with Bargo's REST API, official clients, or hosted Congress MCP server.
MCP
A hosted Congress MCP server is available at
https://www.bargo.ai/free-apis/congress/mcp, authenticated with an X-Api-Key
header. See docs/mcp.md.
Limits
- Keyless: 30 requests/day and 100 rows/day per IP
- Free API key: 100 requests/day and 1,000 rows/day
- Page size: up to 100 rows keyless, up to 250 rows with a key
Quotas are reported per response in the X-RateLimit-* headers. Treat those as
authoritative.
Notes
Disclosures are filed under the STOCK Act and can legally appear up to roughly 45 days after a trade, so this is not a real-time feed. This is an independent, unofficial service, not affiliated with or endorsed by the U.S. House of Representatives, the U.S. Senate, or any member of Congress. Nothing here is investment advice.
Attribution
If you display Bargo Congress API data publicly, include visible attribution linking to Bargo.
Install
Add Bargo Congress Trades to your client. Pick the one you use.
claude mcp add --transport http bargo-congress-trades https://www.bargo.ai/free-apis/congress/mcpcodex mcp add bargo-congress-trades --url https://www.bargo.ai/free-apis/congress/mcp{
"mcpServers": {
"bargo-congress-trades": {
"url": "https://www.bargo.ai/free-apis/congress/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"bargo-congress-trades": {
"type": "http",
"url": "https://www.bargo.ai/free-apis/congress/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"bargo-congress-trades": {
"url": "https://www.bargo.ai/free-apis/congress/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"bargo-congress-trades": {
"serverUrl": "https://www.bargo.ai/free-apis/congress/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
Score
39 / 100
Incomplete
- Documentation22/25
- Maintenance19/25
- Trust6/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 25 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.1Latest | Jul 17, 2026 |
| 1.0.0 | Jul 17, 2026 |