Skip to main content
Glama
onchain-stocks

onchain-stocks

by stephanet88

onchain-stocks-mcp

MCP server for tokenized stocks on Solana: which token is cheapest, what size costs you, and how a buy compares to the real share.

Read-only. It never trades, holds keys or gives advice.

Demo: tokenized Tesla from three issuers vs the real share price

The demo runs with a key, which adds the comparison to the real share. Without one, the tokens are compared with each other.

Install

No API key needed. Claude Code:

claude mcp add onchain-stocks -- npx -y onchain-stocks-mcp

Other clients (Claude Desktop, Cursor):

{
  "mcpServers": {
    "onchain-stocks": {
      "command": "npx",
      "args": ["-y", "onchain-stocks-mcp"]
    }
  }
}

Then ask: "Which tokenized Tesla is cheapest to buy for $1,000?"

Needs Node 22+.

Related MCP server: pegcheck

Tools

Without a key:

Tool

Returns

list_tokens

Every token covered (about 130 across 85 stocks): issuer, redeemability, mint

compare_issuers

The same buy quoted for every issuer's token of one stock (xStock, Ondo, Backpack...), ranked by price per token. With a key, also vs the real share price

quote_sizes

One token quoted at up to 5 sizes, and how much more each size pays per token than the smallest (slippage)

With a tokens.xyz key (TOKENS_API_KEY), three more:

Tool

Returns

search_stocks

Every token of a stock, plus the real share price and its age

quote_buy

The all-in cost of a buy against the real share price

risk_score

Market risk score 0 to 100, grade A/B/C

Add the key with -e TOKENS_API_KEY=your_key before -- in the Claude Code command, or as "env" in the JSON config.

Read the numbers right

  • Quotes are Jupiter routes, not fills, and not the issuer's own mint or redeem price. A token far above the others usually means a thin route.

  • Tokens of one stock can differ in what they represent (redeemability, dividends). Check redeemable.

  • Share prices are frozen outside US trading hours. Check sharePriceAgeMinutes.

Limits

Limit

Detail

Jupiter rate limit

The free quote API allows a short burst, then about one quote every 2 s per IP (measured 2026-11-01, scripts/probe-jupiter.ts). Each user runs the server locally, so limits are per user. Tools retry with backoff and cache identical quotes for 15 s

Real share price

Needs a tokens.xyz key. No free source exists: Pyth, the usual oracle, requires an API key since August 2026

Token list

Built in, refreshed weekly by a pull request. Tokens launched since the last release are missing until then

Chains

Solana only

Data sources

Data

Source

Buy quotes

Jupiter lite API (free, rate-limited: errors are returned, never guessed)

Built-in token list

api.tokens.xyz, refreshed weekly by a pull request (npm run catalog by hand)

Share prices, search, risk

api.tokens.xyz (key required)

Development

git clone https://github.com/stephanet88/onchain-stocks-mcp
cd onchain-stocks-mcp
npm install   # also builds dist/
npm test
npm run lint
npm run typecheck

Not investment advice.

Available Tools

3 tools
compare_issuersA
Read-only

Quote the same USDC buy for every issuer's token of one stock (e.g. xStock vs Ondo) and rank them by price paid per token. No API key needed.

Inputs: symbol (required), usd.

list_tokensA
Read-only

List the tokenized stocks this server covers without an API key: symbol, issuer, redeemability and mint. Filter by ticker or company name, or leave the query empty for all.

Inputs: query.

quote_sizesA
Read-only

Quote buying one token at several USDC sizes through Jupiter and show how much more each size pays per token than the smallest (slippage). No API key needed. The mint must come from list_tokens.

Inputs: mint (required), sizes.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 3 tools

    Disambiguation4/5

    Each tool targets a distinct axis: listing coverage, comparing issuers for one stock, and comparing buy sizes for one mint. The two quoting tools (compare_issuers vs quote_sizes) could be momentarily confused since both return USDC buy quotes, but the descriptions clearly separate issuer-comparison from size/slippage comparison.

    Naming Consistency5/5

    All three tools follow a clean verb_noun snake_case pattern: list_tokens, compare_issuers, quote_sizes. The convention is uniform and immediately readable.

    Tool Count4/5

    Three tools is on the lean side, but the domain (read-only tokenized-stock quoting) is narrow and each tool covers a genuinely different question. Nothing is redundant, though a single general-purpose quote tool would round it out.

    Completeness4/5

    The surface covers discovery (list_tokens with issuer/mint metadata), cross-issuer price comparison, and size-based slippage — the core quoting workflows for this domain. Minor gaps remain: no direct single-size quote endpoint (you must go through quote_sizes' relative output) and no sell-side or historical pricing.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to verify Robinhood Stock Token prices against real market prices before trading, providing a fair-price verdict based on onchain and reference data.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to research and trade tokenized pre-IPO stocks on Solana, including premium radar, PRE8 index, creation/redemption flows, split-aware Jupiter quotes, and basket building.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Read-only token intelligence for Robinhood Chain and Solana, providing safety checks, ticker resolution, deployer records, whale wallet tracking, and outcome measurements via a hosted MCP server.
      MIT