The River

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

Tokenized US stocks onchain: listings, holdings, US prices, pre-filled trade links. Read-only.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "The River": {
      "url": "https://theriver.markets/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (7)

• list_stocks read-only

  Tokenized stocks listed on The River, with ticker, token symbol, issuer, chain and trade link. Filter by chain and/or a search query (ticker, symbol or name).

  Parameters:

  • chain — string
  • query — string — e.g. NVDA or nvidia

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

• trade_link read-only

  A pre-filled River trade link. A buy by ticker with usd (no address or chain) returns a best-price link that opens the cheapest issuer for the user. Give exactly one of usd (buy only, settlement stablecoin, up to 6 decimals) or qty (tokens, up to 18 decimals). The user reviews this on The River and signs in their own wallet; nothing happens until they do.

  Parameters:

  • side (required) — string
  • qty — ['string', 'number'] — Plain decimal, e.g. 50 or 0.25
  • usd — ['string', 'number'] — Plain decimal, e.g. 50 or 0.25
  • chain — string — When a ticker is listed on more than one chain
  • ticker — string — e.g. NVDA
  • address — string — Token address (instead of ticker)

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

• strategy_link read-only

  A pre-filled River strategy card link (Base, ST0x stocks). Cards and fields: dip (budget, start, step, rungs); peg (amount, discount, max); recurring (budget, days, hours, max); cycle (budget, buy, step, levels, repeat, top, sell); take-profit (amount, target); sell-ladder (amount, first, last, parts); stop (amount, trigger, floor); breakout (amount, trigger, max); spread (amount, spread, weekend); portfolio (amount, preset, stocks). Missing fields are left for the user. See https://theriver.markets/llms.txt for what each card does. The user reviews this on The River and signs in their own wallet; nothing happens until they do.

  Parameters:

  • card (required) — string
  • fields — object — Card fields as plain decimals, e.g. {"amount":"100","discount":"0.3"}
  • symbol — string — Ticker or token symbol, e.g. NVDA or wtNVDA (not for portfolio)

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

• wallet_holdings read-only

  Any wallet's stock-token and cash balances on every chain The River serves (public onchain data), plus its read-only River profile link.

  Parameters:

  • address (required) — string — 0x... wallet address

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

• wallet_pnl read-only

  Any wallet's profit and loss on Base, from public chain data. Wallet: its stock tokens since 1 Oct 2026, average cost from the wallet's own USDC trades on any venue (DEX or orderbook), realised and unrealised per token; transfers are never priced. Strategies: one row per strategy (live and cancelled orders it placed, incl. its RiverAccount): fills, USDC spent and received, tokens bought and sold, and P&L at today's prices (value now minus what was put in). Robinhood Chain is not counted yet (stated in notes).

  Parameters:

  • address (required) — string — 0x... wallet address

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

• compare_issuers read-only

  Where a tokenized stock is cheapest: each issuer's token (ST0x, Coinbase, Robinhood) priced per share for a $100 buy, against the stock's own price (US, or the home exchange's in dollars), with the gap in % and the lowest issuer. From quotes taken every 5 minutes (biggest stocks) or hourly; the time is in the answer. Not a live quote: for an executable best-price buy use trade_link with usd. Up to 12 tickers.

  Parameters:

  • tickers (required) — array

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

• fair_value read-only

  Last US market price and market status of listed stocks (what the tokens track). Up to 12 tickers.

  Parameters:

  • tickers (required) — array

  Hints: read-only yes · destructive not declared · idempotent not declared · 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.