Tapetide stock research MCP Server

Pesquise, filtre e analise todas as ações indianas (NSE/BSE) com 26 ferramentas que abrangem cotações, dados financeiros, indicadores técnicos, classificações de analistas, fluxos FII/DII, filtro com mais de 100 critérios e insights de mercado.

GitHub

141

Documentação

Tapetide stock research MCP Server — Dados NSE & BSE para Claude, ChatGPT e Cursor

O servidor MCP do mercado de ações indiano para NSE e BSE: 55 ferramentas para buscar, filtrar e analisar todas as 8.200+ ações listadas a partir de Claude, ChatGPT, Cursor, VS Code, Codex, Gemini CLI e qualquer cliente MCP.

Documentação • Início Rápido • Guias de Configuração do Cliente • 55 Ferramentas • Exemplos de Prompts • npm • PyPI

O Tapetide é um servidor MCP do mercado de ações indiano que fornece aos assistentes de IA dados ao vivo e estruturados sobre todas as empresas listadas na NSE e BSE, desde gigantes do Nifty 50 e Sensex até ações de SME. Conecte-o ao Claude, ChatGPT, Cursor, VS Code, Codex ou Gemini CLI e pergunte em linguagem simples por preços de ações, resultados financeiros trimestrais, um filtro de ações com 326 índices, indicadores técnicos, fluxos FII/DII, cadeias de opções e IV, arquivamentos corporativos, IPOs, negócios em bloco e o P&L da sua carteira.

Instalação em uma linha (Claude Code, com um token gratuito de tapetide.com/settings/tokens):

claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcp

Ou pule a instalação completamente e adicione a URL do servidor remoto https://mcp.tapetide.com/mcp no claude.ai, ChatGPT, Grok ou qualquer cliente que suporte MCP remoto. Você faz login com o Google.

55 ferramentas · 8.200+ ações NSE/BSE · Remoto (OAuth) ou local (npx / uvx) · Plano gratuito · Guias de configuração para 16 clientes

Funciona com

Guias de configuração passo a passo para cada cliente MCP importante:

Aplicativos de chat	Editores de código e IDEs	Agentes de terminal
Claude.ai	Cursor	Claude Code
ChatGPT	VS Code (GitHub Copilot)	Codex CLI
Claude Desktop	Windsurf	Gemini CLI
Grok	Kiro	OpenCode
	Zed	Command Code
	Cline
	Antigravity

Qualquer outro cliente que fale o Model Context Protocol também funciona, via HTTP remoto ou stdio local.

Início Rápido

Opção 1: MCP Remoto (Sem instalação — claude.ai, chatgpt.com, Grok, Gemini)

Adicione esta URL diretamente no seu aplicativo de chat de IA:

https://mcp.tapetide.com/mcp

A autenticação acontece automaticamente via Google OAuth. Nenhum token é necessário.

Opção 2: MCP Remoto com Token (Claude Code, VS Code, Kiro, Zed)

Para editores de código que suportam servidores MCP baseados em URL com cabeçalhos personalizados:

Obtenha um token gratuito em tapetide.com/settings/tokens
Adicione à sua configuração MCP:

