Wall Street Turkish MCP

npx add-mcp 'https://wallstreetturkish.com/api/mcp'

Guia do desenvolvedor MCP

O Wall Street Turkish oferece acesso somente leitura a partir de aplicações de IA para suas notícias publicadas, primeiras páginas de jornais registradas e dados registrados de módulos financeiros abertos neste site. Não é necessário login ou chave de API.

Servidor: https://wallstreetturkish.com/api/mcp

Este endereço é uma página de descrição via GET; chamadas MCP são feitas via POST sobre HTTP Streamable. GET não abre uma sessão SSE.

Como conectar?

Adicione o registro abaixo ao arquivo indicado, preservando suas configurações atuais. Os exemplos Claude e Gemini pertencem a clientes Code/CLI; Codex usa TOML.

Claude Code · JSON

.mcp.json

{
  "mcpServers": {
    "wallstreetturkish_com": {
      "type": "http",
      "url": "https://wallstreetturkish.com/api/mcp"
    }
  }
}

Gemini CLI · JSON

~/.gemini/settings.json

{
  "mcpServers": {
    "wallstreetturkish_com": {
      "httpUrl": "https://wallstreetturkish.com/api/mcp"
    }
  }
}

Cursor · JSON

.cursor/mcp.json

{
  "mcpServers": {
    "wallstreetturkish_com": {
      "url": "https://wallstreetturkish.com/api/mcp"
    }
  }
}

Codex · TOML

~/.codex/config.toml

[mcp_servers.wallstreetturkish_com]
url = "https://wallstreetturkish.com/api/mcp"

Ferramentas disponíveis

Apenas as ferramentas abertas neste site são listadas. Listas de notícias e busca de ativos retornam no máximo 50 resultados.

No histórico financeiro, podem ser usados 30, 90, 180, 365 ou 730 dias (padrão 365).

A comparação de fundos aceita 2–5 códigos diferentes; o período padrão é 1a, outros períodos são 1d, 1m, 1t, 3m, 6m, aa, 3a e 5a.

Ferramenta	Campos de entrada	Descrição
get_latest_news	limit, category	Busca as notícias mais recentes publicadas; filtro opcional por categoria pode ser usado.
get_article	id, slug	Busca o texto completo, data, categoria e informações de fonte da notícia pelo ID numérico da URL ou valor de slug.
search_news	query, limit, category	Pesquisa em títulos, descrições e palavras-chave de notícias; pode ser limitado por categoria.
get_category_news	category, limit	Lista as notícias mais recentes publicadas em uma categoria específica.
list_categories	language	Lista as categorias principais ativas com nomes e valores de slug.
search	query, limit	Retorna resultados curtos de notícias e IDs no formato article:123 que podem ser usados para busca.
fetch	id	Busca o texto completo e informações de fonte da notícia pelo ID de conteúdo obtido no resultado da busca.
search_financial_assets	query, type, limit	Busca ações e fundos ativos por código ou nome; lista apenas os tipos de ativos abertos neste site.
get_stock_quote	symbol	Busca o último preço registrado, variação e informações básicas; não há garantia de preço em tempo real.
get_stock_history	symbol, days	Busca apenas fechamentos reais registrados; não faz requisições a fontes externas nem gera preços sintéticos.
get_fund_details	code	Busca ficha do fundo, preço da cota, categoria, taxas, valor de risco e distribuição atual de ativos.
get_fund_history	code, days	Busca preços reais de cotas a partir de registros diários; não apresenta índice aproximado de retorno como preço.
get_fund_returns	code	Apresenta retornos registrados diários, semanais, mensais e de longo prazo em percentual.
compare_funds	codes, period	Compara 2–5 fundos diferentes no mesmo período; indica dados ausentes e diferenças de datas.
get_market_overview	limit	Busca índices abertos e listas de ações da rodada mais recente; seções fechadas não são chamadas.
get_stock_financials	symbol	Busca demonstrações financeiras registradas da empresa com períodos e unidades atuais; séries calculadas são indicadas separadamente.
list_company_disclosures	symbol, days, limit	Lista os avisos KAP registrados da empresa do mais recente para o mais antigo.
list_fund_leaders	period, direction, category, limit	Lista fundos ganhadores/perdedores por período; a permissão do módulo para a direção é verificada separadamente.
get_fund_holdings	code, limit	Busca as maiores posições em ações do fundo registradas; não afirma ser a carteira completa.
list_newspapers	query, limit	Lista nomes de jornais, valores de slug e primeiras/últimas datas de arquivo disponíveis; não garante a existência dos dias intermediários.
get_newspaper_headlines	date, limit, offset	Lista as primeiras páginas de jornais registradas do dia solicitado com fonte e links de imagem; se a data não existir, usa hoje em Istambul.
get_newspaper_front_page	newspaper, date	Busca a primeira página completa do jornal na data solicitada com imagem MCP e links. Não faz OCR/corte; em data ausente, não avança para outro dia.

Exemplos de chamadas

Liste as ferramentas:

curl -X POST 'https://wallstreetturkish.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Busque as cinco últimas notícias:

curl -X POST 'https://wallstreetturkish.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_latest_news","arguments":{"limit":5}}}'

Manchetes de jornais e primeiras páginas

