io.github.forgemeshlabs/gov-transparency-mcp

gov-transparency-mcp

Watch the watchers. Congressional stock trades, federal contract awards, campaign finance, lobbying filings, and new regulations — nine MCP tools over official US government data, paid per call with x402 USDC on Base. No account, no API key, no subscription.

Commercial trackers sell congressional-trading data behind monthly subscriptions. Here it is per-call, in structured JSON, for agents: $0.005–$0.02 a query.

Tools

Tool	Price	What it returns
get_congress_trades	$0.02	US House member stock trades parsed from official STOCK Act filings — member, ticker, buy/sell, date, amount range. Filter by member, ticker, type, state, date window.
get_trade_filings	$0.01	The disclosure filing index — who filed trade reports and when, with official PDF links.
search_federal_contracts	$0.01	Federal contract awards won by any company — amounts, agencies, dates, descriptions.
get_contractor_profile	$0.01	Company → official federal recipient records with UEI and recent award totals.
get_candidate_money	$0.01	Campaign finance totals per candidate — receipts, spending, cash on hand, debts.
find_candidate	$0.005	Candidate name → official ids, party, office, committees.
search_lobbying	$0.01	Lobbying filings by client or firm — money, issues, named lobbyists.
watch_federal_register	$0.005	Newest regulations and notices matching any topic.
lookup_bill	$0.005	Official status of any bill in Congress.
get_endpoint_spec	free	Live schemas and worked examples for all nine routes.

Data sources

All official, all public domain: US House Clerk financial disclosures (parsed from the source PTR PDFs), USAspending.gov, the Federal Election Commission, the Senate Lobbying Disclosure Act database, the Federal Register, and Congress.gov. Trade disclosures lag transactions by up to 45 days — that is the law's reporting window, not a data delay. Current trade coverage: US House (Senate planned); paper-filed disclosures are indexed with PDF links but not parsed into rows.

Setup

{
  "mcpServers": {
    "gov-transparency": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/gov-transparency-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

WALLET_PRIVATE_KEY must be a dedicated low-balance wallet holding a small amount of USDC on Base mainnet — never your primary wallet. get_endpoint_spec works without one.

Optional env: GOV_TRANSPARENCY_BASE_URL (default https://x402.forgemesh.io), BASE_RPC_URL (default https://mainnet.base.org).

How payment works

Each call makes a normal HTTP request; the server answers 402 Payment Required with exact terms, the client signs a USDC transfer authorization (EIP-3009) and retries, and the settlement transaction hash comes back in the response under _payment. Atomic: no data without payment, no payment without data.

License

MIT — code only. The underlying government data is public domain.