{
  "mcpServers": {
    "tapetide": {
      "type": "url",
      "url": "https://mcp.tapetide.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Opção 3: MCP Local via npm (Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Kiro, OpenCode)

Para clientes MCP baseados em stdio. Sem necessidade de clonar ou compilar — executa via npx:

Obtenha um token gratuito em tapetide.com/settings/tokens
Adicione à sua configuração MCP:

{
  "mcpServers": {
    "tapetide": {
      "command": "npx",
      "args": ["-y", "tapetide-mcp"],
      "env": {
        "TAPETIDE_TOKEN": "your_token_here"
      }
    }
  }
}

Node.js 18+ é necessário para a opção local. Execute node --version para verificar.

Extensão Gemini CLI

gemini extensions install https://github.com/Tapetide-hq/nse-bse-indian-stock-market-data-mcp

Você será solicitado a fornecer seu token Tapetide na instalação.

Instalar como plugin do Claude Code

Este repositório também é um marketplace de plugin de um comando para Claude Code. Execute estes dois comandos dentro do Claude Code:

/plugin marketplace add Tapetide-hq/nse-bse-indian-stock-market-data-mcp
/plugin install tapetide-indian-stock-market@tapetide

No Claude Code 2.1.275 ou posterior, uma linha faz ambas as coisas:

/plugin install tapetide-indian-stock-market --marketplace Tapetide-hq/nse-bse-indian-stock-market-data-mcp

O plugin se conecta ao servidor remoto em https://mcp.tapetide.com/mcp, então não há nada para instalar localmente. Execute /mcp e escolha tapetide para fazer login com o Google na primeira vez.

Prefere um servidor stdio local com um token pessoal? Pule o plugin e adicione o pacote npm diretamente (obtenha um token gratuito):

claude mcp add tapetide -e TAPETIDE_TOKEN=your_token_here -- npx -y tapetide-mcp

Opção 4: MCP Local via Python (uvx / pip)

Mesma ponte, empacotada para Python 3.10+ — tapetide-mcp no PyPI (fonte):

{
  "mcpServers": {
    "tapetide": {
      "command": "uvx",
      "args": ["tapetide-mcp"],
      "env": {
        "TAPETIDE_TOKEN": "your_token_here"
      }
    }
  }
}

Como Funciona

┌─────────────────┐     stdio (JSON-RPC)     ┌──────────────────┐     HTTPS      ┌─────────────────────┐
│  AI Assistant   │ ◄──────────────────────► │  tapetide-mcp    │ ◄────────────► │  mcp.tapetide.com   │
│  (Claude, etc.) │                           │  (npm package)   │                │  (Cloudflare Worker) │
└─────────────────┘                           └──────────────────┘                └─────────────────────┘

O pacote npm é uma ponte stdio leve com zero dependências em tempo de execução. Ele:

Lê JSON-RPC do stdin, encaminha para o servidor MCP remoto do Tapetide, escreve respostas no stdout
Detecta automaticamente o enquadramento: Content-Length (VS Code, Claude Desktop) ou JSON delimitado por nova linha (Kiro, Claude Code)
Troca seu token de atualização por um token de acesso HMAC de 1 hora, com atualização automática antes da expiração
Lida com respostas SSE do servidor remoto
Identifica seu cliente MCP para o remoto via User-Agent, e ecoa a versão do protocolo negociada
Avisa no stderr quando o servidor limita a taxa de uma chamada, nomeando o atraso de nova tentativa
Reproduz o Mcp-Session-Id que o servidor emite em initialize em cada solicitação posterior, para que o remoto possa vincular as chamadas de uma sessão
Encaminha o tráfego de MCP Apps intacto — resources/list, resources/read e as dicas _meta.ui em get_price_history, market_heatmap e screen_stocks chegam ao seu cliente exatamente como o servidor os envia

Todas as 55 ferramentas e sua lógica são executadas no servidor remoto — o pacote npm é apenas a camada de transporte. Como ele encaminha JSON-RPC literalmente, as ferramentas enviadas no remoto ficam disponíveis imediatamente sem atualizar este pacote.

Autenticação

Método	Como funciona	Melhor para
Google OAuth	Login no navegador, atualização automática de token	Aplicativos de chat de IA (Claude.ai, ChatGPT, Grok, Gemini)
Token Pessoal (remoto)	Cabeçalho `Authorization: Bearer tpt_rt_...`	Editores de código com MCP baseado em URL (VS Code, Kiro, Zed)
Token Pessoal (local)	Variável de ambiente `TAPETIDE_TOKEN` via npx	Clientes MCP stdio (Cursor, Windsurf, Claude Desktop, Codex)

Gere um token pessoal gratuito em tapetide.com/settings/tokens. Funciona tanto para MCP remoto quanto local.

Ferramentas

Dica: peça ao seu assistente para chamar read_me primeiro. Ele retorna o guia completo da sessão — cada ferramenta por categoria, padrões de uso e as regras que o servidor espera que os clientes sigam.

Três ferramentas trazem uma visualização interativa para hosts que suportam MCP Apps (Claude, Claude Desktop, VS Code Copilot): get_price_history renderiza o gráfico de preço e volume, market_heatmap o treemap do índice, e screen_stocks a tabela de resultados ordenável. Hosts somente texto recebem o mesmo resultado JSON sem nada faltando.

🔍 Descoberta e Filtragem (5 ferramentas)

Ferramenta	Descrição
`search_stocks`	Resolve uma empresa para seu símbolo por nome, símbolo, código BSE ou ISIN — incluindo nomes de marca e aliases pós-renomeação (`Zomato` → `ETERNAL`). Filtre por setor/indústria.
`screen_stocks`	Filtro fundamental sobre 326 índices — PE, ROCE, crescimento de vendas, dívida/patrimônio, pontuação Piotroski. Sintaxe de consulta em linguagem simples com lógica AND/OR e comparações entre campos.
`screen_stocks_technical`	Filtro técnico em tempo real — RSI, MACD, cruzamentos SMA/EMA, Bandas de Bollinger, ADX, volume, momentum. Suporta `crosses_above`/`crosses_below`.
`get_screener_ratios`	Pesquise ou navegue pelo catálogo completo de 326 índices para obter nomes exatos de índices para uma consulta.
`get_trending_stocks`	Maiores altas, baixas e ações mais negociadas de hoje do Nifty 500.

📊 Análise de Empresas (9 ferramentas)

Ferramenta	Descrição
`get_company_profile`	Visão geral completa — setor, resumo do negócio, prós/contras, fundamentos, métricas de crescimento, cotação atual. Opcionalmente adicione técnicos (20+ indicadores), classificações de analistas e pares na mesma chamada.
`get_stock_quote`	Preço ao vivo — LTP, variação %, volume, capitalização de mercado, PE, PB, máxima/mínima de 52 semanas.
`get_batch_quotes`	Até 20 cotações de ações em uma única chamada.
`get_price_history`	OHLCV diário ou semanal com % de entrega. Até 2.000 sessões por chamada, com paginação para períodos anteriores.
`get_financials`	DRE trimestral + anual, balanço patrimonial, fluxo de caixa e índices. Cada período é carimbado com quando foi realmente publicado, para que backtests evitem viés de olhar para frente.
`get_shareholding`	Participações de promotores, FII, DII e público trimestre a trimestre.
`get_forecasts`	Estimativas de analistas para EPS, receita, EBITDA, lucro líquido, ROA e ROE contra os valores reais — para identificar surpresas de lucros.
`get_stock_events`	Notícias com classificação de sentimento, ações corporativas (dividendos, desdobramentos, bônus, AGMs) e arquivamentos (resultados, apresentações, transcrições de teleconferências, relatórios anuais).
`get_stock_ownership`	Histórico de dividendos com rendimentos + quais fundos mútuos detêm a ação e com que parcela do AUM.

🏛️ Dados de Mercado Amplos (11 ferramentas)

Ferramenta	Descrição
`get_market_pulse`	O resumo diário de relance — fluxos líquidos FII/DII, avaliações do Nifty 50 e India VIX em uma chamada.
`get_fii_dii_detail`	30 dias de fluxos diários do mercado à vista, OI longo/curto de participantes de F&O, agregados semanais/mensais/anuais, sequências de compra/venda, fluxos líquidos acumulados.
`get_fii_dii_flows`	Alias de `get_fii_dii_detail`.
`get_fpi_sectors`	Investimento FPI por setor — parcela do AUM, variação quinzenal, fluxo acumulado de 1 ano.
`get_market_news`	Notícias de mercado amplas em categorias com sentimento e símbolos relacionados.
`get_market_data`	Um despachante para sete feeds diários via `dataset`: `deals`, `fno_ban`, `deliveries`, `ipo`, `mtf`, `slbm`, `signals`.
`market_heatmap`	Cada constituinte de um índice com capitalização de mercado, PE, PB, retornos de 1 dia a 5 anos, volume, setor — 16 índices.
`market_valuations`	PE, PB e rendimento de dividendos do índice ao longo do tempo. Até 20 anos.
`get_india_vix`	O medidor de medo India VIX — nível mais recente, variação diária, histórico recente.
`get_index_performance`	Classifica ~140 índices NSE por retorno em semanas ou meses concluídos. Filtre por famílias setoriais, amplas, temáticas ou estratégicas — a resposta certa para "qual setor liderou no mês passado".
`get_index_history`	Série de níveis OHLC mais PE/PB/rendimento de dividendos para um único índice. O equivalente de índice de `get_price_history`.

🎲 Derivativos e Risco (5 ferramentas)

Ferramenta	Descrição
`get_option_chain`	Cadeia de opções de índice por strike com IV, Gregas completas, bid/ask, juros em aberto, max pain, PCR. NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY — um instantâneo de fim de dia carimbado.
`get_option_iv_history`	IV ATM sessão por sessão, rank de IV, percentil de IV, volatilidade realizada, PCR, max pain, skew de 25-delta para ~556 subjacentes, incluindo ações individuais.
`get_options_analytics`	Agregados mais recentes por vencimento — IV ATM, rank/percentil de IV, volatilidade realizada, PCR por OI e volume, max pain, skew, OI de calls/puts.
`get_promoter_pledge`	Percentual de penhor de ações de promotores por trimestre mais eventos de penhor/liberação — uma verificação padrão de bandeira vermelha de governança.
`get_credit_ratings`	Ações de classificação de crédito por agência com classificação, ação e perspectiva ao longo do tempo.

🔬 Pesquisa e Pontuação (4 ferramentas)

Ferramenta	Descrição
`get_stock_deals`	Divulgações em massa, em bloco, de insiders e de aquisições substanciais (SAST) por ação, com contraparte, lado, quantidade e valor.
`get_tapetide_score`	A pontuação Tapetide determinística de 0 a 100 para uma ação, com suas seis subpontuações de pilares, faixa, percentil, confiança dos dados e quaisquer limites de governança ou bandeiras vermelhas.
`screen_tapetide_scores`	Classifique e filtre o universo pontuado por faixa, faixa de tamanho, setor, janela de pontuação e confiança, com paginação por cursor.
`get_earnings_call_summary`	Resumo estruturado de transcrições recentes de teleconferências de resultados e apresentações a investidores — destaques, riscos, orientações e métricas principais.

📄 Texto de Arquivos (3 ferramentas)

Arquivos processados como texto — leia o relatório anual ou a transcrição em si, não apenas um resumo.

Ferramenta	Descrição
`list_company_documents`	Índice dos arquivos processados de uma empresa — transcrições de teleconferências, relatórios anuais, apresentações a investidores, documentos de IPO — com `doc_id`, período, número de páginas, o que está disponível para cada um e links para o PDF e o Markdown completo. Chame esta ferramenta primeiro.
`get_document_summary`	Resumo para investidores de um arquivo por `doc_id` (ou o mais recente de um `doc_type`): resumo, destaques, riscos, orientações da administração, métricas-chave. Limitado a 6 mil caracteres; `truncated: true` marca um resumo abreviado.
`read_document`	O texto em Markdown de um arquivo por `doc_id` e intervalo de páginas, com marcadores `<!-- page N -->` para citação. No máximo 12 páginas / 24 mil caracteres por chamada; o resultado nomeia as páginas retornadas e o `next_pages` para buscar.

⏳ Segurança de Ponto no Tempo e Backtest (5 ferramentas)

Ferramenta	Descrição
`get_adjustment_factors`	Linha do tempo de ajustes por desdobramentos e bônus para reconstruir preços brutos — além dos eventos de direitos e cisões que não possuem fator confiável.
`get_observation_status`	Motivo por dia de calendário para um preço estar presente ou ausente: negociado, fim de semana, feriado, pré-listagem, deslistado ou sem registro. Um dia ausente não é um retorno zero.
`get_index_membership_asof`	Uma ação estava em um índice em uma determinada data? Responde `present`, `uncertain`, `absent` ou `out_of_coverage` — construção de universo ciente do viés de sobrevivência.
`resolve_identifier_asof`	Mapeie um símbolo histórico ou ISIN para a empresa que o detinha em uma data, para arquivos antigos de participações e tickers reciclados.
`get_identifiers_asof`	A consulta inversa — sob qual símbolo e ISIN uma empresa negociava em um determinado momento.

💼 Portfólio (4 ferramentas)

Requer uma conta Tapetide conectada.

Ferramenta	Descrição
`get_user_portfolio`	Participações com preços em tempo real, P&L absoluto e percentual, valor investido, peso, setor, classe de capitalização de mercado.
`add_portfolio_stocks`	Adicione participações individualmente ou em lote, incluindo linhas extraídas de um CSV de corretora ou captura de tela (Zerodha, Groww, Angel One, Dhan, Upstox, 5Paisa, ICICI Direct, Kotak, HDFC Sky, Motilal Oswal). Duplicatas são mescladas com base no preço médio ponderado.
`update_portfolio_stock`	Atualize quantidade e preço médio após um reforço ou venda parcial.
`remove_portfolio_stocks`	Remova participações do portfólio.

👁️ Lista de Acompanhamento (3 ferramentas)

Requer uma conta Tapetide conectada.

Ferramenta	Descrição
`get_watchlist`	Cada ação acompanhada com setor e indústria.
`add_to_watchlist`	Acompanhe uma ou várias ações. Idempotente.
`remove_from_watchlist`	Deixe de acompanhar uma ou várias ações.

📖 Guia e Apelidos (6 ferramentas)

Ferramenta	Descrição
`read_me`	O guia completo da sessão — cada ferramenta por categoria, a regra de aviso da SEBI, o comportamento de prioridade ao portfólio, padrões de chamadas paralelas. Assistentes devem chamá-lo primeiro.
`scan_movers`	Apelido de `get_trending_stocks`.
`get_live_quote`	Apelido de `get_stock_quote`.
`get_stock_news`	Apelido de `get_stock_events` com `type: "news"`.
`get_corporate_actions`	Apelido de `get_stock_events` com `type: "corporate_actions"`.
`run_preset_screen`	Redirecionamento que aponta uma solicitação de tela predefinida para a ferramenta de triagem que pode realmente respondê-la.

Nomes de ferramentas aposentados

Esses nomes foram removidos. Chamar um deles retorna uma mensagem nomeando seu substituto, para que um cliente possa se recuperar na mesma rodada — mas novas integrações devem usar o substituto diretamente.

Aposentado	Substituto
`market_deals`	`get_market_data` com `dataset: "deals"`
`market_fno_ban`	`get_market_data` com `dataset: "fno_ban"`
`market_deliveries`	`get_market_data` com `dataset: "deliveries"`
`market_ipo`	`get_market_data` com `dataset: "ipo"`
`market_mtf`	`get_market_data` com `dataset: "mtf"`
`market_slbm`	`get_market_data` com `dataset: "slbm"`
`market_signals`	`get_market_data` com `dataset: "signals"`
`get_quant_signal`	`get_tapetide_score` (uma medição diferente, não uma renomeação)
`screen_by_quant_signal`	`screen_tapetide_scores` (uma medição diferente, não uma renomeação)

Exemplos de Prompts

Pesquisa de Ações

"Give me a complete analysis of Reliance Industries — financials, debt trend,
 analyst target price, and what mutual funds are holding it"

"Compare HDFC Bank and ICICI Bank — quarterly profit growth, ROE, shareholding
 changes, and analyst consensus"

"Pull the last 4 quarters of TCS financials — revenue growth, margin trend,
 and cash flow. How does it compare to Infosys?"

Triagem de Ações

"Find mid-cap stocks where FII holding increased last quarter, ROE > 15%,
 and RSI below 40 — accumulation candidates"

"Screen for stocks with MACD bullish crossover, volume 2x average, and
 within 10% of 52-week high"

"Which small-caps have debt-to-equity below 0.5, operating margin above 20%,
 and PE below 15?"

Fluxos Institucionais

"FIIs have been selling for 5 days — show me daily numbers and which sectors
 they're pulling out of"

"Compare FII vs DII flows for the last month with Nifty 50 PE — are we near
 a historical bottom?"

"Show F&O participant-wise open interest — are FIIs net long or short in
 index futures?"

Portfólio e Lista de Acompanhamento

"Add these to my portfolio: 10 RELIANCE at ₹1350, 50 TCS at ₹3800,
 25 HDFCBANK at ₹1650"

"I bought 10 more RELIANCE at ₹1400 — update my portfolio and show
 my new average cost"

"Which of my holdings are technically weak? Show RSI and MACD for each"

"Watch TATAMOTORS, MARUTI, M&M — compare their PE ratios and quarterly
 sales growth"

Derivativos e Volatilidade

"Is RELIANCE implied volatility high right now? Show IV rank and percentile
 versus realised vol over the last year"

"Show the NIFTY option chain around ATM — open interest by strike, max pain,
 and the put-call ratio"

"Which sectors led the last 3 completed weeks? Rank the sectoral indices"

Telas de Pontuação e Risco

"What's the Tapetide Score for TATASTEEL and why — break down the pillars"

"Show me Strong-band pharma stocks among large and mid caps"

"Any governance red flags on this stock? Check promoter pledge trend and
 recent credit rating actions"

Segurança de Backtest

"Was IDEA in the Nifty 500 on 2019-03-31? I need point-in-time membership,
 not today's list"

"This stock shows a 60% single-day move in 2022 — was that a split or a real
 return? Check the adjustment factors"

Briefing Diário do Mercado

"Full market briefing — FII/DII flows, F&O ban stocks, bulk deals above
 50 crores, top delivery stocks, and breakout signals"

"Is the market overvalued? Show Nifty 50 PE vs 5-year and 10-year averages"

"Show the Nifty 50 heatmap — which sectors dragged the index today?"

Cobertura de Dados

Categoria	O que está incluído
Ações	Todas as empresas listadas na NSE + BSE (~8.200 incluindo SME)
Dados de preço	OHLCV diário de até 2.000 dias + agregação semanal + % de entrega
Financeiros	P&L trimestral e anual, balanço patrimonial, fluxo de caixa, mais de 50 índices
Triagem	326 índices fundamentais + indicadores técnicos em tempo real + comparações entre campos
Técnicos	RSI, SMA, EMA, MACD, Bandas de Bollinger, ADX, ATR, Supertrend, Estocástico, CCI, pontos de pivô, 8 padrões de candlestick
Institucional	Fluxos de caixa diários de FII/DII, OI de participantes de F&O, alocação setorial de FPI, sequências de compra/venda
Dados de mercado	Negócios em massa/em bloco, banimento de F&O, IPOs, % de entrega, MTF, SLBM, mapas de calor, sinais
Índices	~140 índices NSE — histórico de níveis com PE/PB/DY, além de rankings de retorno semanal/mensal por setor, amplo, temático e por família de estratégia
Derivativos	Cadeias de opções de índices com IV e Gregas completas, OI, max pain, PCR; classificação/percentil de IV e histórico de volatilidade realizada para ~556 subjacentes, incluindo ações individuais; India VIX
Analistas	Consenso de compra/manutenção/venda + previsões de EPS/receita/EBITDA/ROE com realizados vs. estimativas
Propriedade	Padrões de participação acionária (trimestrais), histórico de dividendos, participações em nível de esquema de fundos mútuos
Grandes negociações	Divulgações em massa, em bloco, de insiders (pessoa designada) e SAST com contraparte e valor
Governança e risco	Histórico de penhor de ações do promotor e eventos, ações de classificação de crédito por agência com perspectiva
Pontuação	Tapetide Score — classificação determinística de 0 a 100 com seis subpontuações de pilares, faixa, percentil, confiança dos dados, limites de governança
Ponto no tempo	Fatores de ajuste por desdobramentos/bônus, status de observação por dia, participação em índice na data, resolução de símbolo/ISIN histórico — para backtests cientes do viés de sobrevivência
Notícias e eventos	Notícias com marcação de sentimento, ações corporativas, arquivos (relatórios anuais, transcrições de teleconferências), resumos de IA de chamadas de resultados e apresentações a investidores
Texto de arquivos	Transcrições de teleconferências, relatórios anuais, apresentações a investidores e documentos de IPO processados para Markdown com endereçamento por página, com resumos por documento e links de download de PDF/Markdown
Portfólio	Acompanhamento de P&L em tempo real, detalhamento por setor, importação de CSV de corretora (mais de 10 corretoras indianas)

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
`TAPETIDE_TOKEN`	Sim (local)	—	Token de API pessoal de tapetide.com/settings/tokens
`TAPETIDE_MCP_URL`	Não	`https://mcp.tapetide.com`	Substituir URL do servidor remoto
`TAPETIDE_DEBUG`	Não	`0`	Defina como `1` para registro de depuração em stderr

Limites de Taxa

Os limites são por conta Tapetide e idênticos nos três métodos de acesso (OAuth, token remoto e esta ponte npm) — eles seguem seu plano, não seu transporte.

Escopo	Plano gratuito	Planos pagos
Por dia	50 chamadas de ferramenta	Conforme seu plano, veja tapetide.com/pricing
Por mês calendário	Sem limite mensal	Conforme seu plano (ilimitado no enterprise)
Rajada	60 chamadas de ferramenta por minuto	60 chamadas de ferramenta por minuto

Apenas chamadas de ferramenta bem-sucedidas consomem cota. Tráfego de protocolo (initialize, tools/list) e chamadas negadas por rajada são gratuitos. As janelas diária e mensal são redefinidas nos limites de IST.

Quando um limite é atingido, o servidor responde com um resultado JSON-RPC normal contendo isError: true e uma mensagem nomeando o limite vinculante e seu horário de redefinição, para que seu assistente o repasse em vez de tentar novamente. As respostas carregam X-RateLimit-Reset, e as negações adicionam Retry-After. A cota numérica em si não é exposta como cabeçalho — verifique o uso atual em tapetide.com/settings/tokens.

Solução de Problemas

Problema	Solução
`TAPETIDE_TOKEN is not set` em uma chamada de ferramenta	A ponte inicia sem token para que as ferramentas possam ser listadas, mas as chamadas precisam de um. Adicione-o à seção `env` da sua configuração MCP
`Token refresh failed (401)`	Token expirado. Gere um novo em tapetide.com/settings/tokens
`Rate limit exceeded`	Aguarde a redefinição (mostrada no erro) ou verifique o uso em tapetide.com/settings/tokens
Servidor não responde	Garanta que o Node.js 18+ esteja instalado (`node --version`)
Primeira solicitação lenta	Normal — pré-autentica na inicialização. Solicitações subsequentes são rápidas
Erros de rede	Verifique a internet. A ponte precisa alcançar `mcp.tapetide.com`

Defina TAPETIDE_DEBUG=1 para registro detalhado em stderr.

Contribuindo

Issues e pull requests são bem-vindos. Para bugs, inclua a mensagem de erro e o nome/versão do seu cliente MCP.

Licença

MIT — livre para usar, modificar e distribuir.

_{Construído por Tapetide — a plataforma de pesquisa de ações com IA da Índia}