_ registry / mcp streamable-http · checked 5h ago

the-river

https://theriver.markets

Registry code: b052877536e830f6

api record

Read-only tools for The River (https://theriver.markets). Never ask for a private key or seed phrase. To act, give the user a link from trade_link or strategy_link; they review it and sign in their own wallet. Full guide: https://theriver.markets/llms.txt

endpoint
https://theriver.markets/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is the-river live?
Yes — it answered the hub's last check (checked 5h ago). It answered 99% of checks over the last 30 days.
Is the-river free to use?
Partly — some of its tools are open, others need a key or payment.
What tools does the-river have?
15 tools: wallet_holdings, stop_recurring_buy, wallet_history, place_limit_order, fair_value, strategy_link, trade_link, wallet_pnl, ….
Is the-river safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
99.3%

90 days 99.3%· all time 99.3%

latency
749ms

last good check

priced tools
0

of 15 tools

_ answered our checks, 90 days 279 checks · signed record
  • degraded → live
  • live → degraded· timeout after 20000ms
  • degraded → live
  • live → degraded· timeout after 20000ms
  • unknown → live
_ what it is for
used for
  • list tokenized stocks
  • get a pre-filled trade link
  • check wallet stock-token holdings
takes → gives
text → data, web pages
tools
5 reads
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 15 tools
1 open1 auth-required 13 never probed 2 of 15 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • list_stocks reads open 23h ago

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

    mcp-tool

    {
      "type": "object",
      "properties": {
        "chain": {
          "enum": [
            "base",
            "robinhood"
          ],
          "type": "string"
        },
        "query": {
          "type": "string",
          "description": "e.g. NVDA or nvidia"
        }
      },
      "additionalProperties": false
    }
    arguments 17 lines
  • market_trade auth-required 23h ago

    Build a market buy or sell of a listed stock token on The River's best-execution route (the same route as the site's trade ticket: KyberSwap across DEX pools, else the token's listed pool). A buy says what it spends (spend, base units of USDC/USDG); a sell says what it sells (quantity, base units of the token). Returns the quote (price, minimum out after slippage, fee, venue) and an exact approve only when the allowance is short, then the swap. slippageBps defaults to 100 (1%). Returns unsigned transactions for the user to sign in their own wallet, in order; nothing is sent or signed here.

    mcp-tool

    {
      "type": "object",
      "required": [
        "chainId",
        "owner",
        "side",
        "token"
      ],
      "properties": {
        "side": {
          "enum": [
            "buy",
            "sell"
          ],
          "type": "string"
        },
        "owner": {
          "type": "string",
          "description": "0x... address"
        },
        "spend": {
          "type": "string",
          "description": "Buy only: base units to spend, e.g. \"25000000\" = 25 USDC"
        },
        "token": {
          "type": "string",
          "description": "The stock token, 0x..."
        },
        "chainId": {
          "enum": [
            8453,
            4663
          ],
          "type": "integer",
          "description": "8453 Base, 4663 Robinhood Chain"
        },
        "quantity": {
          "type": "string",
          "description": "Sell only: token base units to sell"
        },
        "slippageBps": {
          "type": "integer",
          "maximum": 500,
          "minimum": 1
        }
      },
      "additionalProperties": false
    }
    arguments 48 lines
  • wallet_holdings reads unknown 14h ago

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

    mcp-tool

    {
      "type": "object",
      "required": [
        "address"
      ],
      "properties": {
        "address": {
          "type": "string",
          "description": "0x... wallet address"
        }
      },
      "additionalProperties": false
    }
    arguments 13 lines
  • stop_recurring_buy unknown never probed

    One transaction: withdraw what the plan has not spent and what it bought to the wallet, then remove it. Returns unsigned transactions for the user to sign in their own wallet, in order; nothing is sent or signed here.

    mcp-tool

    {
      "type": "object",
      "required": [
        "chainId",
        "owner",
        "planId"
      ],
      "properties": {
        "owner": {
          "type": "string",
          "description": "0x... address"
        },
        "planId": {
          "type": "string",
          "description": "The plan's order hash, 0x... 32 bytes"
        },
        "chainId": {
          "enum": [
            8453,
            4663
          ],
          "type": "integer",
          "description": "8453 Base, 4663 Robinhood Chain"
        }
      },
      "additionalProperties": false
    }
    arguments 27 lines
  • wallet_history unknown 14h ago

    Any wallet's stock-token buys, sells and transfers on Base and Robinhood Chain since 1 Oct 2026, newest first: token, amount (base units), dollars paid or received, price, transaction.

    mcp-tool

    {
      "type": "object",
      "required": [
        "owner"
      ],
      "properties": {
        "owner": {
          "type": "string",
          "description": "0x... address"
        }
      },
      "additionalProperties": false
    }
    arguments 13 lines
  • place_limit_order unknown never probed

    Build a limit buy or sell of a listed stock token against USDC (Base) or USDG (Robinhood Chain): an exact approve only when the allowance is short, then deposit + place. amount = the stock quantity in base units (18 decimals for wt tokens); price = USDC/USDG per 1 token. No fee to place. Returns unsigned transactions for the user to sign in their own wallet, in order; nothing is sent or signed here.

    mcp-tool

    {
      "type": "object",
      "required": [
        "chainId",
        "owner",
        "sellToken",
        "buyToken",
        "amount",
        "price"
      ],
      "properties": {
        "owner": {
          "type": "string",
          "description": "0x... address"
        },
        "price": {
          "type": "string",
          "description": "Plain decimal, e.g. \"182.5\""
        },
        "amount": {
          "type": "string",
          "description": "Base units, e.g. \"1500000000000000000\""
        },
        "chainId": {
          "enum": [
            8453,
            4663
          ],
          "type": "integer",
          "description": "8453 Base, 4663 Robinhood Chain"
        },
        "buyToken": {
          "type": "string",
          "description": "0x... address"
        },
        "sellToken": {
          "type": "string",
          "description": "0x... address"
        }
      },
      "additionalProperties": false
    }
    arguments 42 lines
  • fair_value reads unknown 14h ago

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

    mcp-tool

    {
      "type": "object",
      "required": [
        "tickers"
      ],
      "properties": {
        "tickers": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 12,
          "minItems": 1
        }
      },
      "additionalProperties": false
    }
    arguments 17 lines
  • strategy_link reads unknown 5h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "card"
      ],
      "properties": {
        "card": {
          "enum": [
            "dip",
            "peg",
            "recurring",
            "cycle",
            "take-profit",
            "sell-ladder",
            "stop",
            "breakout",
            "spread",
            "portfolio"
          ],
          "type": "string"
        },
        "fields": {
          "type": "object",
          "description": "Card fields as plain decimals, e.g. {\"amount\":\"100\",\"discount\":\"0.3\"}",
          "additionalProperties": {
            "type": [
              "string",
              "number"
            ]
          }
        },
        "symbol": {
          "type": "string",
          "description": "Ticker or token symbol, e.g. NVDA or wtNVDA (not for portfolio)"
        }
      },
      "additionalProperties": false
    }
    arguments 38 lines
  • trade_link reads unknown 5h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "side"
      ],
      "properties": {
        "qty": {
          "type": [
            "string",
            "number"
          ],
          "description": "Plain decimal, e.g. 50 or 0.25"
        },
        "usd": {
          "type": [
            "string",
            "number"
          ],
          "description": "Plain decimal, e.g. 50 or 0.25"
        },
        "side": {
          "enum": [
            "buy",
            "sell"
          ],
          "type": "string"
        },
        "chain": {
          "enum": [
            "base",
            "robinhood"
          ],
          "type": "string",
          "description": "When a ticker is listed on more than one chain"
        },
        "ticker": {
          "type": "string",
          "description": "e.g. NVDA"
        },
        "address": {
          "type": "string",
          "description": "Token address (instead of ticker)"
        }
      },
      "additionalProperties": false
    }
    arguments 46 lines
  • wallet_pnl unknown 5h ago

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

    mcp-tool

    {
      "type": "object",
      "required": [
        "address"
      ],
      "properties": {
        "address": {
          "type": "string",
          "description": "0x... wallet address"
        }
      },
      "additionalProperties": false
    }
    arguments 13 lines
  • cancel_limit_order unknown never probed

    One transaction: withdraw what the order still holds (vaults no other live order uses) to the wallet, then remove the order. Returns unsigned transactions for the user to sign in their own wallet, in order; nothing is sent or signed here.

    mcp-tool

    {
      "type": "object",
      "required": [
        "chainId",
        "owner",
        "orderHash"
      ],
      "properties": {
        "owner": {
          "type": "string",
          "description": "0x... address"
        },
        "chainId": {
          "enum": [
            8453,
            4663
          ],
          "type": "integer",
          "description": "8453 Base, 4663 Robinhood Chain"
        },
        "orderHash": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
    arguments 26 lines
  • withdraw unknown never probed

    Withdraw an exact amount (base units) or everything (max: true) from one of the owner's orderbook vaults to their wallet. Returns unsigned transactions for the user to sign in their own wallet, in order; nothing is sent or signed here.

    mcp-tool

    {
      "type": "object",
      "required": [
        "chainId",
        "owner",
        "token",
        "vaultId"
      ],
      "properties": {
        "max": {
          "type": "boolean"
        },
        "owner": {
          "type": "string",
          "description": "0x... address"
        },
        "token": {
          "type": "string",
          "description": "0x... address"
        },
        "amount": {
          "type": "string",
          "description": "Base units"
        },
        "chainId": {
          "enum": [
            8453,
            4663
          ],
          "type": "integer",
          "description": "8453 Base, 4663 Robinhood Chain"
        },
        "vaultId": {
          "type": "string",
          "description": "0x... 32-byte vault id"
        }
      },
      "additionalProperties": false
    }
    arguments 39 lines
  • list_limit_orders unknown never probed

    A wallet's limit orders on one chain: status (open, partially_filled, filled, cancelled), filled and remaining amounts in base units.

    mcp-tool

    {
      "type": "object",
      "required": [
        "chainId",
        "owner"
      ],
      "properties": {
        "owner": {
          "type": "string",
          "description": "0x... address"
        },
        "chainId": {
          "enum": [
            8453,
            4663
          ],
          "type": "integer",
          "description": "8453 Base, 4663 Robinhood Chain"
        }
      },
      "additionalProperties": false
    }
    arguments 22 lines
  • start_recurring_buy unknown never probed

    Build a recurring buy of a listed ST0x stock token: the whole budget is deposited now and spent over days (or hours) in buys of at least $25, each an auction that starts near the price now and never pays more than maxPrice (settlement per 1 token). No fee to start or stop. Returns unsigned transactions for the user to sign in their own wallet, in order; nothing is sent or signed here.

    mcp-tool

    {
      "type": "object",
      "required": [
        "chainId",
        "owner",
        "token",
        "budget",
        "maxPrice"
      ],
      "properties": {
        "days": {
          "type": "integer",
          "maximum": 365,
          "minimum": 1
        },
        "hours": {
          "type": "integer",
          "maximum": 72,
          "minimum": 2
        },
        "owner": {
          "type": "string",
          "description": "0x... address"
        },
        "token": {
          "type": "string",
          "description": "The stock token, 0x..."
        },
        "budget": {
          "type": "string",
          "description": "Base units of USDC/USDG, e.g. \"100000000\" = 100"
        },
        "chainId": {
          "enum": [
            8453,
            4663
          ],
          "type": "integer",
          "description": "8453 Base, 4663 Robinhood Chain"
        },
        "maxPrice": {
          "type": "string",
          "description": "Plain decimal, settlement per 1 token"
        }
      },
      "additionalProperties": false
    }
    arguments 47 lines
  • compare_issuers unknown 23h ago

    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.

    mcp-tool

    {
      "type": "object",
      "required": [
        "tickers"
      ],
      "properties": {
        "tickers": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 12,
          "minItems": 1
        }
      },
      "additionalProperties": false
    }
    arguments 17 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id b052877536e830f6.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/b052877536e830f6/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/b052877536e830f6/badge.svg)](https://brick.blue/agent/b052877536e830f6?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.