Se nenhuma data for fornecida, usa-se hoje conforme Europe/Istanbul. As datas devem ser dias reais no formato YYYY-MM-DD; dias futuros não são aceitos. Pode-se usar o nome do jornal ou o slug. Listas diárias retornam no máximo 50 resultados, com offset de 0–1000. Em datas ausentes no arquivo, não se avança para outro dia; as primeiras/últimas datas de arquivo não garantem que todos os dias intermediários existam.

A chamada de um único jornal retorna a primeira página completa com conteúdo de imagem MCP e links de fonte/imagem. Não é feito OCR nem corte de notícias. Se a imagem grande não couber no limite de 2 MiB, tenta-se a imagem pequena disponível; o tempo total de leitura é de 10 segundos. Quando a imagem não pode ser anexada, retorna image_embedded: false e um aviso explicativo.

Manchetes do dia:

curl -X POST 'https://wallstreetturkish.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_headlines","arguments":{}}}'

Primeira página de hoje do jornal Akşam:

curl -X POST 'https://wallstreetturkish.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_front_page","arguments":{"newspaper":"Akşam"}}}'

Primeira página do jornal Akşam de 8 de novembro de 2024:

curl -X POST 'https://wallstreetturkish.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_front_page","arguments":{"newspaper":"Akşam","date":"2024-11-08"}}}'

2024-11-08 é um exemplo de chamada; não há garantia de que o arquivo exista nessa data.

Habilidades do agente

Índice de descoberta de habilidades deste site: /.well-known/agent-skills/index.json. Os arquivos de habilidade explicam como usar as ferramentas; este índice é uma superfície de descoberta oferecida pelo site.

• Pesquisa de notícias — Busca de notícias, obtenção de texto completo e indicação de data/fonte.
• Leitura de dados de bolsa — Leitura de dados de ações registrados preservando a distinção entre fonte e horário dos dados.
• Manchetes de jornais — Verificação do nome do jornal e da data solicitada, exibindo a imagem completa da primeira página do arquivo com fonte.
• Comparação de fundos — Comparação de fundos no mesmo período, preservando datas de dados e valores ausentes.

Regras e limites

• Gratuito. Não há plano de pagamento ou assinatura para MCP — /pricing.md. O aplicativo ao qual você se conecta pode ter suas próprias tarifas.
• Sem autenticação. Não é necessária conta, token ou chave de API — /auth.md.
• Atribuição obrigatória. Ao usar conteúdo do Wall Street Turkish, forneça link para o endereço permanente da notícia ou página de dados relevante.
• Dados de treinamento: ai-train=no — não queremos que o conteúdo seja incluído em conjuntos de dados de treinamento de modelos; robots.txt. Essa preferência não é garantia de que todos os clientes a cumprirão.
• Direitos de imagem. Imagens de notícias e primeiras páginas de jornais podem estar sujeitas a direitos autorais dos respectivos titulares. O acesso não concede licença de reutilização; preserve as informações de fonte/licença existentes e não presuma licenças não indicadas.
• Formato de erro: Erros de proteção HTTP retornam erro JSON-RPC com application/json; erros de ferramenta retornam com MCP isError. RFC 9457 application/problem+json não é usado.

Guia de uso completo: /AGENTS.md.

Segurança e limites

• 120 requisições/minuto por site + IP confiável; search e search_news juntos têm 60 chamadas/minuto. Ferramentas financeiras usam adicionalmente um limite comum de 30 chamadas/minuto; as três ferramentas de jornais usam um limite comum de 60 chamadas/minuto; a ferramenta de imagem de jornal único usa adicionalmente uma cota de 10 chamadas/minuto. Todas também contam contra a cota geral. Janelas fixas de minuto são aplicadas.
• Em resposta 429, aguarde o tempo de Retry-After. Os cabeçalhos X-RateLimit-Limit, Remaining e Reset indicam a cota geral. Se o serviço de cota Redis estiver inacessível, as ferramentas retornam 503 e Retry-After: 5.
• Limite de corpo de 256 KiB; batch e IDs de sessão MCP não são suportados. Se Origin estiver presente, deve pertencer ao mesmo site.
• JSON inválido retorna 400, Origin não permitido retorna 403, corpo excessivo retorna 413, ID de sessão retorna 404 e método HTTP não suportado retorna 405. Erros internos de ferramenta são explicados com MCP isError.
• Notícias excluídas, rascunhos, com data futura ou removidas da publicação neste site não são exibidas. Não há ferramentas para adicionar/editar/excluir conteúdo.

Como ler dados financeiros?

Chamadas financeiras apenas leem o banco de dados e o cache; não fazem requisições a provedores externos. Os dados têm atraso de 15 minutos. Os dados financeiros e conteúdos aqui apresentados não constituem recomendação de investimento. Preços não têm garantia de tempo real. retrieved_at é o horário de acesso, record_updated_at é o horário de atualização do registro, data_date, se presente, é a data real dos dados; não são intercambiáveis. Fonte e horário desconhecidos não são estimados. Números ausentes permanecem como null, e avisos são transmitidos junto com o resultado.

O histórico de preços contém apenas registros reais. Índices aproximados de retorno, dias preenchidos para lacunas ou preços sintéticos de hoje não são apresentados. Na comparação de fundos, considere as diferentes datas de dados; retornos passados não são garantia de retornos futuros. Ao transmitir conteúdo e dados, preserve o link da fonte.

Manifesto de descoberta MCP · llms.txt