TradeInsight

Servidor MCP TradeInsight

Um servidor Model Context Protocol que dá aos assistentes de IA acesso em tempo real aos dados do mercado de ações por meio da API TradeInsight.

Endpoint: https://api.tradeinsight.info/mcp
Protocolo: Streamable HTTP (JSON-RPC 2.0)

Ferramentas

get_price_history

Obtenha o histórico de preços OHLCV diário para um ticker de ação.

Parâmetro	Tipo	Obrigatório	Descrição
ticker	string	sim	Símbolo do ticker, ex.: "AAPL"
start_date	string	não	Data de início YYYY-MM-DD (padrão: 1 ano atrás)
end_date	string	não	Data de término YYYY-MM-DD (padrão: hoje)
limit	integer	não	Máximo de linhas 1–1000 (padrão 365)
adjusted	boolean	não	Usar preços ajustados por splits/dividendos (padrão true)

get_top_movers

Obtenha tickers classificados por volume, média móvel de 20 dias ou variação de preço.

Parâmetro	Tipo	Obrigatório	Descrição
sort_by	string	sim	"volume", "moving_average" ou "price_change"
limit	integer	não	Máximo de resultados 1–50 (padrão 10)

search_ticker

Pesquise tickers de ações por substring do nome da empresa.

Parâmetro	Tipo	Obrigatório	Descrição
query	string	sim	Substring do nome da empresa, ex.: "apple"
limit	integer	não	Máximo de resultados 1–50 (padrão 20)

Configuração

Obtenha uma chave de API

Cadastre-se em tradeinsight.info para obter sua chave de API.

Claude Desktop

Adicione a claude_desktop_config.json:

{
  "mcpServers": {
    "tradeinsight": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.tradeinsight.info/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Code

claude mcp add tradeinsight \
  --transport http \
  --url https://api.tradeinsight.info/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor / outros clientes MCP

Use o transporte streamable-http, URL https://api.tradeinsight.info/mcp e defina o cabeçalho Authorization: Bearer <key>.

Autenticação

Todas as solicitações exigem um token Bearer no cabeçalho Authorization:

Authorization: Bearer ti_xxxxxxxxxxxx

Solicitações sem uma chave válida retornam o erro JSON-RPC -32001 (Não autorizado).

Limites de taxa

Os limites de taxa são aplicados por chave de API e nível. Quando excedidos, o servidor retorna o erro JSON-RPC -32029 com um campo retry_after (segundos).

Códigos de erro

Código	Significado
-32700	Erro de análise — corpo JSON malformado
-32602	Parâmetros inválidos — campo obrigatório ausente ou valor incorreto
-32601	Método não encontrado — nome de método ou ferramenta desconhecido
-32001	Não autorizado — chave de API ausente ou inválida
-32029	Limite de taxa excedido — inclui data.retry_after (segundos)
-32002	Sem dados — ticker não encontrado
-32603	Erro interno

Cliente Python

Para acesso programático sem MCP, use a biblioteca Python tidata:

from tidata.tifinance import Ticker

t = Ticker("AAPL")
df = t.history(period="1y")
print(df.head())