Connection guide & tool reference
Connect your AI assistant to NSE and BSE stocks. Research companies, screen the market, explore options and keep track of your portfolio.
Google sign-in or personal token · Free tier available
01 / Connect
Choose your connection method. You’ll use the same account and plan whichever way you connect.
Add the server through your assistant’s custom connector or app settings.
https://mcp.tapetide.com/mcp.Add the server, then complete authentication in your agent’s MCP controls.
/mcp to authenticate Tapetide. In Codex, run the login command shown below. Complete Google sign-in when prompted.opencode mcp add and choose Remote.claude mcp add --transport http tapetide https://mcp.tapetide.com/mcpcodex mcp add tapetide --url https://mcp.tapetide.com/mcp
codex mcp login tapetidecmd mcp add --transport http tapetide https://mcp.tapetide.com/mcp{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"tapetide": {
"type": "remote",
"url": "https://mcp.tapetide.com/mcp",
"enabled": true
}
}
}Merge the matching configuration into your editor’s MCP settings.
{
"mcpServers": {
"tapetide": {
"url": "https://mcp.tapetide.com/mcp"
}
}
}{
"servers": {
"tapetide": {
"type": "http",
"url": "https://mcp.tapetide.com/mcp"
}
}
}{
"context_servers": {
"tapetide": {
"url": "https://mcp.tapetide.com/mcp"
}
}
}{
"mcpServers": {
"tapetide": {
"serverUrl": "https://mcp.tapetide.com/mcp"
}
}
}No browser step. Use a personal token as a bearer header — the free-tier limits are identical to OAuth.
{
"mcpServers": {
"tapetide": {
"type": "http",
"url": "https://mcp.tapetide.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}For clients that run a local command. Install Bun and Node.js 18 or later; the helper connects to this same server.
cline_mcp_settings.json. Gemini CLI: ~/.gemini/settings.json.{
"mcpServers": {
"tapetide": {
"command": "bunx",
"args": ["tapetide-mcp"],
"env": {
"TAPETIDE_TOKEN": "YOUR_TOKEN"
}
}
}
}“Use Tapetide to show Reliance’s latest price and when it was updated.”
02 / Tool reference
The full registered catalog, including the setup guide and compatibility names. Open a category to see each tool’s purpose.
Tool calls require authentication. 7 tools manage your own portfolio and watchlist. Ask your assistant to read read_me first for usage guidance.
search_stocksscreen_stocksscreen_stocks_technicalget_screener_ratiosget_trending_stocksget_company_profileget_stock_quoteget_batch_quotesget_financialsget_shareholdingget_forecastsget_stock_eventsget_stock_ownershipget_price_historyget_market_pulseget_fii_dii_detailget_fii_dii_flowsCompatibility aliasget_fpi_sectorsget_market_newsget_market_datamarket_heatmapmarket_valuationsget_india_vixget_index_performanceget_index_historyget_option_chainget_option_iv_historyget_options_analyticsget_promoter_pledgeget_credit_ratingsget_stock_dealsget_tapetide_scorescreen_tapetide_scoresget_earnings_call_summarylist_company_documentsget_document_summaryread_documentget_adjustment_factorsget_observation_statusget_index_membership_asofresolve_identifier_asofget_identifiers_asofget_user_portfolioadd_portfolio_stocksupdate_portfolio_stockremove_portfolio_stocksget_watchlistadd_to_watchlistremove_from_watchlistread_meSetup guidescan_moversCompatibility aliasget_live_quoteCompatibility aliasget_stock_newsCompatibility aliasget_corporate_actionsCompatibility aliasrun_preset_screenRedirect03 / Data coverage
Use the returned dates and coverage notes. Availability and freshness vary by company, dataset and period.
Index option chains are end-of-day snapshots. Historical research tools report uncertainty and gaps; they do not run trading-strategy backtests.
04 / First questions
Your assistant chooses the tools. Include the company, period and metrics you want to compare.
Start with the free tier
Failed calls, protocol requests and read_me don’t use your allowance. A batch of up to 20 quotes counts as one successful call. Daily limits reset in IST.
05 / Integration details
Streamable HTTP with OAuth, PKCE and dynamic client registration. Personal bearer tokens are also supported.
Supported protocol revisions: 2024-11-05, 2025-03-26, 2025-11-25.
/mcp//health/.well-known/oauth-authorization-server/.well-known/oauth-protected-resource/.well-known/openid-configuration/register/authorize · /callback · /tokenFor an assistant-readable guide, use llms.txt. Initialize and tool calls require authentication; tool discovery and ping are public.
A few useful answers
Setup, access and data limits.
It connects an AI assistant to Indian stock market data and your Tapetide portfolio and watchlist. The catalog currently exposes 55 tool names, including a guide and compatibility aliases. This page is the connection and tool reference; the product overview shows example research workflows.
Model Context Protocol is an open standard for connecting AI assistants to external data and tools. One protocol instead of a bespoke integration per assistant, which is why the same server works in Claude, ChatGPT, Cursor, VS Code and the rest.
The free tier includes 50 successful tool calls per IST day and up to 1,000 per month. The limits are the same with Google sign-in, a personal token or the local helper. For higher allowances, see current plans.
Tool use requires a connected account. Sign in with Google through OAuth, or send a personal token as an Authorization: Bearer header. The local helper uses TAPETIDE_TOKEN. All methods use the same account and plan. Create tokens in your Tapetide account.
Claude.ai, Claude Desktop, ChatGPT, Grok, Claude Code, Codex, OpenCode, Command Code, Cursor, VS Code, Kiro, Zed, Antigravity, Windsurf, Cline, Gemini CLI, and any other client that speaks MCP. Web assistants paste the URL into their connector screen; editors and CLIs add it to a config file.
Remote connections use the server URL directly. If you choose the local helper shown here, install Bun and Node.js 18 or later and configure it with your personal token. The helper still needs an internet connection to Tapetide.
Quotes, financial statements, market feeds and derivatives have different observation times. Check the dates returned with the data. Index option chains are end-of-day snapshots, and longer options-history ranges use weekly bars. Coverage can differ between companies and periods.
A successful tool call counts once, including a batch of up to 20 quotes. Failed calls, protocol requests and the read_me guide do not consume your allowance. A separate per-minute cap limits bursts. When a limit is reached, the response tells your assistant when to retry.
A REST API hands you endpoints and leaves the orchestration to you. Here the assistant picks the tools, runs the independent ones in parallel, and joins the results — a comparison across two companies can pull profiles, financials, technicals and ratings in a single turn without any code.
No. It provides price history and tools for historical research, including past index membership, stock identifiers and adjustment factors. Those responses describe coverage and uncertainty; you need a separate backtesting system to run a strategy.
Yes. After connecting your account, you can ask your assistant to read, add, update or remove holdings and followed stocks. These tools manage records in Tapetide; they do not place trades with a broker.
No. It is data and analysis. Tapetide is not a SEBI-registered research analyst or investment adviser, and the server instructs connected assistants to say so on any response that carries an investment opinion.