onchain-stocks
A read-only MCP server for comparing tokenized stocks on Solana — which issuer's token is cheapest, what a given buy size costs, and how quotes move with size.
List covered tokens (
list_tokens): browse ~130 tokenized stocks across 85 companies without a key, filtered by ticker or company name, showing symbol, issuer, redeemability and mint.Quote buy sizes (
quote_sizes): price one token at up to 5 USDC amounts (default 1k/10k/50k) via Jupiter and see how much more each size pays per token than the smallest (slippage).Compare issuers (
compare_issuers): quote the same USDC buy (1–250,000, default 1,000) for every issuer's token of a stock (xStock, Ondo, Backpack…) and rank by price per token.With a tokens.xyz key (optional): also
search_stocks(real share price + age),quote_buy(all-in cost vs the real share) andrisk_score(0–100, grade A/B/C).Read-only by design: never trades, holds keys or gives advice; quotes are Jupiter routes, not fills, and real share prices freeze outside US trading hours.
Provides read-only tools for tokenized stocks on Solana, including listing covered tokens, comparing issuers for the same stock, and quoting buy sizes with slippage; optional keyed tools add stock search, all-in buy cost versus the real share price, and market risk scores.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@onchain-stocks Which tokenized Tesla is cheapest to buy for $1,000?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.

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-mcpOther 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 |
| Every token covered (about 130 across 85 stocks): issuer, redeemability, mint |
| 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 |
| 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 |
| Every token of a stock, plus the real share price and its age |
| The all-in cost of a buy against the real share price |
| 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, |
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 ( |
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 typecheckNot investment advice.
Available Tools
3 toolscompare_issuersARead-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_tokensARead-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_sizesARead-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
Scored across 3 tools
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.
All three tools follow a clean verb_noun snake_case pattern: list_tokens, compare_issuers, quote_sizes. The convention is uniform and immediately readable.
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.
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
Related MCP Connectors
Trade and invest in tokenized stocks: prices, holdings, P&L, unsigned market/limit/recurring trades.
Read-only Solana token safety checks: risk score, honeypot, liquidity lock, authorities, holders.
Swap quotes + unsigned txs on 8 EVM chains, plus Solana data: boards, candles, wallet PnL. No key.
Read-only tokenized stock data: issuers, chains, contract addresses and corporate actions.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceA non-custodial RWA service for AI agents on Solana that provides yield comparison, tokenized US-equity quotes, and ready-to-sign transactions.3MIT
- AlicenseAqualityDmaintenanceEnables 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.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceRead-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