com.potomacledger/trades

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Stock trades of U.S. Congress & executive-branch officials, with conflict flags. Read-only.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "trades": {
      "url": "https://potomacledger.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (6)

• search_trades read-only

  Search disclosed trades by person, ticker, branch, role (Senate/House/title), buy/sell, conflict flag, minimum dollar amount, and date window. Returns newest first.

  Parameters:

  • role — string — Chamber for Congress (Senate / House) or title substring for executive (President / Secretary / Administrator…), case-insensitive
  • type — string — Transaction direction: "buy", "sell" (includes partial sales), or "exchange". Case-insensitive.
  • limit — number — Max results per page (default 100, capped 500)
  • since — string — ISO date lower bound (disclosure/trade date)
  • until — string — ISO date upper bound
  • branch — string — Either "congress" or "executive" (case-insensitive)
  • offset — number — Skip the first N matching rows — pair with limit to page through large result sets
  • person — string — Member or official name (substring, case-insensitive)
  • ticker — string — Stock ticker, e.g. NVDA (case-insensitive)
  • conflict — boolean — Only trades flagged as a potential conflict
  • minAmount — number — Minimum upper-bound of the disclosed dollar range

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_person_trades read-only

  All disclosed trades for a named member of Congress or executive-branch official.

  Parameters:

  • name (required) — string
  • limit — number

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_ticker_activity read-only

  Which officials have disclosed trades in a given ticker.

  Parameters:

  • ticker (required) — string
  • limit — number

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• list_recent_trades read-only

  The most recently disclosed trades — newest first. Accepts the same branch/role/since/until/type filters as search_trades so an agent can scope to a chamber or window in one call.

  Parameters:

  • role — string — Chamber (Senate/House) or title substring
  • type — string — Direction: "buy", "sell", or "exchange" (case-insensitive)
  • limit — number
  • since — string — ISO date lower bound
  • until — string — ISO date upper bound
  • branch — string — Either "congress" or "executive" (case-insensitive)

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• list_conflicts read-only

  Trades flagged as a potential conflict (company sector overlaps the official's committee or agency). Accepts branch/role/since/until filters.

  Parameters:

  • role — string
  • limit — number
  • since — string
  • until — string
  • branch — string — Either "congress" or "executive" (case-insensitive)

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• aggregates read-only

  Summary stats over the filtered set: totals, branch split, most-active officials, top tickers bought/sold (per individual stock), top sectors bought/sold, potential conflict count, date range. Accepts the same branch/role/since/until/type/ticker filters as search — pass branch=congress + role=Senate + since=YYYY-MM-DD to scope. Use this BEFORE paginating search_trades when you only need ranked counts.

  Parameters:

  • role — string — Chamber (Senate/House) or title substring
  • type — string — Direction: "buy", "sell", or "exchange" (case-insensitive)
  • since — string
  • until — string
  • branch — string — Either "congress" or "executive" (case-insensitive)
  • ticker — string

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.