Online Malumat MCP

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

Guia do desenvolvedor MCP

O Online Malumat oferece acesso somente leitura, a partir de aplicações de inteligência artificial, às suas notícias publicadas, primeiras páginas de jornais registradas e aos dados registrados dos módulos financeiros abertos neste site. Não é necessário login ou chave de API.

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

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

Claude Code · JSON

.mcp.json

{
  "mcpServers": {
    "onlinemalumat_com": {
      "type": "http",
      "url": "https://onlinemalumat.com/api/mcp"
    }
  }
}

Gemini CLI · JSON

~/.gemini/settings.json

{
  "mcpServers": {
    "onlinemalumat_com": {
      "httpUrl": "https://onlinemalumat.com/api/mcp"
    }
  }
}

Cursor · JSON

.cursor/mcp.json

{
  "mcpServers": {
    "onlinemalumat_com": {
      "url": "https://onlinemalumat.com/api/mcp"
    }
  }
}

Codex · TOML

~/.codex/config.toml

[mcp_servers.onlinemalumat_com]
url = "https://onlinemalumat.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 2–5 códigos diferentes; o período padrão é 1a, e os demais períodos são 1d, 1m, 1t, 3m, 6m, no ano, 3a e 5a.

Ferramenta	Campos de entrada	Descrição
get_latest_news	limite, categoria	Busca as notícias publicadas mais recentes; um filtro opcional de 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 pelo valor do slug.
search_news	consulta, limite, categoria	Pesquisa em títulos, descrições e palavras-chave de notícias; pode ser limitado 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 seus nomes e valores de slug.
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 fonte da notícia pelo ID de conteúdo obtido no resultado da busca.
search_financial_assets	consulta, tipo, limite	Pesquisa 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, variação e 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 a ficha 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 2–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 última rodada; seções fechadas não são chamadas.
get_stock_financials	símbolo	Busca os dados financeiros registrados da empresa com seus períodos e unidades atuais; séries calculadas são indicadas separadamente.
list_company_disclosures	símbolo, dias, limite	Lista os comunicados 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, valores de slug 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 do dia solicitado com fonte e links de imagem; se a data não existir, 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

Liste as ferramentas:

curl -X POST 'https://onlinemalumat.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://onlinemalumat.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; dias futuros não são aceitos. Pode-se usar o nome do jornal ou o slug. As listas diárias retornam no máximo 50 resultados e aceitam deslocamento 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 como conteúdo de imagem MCP e links de fonte/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://onlinemalumat.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://onlinemalumat.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://onlinemalumat.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 — Busca de notícias, obtenção do texto completo e indicação de data/fonte.
• Leitura de dados de bolsa — Leitura dos 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 da primeira página completa do arquivo com a fonte.
• Comparação de fundos — Comparação de 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 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 Online Malumat, 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 é uma 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 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 juntas têm 60 chamadas/minuto. Ferramentas financeiras têm adicionalmente um limite comum de 30 chamadas/minuto; as três ferramentas de jornais têm 60 chamadas/minuto em conjunto; a ferramenta de imagem de jornal único tem uma cota separada de 10 chamadas/minuto. Todas também contam para 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 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?

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 financeiros e conteúdos 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, 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.

No histórico de preços, há 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 da fonte.

Manifesto de descoberta MCP · llms.txt