Manşet Etkisi MCP

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

Guia do desenvolvedor MCP

O Manşet Etkisi oferece acesso somente leitura, a partir de aplicações de IA, às notícias publicadas, às primeiras páginas de jornais arquivadas e aos dados registrados dos módulos financeiros abertos neste site. Não é necessário login ou chave de API.

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

Este endereço é uma página de descrição via GET; as chamadas MCP são feitas via POST sobre Streamable HTTP. O 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 referem-se a clientes Code/CLI; o Codex usa TOML.

Claude Code · JSON

.mcp.json

{
  "mcpServers": {
    "mansetetkisi_com": {
      "type": "http",
      "url": "https://mansetetkisi.com/api/mcp"
    }
  }
}

Gemini CLI · JSON

~/.gemini/settings.json

{
  "mcpServers": {
    "mansetetkisi_com": {
      "httpUrl": "https://mansetetkisi.com/api/mcp"
    }
  }
}

Cursor · JSON

.cursor/mcp.json

{
  "mcpServers": {
    "mansetetkisi_com": {
      "url": "https://mansetetkisi.com/api/mcp"
    }
  }
}

Codex · TOML

~/.codex/config.toml

[mcp_servers.mansetetkisi_com]
url = "https://mansetetkisi.com/api/mcp"

Ferramentas disponíveis

Somente 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 de 2 a 5 códigos diferentes; o período padrão é 1a, e os demais períodos são 1d, 1h, 1m, 3m, 6m, aa, 3a e 5a.

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

Exemplos de chamadas

Listar ferramentas:

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

Buscar as cinco notícias mais recentes:

curl -X POST 'https://mansetetkisi.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 AAAA-MM-DD; datas futuras não são aceitas. Pode-se usar o nome do jornal ou o slug. As listas diárias aceitam no máximo 50 resultados e deslocamento de 0 a 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 origem/imagem. Não é feito OCR nem recorte 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://mansetetkisi.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://mansetetkisi.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://mansetetkisi.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 exista arquivo 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 — Buscar notícias, obter o texto completo e indicar data/origem.
• Leitura de dados de bolsa — Ler dados de ações registrados preservando a distinção entre origem e horário dos dados.
• Manchetes de jornais — Verificar o nome do jornal e a data solicitada e exibir a imagem da primeira página completa do arquivo com a origem.
• Comparação de fundos — Comparar fundos no mesmo período, preservando datas dos dados e valores ausentes.

Regras e limites

• Gratuito. Não há plano de pagamento ou assinatura para o MCP — /pricing.md. O aplicativo ao qual você se conecta pode ter seus próprios custos.
• Sem autenticação. Não é necessária conta, token ou chave de API — /auth.md.
• Atribuição obrigatória. Ao usar conteúdo do Manşet Etkisi, forneça link para o endereço permanente da notícia ou da página de dados correspondente.
• 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 aos direitos autorais dos respectivos titulares. O acesso não concede licença de reutilização; preserve as informações de origem/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 juntas: 60 chamadas/minuto. Ferramentas financeiras têm cota comum separada de 30 chamadas/minuto; as três ferramentas de jornais têm cota comum de 60 chamadas/minuto; a ferramenta de imagem de jornal único tem cota separada de 10 chamadas/minuto. Todas também consomem a cota geral. São aplicadas janelas fixas de minuto.
• 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 indisponí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 ser do mesmo site.
• JSON inválido retorna 400, Origin não permitido retorna 403, corpo grande demais 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?

As 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 e conteúdos financeiros aqui apresentados não constituem recomendação de investimento. Os 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 e data_date, se houver, é a data real dos dados; não são intercambiáveis. Origem 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, preços preenchidos para dias sem negociação 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 de origem.

Manifesto de descoberta MCP · llms.txt