tickertape-mcp
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., "@tickertape-mcp Screen US tech stocks with P/E under 25 and ROE above 15%"
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.
tickertape-mcp
An MCP server for screening and analyzing US stocks and ETFs using Tickertape's screener data, usable from any MCP client. Ask in plain language — "profitable US semiconductor stocks under 20× P/E with ROE above 20%" — and get a ranked, filterable table back.
Disclaimer. This is an unofficial project. It is not affiliated with, endorsed by, or supported by Tickertape or Smallcase. It calls an undocumented public API that may change or break at any time. Data is provided "as is", may be delayed or wrong, and is not investment advice. Only the US market is supported. Use at your own risk and review Tickertape's terms of service before use.
Features
screen_stocks— filter US stocks by any of 70+ metrics (valuation, growth, profitability, dividends, technicals, ownership, analyst ratings), plus sector / industry, with sorting and pagination.screen_etfs— screen ETFs by AUM, expense ratio, returns, yield, and fund category.list_filters— discover the available metrics, their units, value ranges, and the allowed sector/industry values.search_stocks— look up a ticker or company name.get_stock_details— a full metric snapshot for one stock or ETF, grouped by category, with a link to its Tickertape page.
It validates every metric name and value against the live filter catalog, so a typo gets a helpful "did you mean" instead of silently wrong results (see docs/api-notes.md for why that matters).
Related MCP server: Trading MCP Server
Install
Requires Node.js ≥ 18.
Claude Code (CLI)
claude mcp add tickertape -- npx -y tickertape-mcpClaude Desktop / Cursor
Add to your MCP config (claude_desktop_config.json, or Cursor's mcp.json):
{
"mcpServers": {
"tickertape": {
"command": "npx",
"args": ["-y", "tickertape-mcp"]
}
}
}Then restart the client. No API keys or account are needed.
Example prompts
"Screen US stocks: market cap over $10B, P/E under 25, ROE above 15%, in Technology. Sort by dividend yield."
"Find low-cost S&P 500 ETFs — expense ratio under 0.05%, sorted by AUM."
"What are NVDA's valuation and profitability metrics?"
"Which large-cap healthcare stocks are trading more than 30% below their 52-week high?"
Tools reference
Tool | Key parameters |
|
|
|
|
|
|
|
|
|
|
Metric names accept either a friendly alias (peRatioTtm, marketCap,
returnOnEquity, dividendYield, debtToEquity, expenseRatio, aum) or the raw
Tickertape label. Call list_filters to see them all. Premium metrics (e.g. forward
P/E, analyst estimates) can be shown as columns but not used to filter or sort — that
requires a Tickertape subscription.
How it works
On first use it fetches Tickertape's filter catalog (cached in memory) to build the metric list and aliases.
search_stocks/get_stock_detailsbuild a local index of the full universe the first time they run (a few seconds), cached on disk under~/.cache/tickertape-mcp/(override withTICKERTAPE_MCP_CACHE_DIR) for 24 hours.All output is compact markdown to keep token usage low.
See docs/api-notes.md for the reverse-engineered API contract.
Development
npm install
npm run typecheck # tsc --noEmit
npm test # vitest, uses fixtures (no network)
npm run build # bundle to dist/ with tsup
npm run smoke # live end-to-end checks against the real API (not in CI)Inspect the server interactively:
npm run build
npx @modelcontextprotocol/inspector node dist/index.jsProject layout
src/
index.ts entry — starts the stdio MCP server
server.ts tool registration and wiring
api.ts HTTP client for the Tickertape API
catalog.ts filter catalog: fetch, aliases, name/value resolution
match.ts builds a query body from tool input (the silent-failure guard)
universe.ts local ticker/name index with disk cache
format.ts markdown renderersPublishing checklist
npm run typecheck && npm test && npm run buildnpm pack --dry-run— confirm the tarball contains onlydist/,README.md,LICENSE.Test the bin:
npx ./tickertape-mcp-<version>.tgz.npm publish --access public(optionally--provenancefrom CI).
License
Available Tools
5 toolsget_stock_detailsGet stock/ETF detailsB
Get a detailed metric snapshot for a single US stock or ETF by ticker: valuation, growth, profitability, dividends, and more, grouped by category, with a link to its Tickertape page.
Inputs: ticker (required), metrics, asset_type.
list_filtersList screening filtersA
List the metrics and classifications available for screening US stocks and ETFs. Call this first to discover valid metric names (aliases), units, value ranges, and the allowed sector/industry values. Metric aliases returned here are the names to pass to screen_stocks/screen_etfs.
Inputs: search, category.
screen_etfsScreen US ETFsA
Screen US ETFs by AUM, expense ratio, returns, dividend yield, and other metrics. Use list_filters to discover metric names. Use categories to restrict to fund categories (e.g. "Large Blend", "Digital Assets").
Inputs: limit, offset, columns, filters, +3 more.
screen_stocksScreen US stocksA
Screen US stocks by fundamental and technical criteria (valuation, growth, profitability, dividends, technicals, etc.). Use list_filters to discover metric names. Numeric filters use min/max; sectors and industries use their own parameters. Results are sorted and paginated.
Inputs: limit, offset, columns, filters, +4 more.
search_stocksSearch stocks and ETFsA
Look up US stocks or ETFs by ticker symbol or company name. Returns matching tickers with their exchange and sector. The first call builds a local index and may take a few seconds.
Inputs: query (required), limit, asset_type.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: getting details for a single ticker, listing available screening metrics, screening ETFs, screening stocks, and searching by name or symbol. No overlap or ambiguity.
All tool names follow a consistent snake_case verb_noun pattern (get_stock_details, list_filters, screen_etfs, screen_stocks, search_stocks), making them predictable and easy to distinguish.
With 5 tools, the set is well-scoped for a stock screening and details API. It covers essential operations without being too sparse or overly numerous.
The tool surface covers the full expected workflow: discovering available filters, searching for tickers, screening stocks and ETFs separately, and retrieving detailed metrics for a single ticker. There are no obvious gaps for a read-only screening service.
Related MCP Connectors
US stock signals, screeners and options analysis over MCP. Not investment advice.
MCP server for Financial Modeling Prep API with 250+ financial data tools
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Stock analysis MCP: 38 indicators, 7 optimizers, 8 backtests, US + India sectors.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server providing comprehensive stock screening capabilities through Yahoo Finance. Enables LLMs to screen stocks based on technical, fundamental, and options criteria, with support for watchlist management and result storage.MIT
- AlicenseAqualityDmaintenanceA comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.1075MIT
- AlicenseAqualityCmaintenanceComprehensive MCP server for real-time stock, cryptocurrency, options, and fundamental analysis, including SEC filings and insider trading data.269 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server that provides access to screener.in financial data for Indian stocks, enabling queries for company info, financials, ratios, quarterly results, shareholding, and stock screening.MIT