The River MCP Server

by theriver Your server? Claim it

answering

The River is answering right now. Last checked 13 min ago. It exposes 7 tools.

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

Uptime history 6 days of history

6 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

196 ms

Response time

average over 24h

open, no key

Access

streamable-http

What changed 6

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 8 October 2026. No other catalogue keeps this.

11 Oct a tool appeared compare_issuers

9 Oct a tool description was rewritten wallet_pnl

8 Oct a tool description was rewritten2 times that day strategy_link

8 Oct a tool appeared wallet_pnl

8 Oct a tool changed the parameters it asks for strategy_link

and 1 more, back to 8 October 2026

Nothing serious here today

Today is the operative word: we check The River every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 13 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add the-river --transport http https://theriver.markets/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "the-river": {
      "url": "https://theriver.markets/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.the-river]
url = "https://theriver.markets/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "the-river": {
      "url": "https://theriver.markets/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "the-river": {
      "url": "https://theriver.markets/mcp"
    }
  }
}

Available tools 7

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

wallet

wallet_holdings

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

wallet_pnl

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).

compare

compare_issuers

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.

fair

fair_value

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

stocks

list_stocks

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).

strategy

strategy_link

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.

trade

trade_link

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.

Endpoints

URL	Transport	State	Latency	Checked
https://theriver.markets/mcp	streamable-http	answering	254 ms	13 min ago

Alternatives to The River

same job, measured the same way

paired.exchange

by nirholas

Launch coins quoted in tokenized stocks on Robinhood Chain; the user signs at a launch link.

42 installs/wk 8 tools answering

Toys Hub

by toyshub

Browse Toys Hub: products, prices in ALL, stock, delivery and checkout links. Read-only, no sign-in.

7 tools answering

Stocks On Chain

by stocksonchain

Read-only tokenized stock data: issuers, chains, contract addresses and corporate actions.

8 tools answering

GPU Finder

by gpufinder

Live cloud GPU prices, stock and price history across 30+ providers. Read-only.

8 tools answering

Financial Data

by sebastianbo

Stock prices, financials, insider trades, institutional holdings for 141K+ companies

37 installs/wk local only

Tokenized Stocks & Agent Data (x402)

by fly-x402-accelerometer-feed

x402-paid data for agents: tokenized stocks on Base, Solana token verdicts, AI-progress readings

12 tools answering

ru-marketplace-mcp

by vladimir-human

Read-only MCP servers for Russian marketplaces: prices, stock, ratings, reviews, seller identity

local only

1845 Smoked Meat AI Gateway

by getbotlens

MCP gateway for 1845meat.com: products, prices, stock and cart links. Read-only, no auth.

11 tools answering

The River — questions

Answers built from our own checks of this server.

What can The River do?

It exposes 7 tools, read directly from the server on our last check. Among them: compare_issuers, fair_value, list_stocks, strategy_link, trade_link, wallet_holdings and 1 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is The River working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 196 ms. The bar chart above shows every period we have measured.

How do I connect The River?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does The River need an API key?

No. The River completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 7 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is The River?

It answers our handshake in 196 ms on average, which is faster than 64% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.