DalalOS

Servidor MCP para Pesquisa de Ações Indianas

Documentação

DalalOS — Pesquisa de ações indianas para agentes de IA

DalalOS é uma camada de dados hospedada do Model Context Protocol (MCP) para pesquisar empresas listadas na NSE/BSE da Índia com assistentes e agentes de IA.

O que a DalalOS oferece

A DalalOS expõe dados estruturados de pesquisa do mercado indiano para clientes compatíveis com MCP, incluindo:

  • busca de empresas e valores mobiliários;
  • cotações de fim de dia e histórico de preços;
  • demonstrações financeiras de empresas e índices calculados mecanicamente;
  • dados de comparação de pares e setores;
  • dados de participação acionária e penhor de promotores;
  • ações corporativas, resultados, arquivamentos e eventos divulgados;
  • triagem, índices e contexto de mercado;
  • conjuntos de dados oficiais de macro/consulta usados como contexto de pesquisa; e
  • uma watchlist da DalalOS vinculada à conta.

Os dados são obtidos de fontes oficiais e públicas do mercado indiano, como arquivos da NSE, interfaces oficiais da BSE e arquivamentos de bolsa, arquivamentos BSE-XBRL exigidos pela SEBI, e o editor oficial nomeado do setor público para os conjuntos de dados de macro/consulta suportados.

Limites importantes

  • Não é tempo real: dados de cotações do mercado de ações são de fim de dia, não um feed de tick ao vivo ou de livro de ofertas.
  • Pesquisa, não execução: a DalalOS não é uma corretora e não realiza ordens de mercado nem executa negociações.
  • Sem aconselhamento de investimento: a DalalOS retorna fatos com fonte e medidas calculadas mecanicamente, não recomendações de compra/venda, preços-alvo ou sugestões de investimento.
  • Escopo de leitura/escrita: as ferramentas de pesquisa de dados de mercado são somente leitura. A única exceção explícita de escrita é a própria watchlist da DalalOS do chamador, onde usuários autenticados podem adicionar ou remover símbolos.
  • Dados ausentes permanecem explícitos: cobertura não suportada, indisponível ou desatualizada é sinalizada em vez de substituída por valores inventados.

Conecte-se

Use o endpoint hospedado streamable-HTTP:

https://mcp.dalalos.in/mcp

OAuth é o caminho de autenticação preferido para clientes que o suportam. A autenticação por Bearer com chave API está disponível como alternativa para clientes compatíveis que a exigem.

Consulte docs/CONNECT.md para notas de configuração seguras ao público e os guias mantidos no site para instruções específicas de cada cliente.

Contrato público de capacidades

capabilities.json é o contrato de descoberta legível por máquina deliberadamente mínimo para a superfície MCP hospedada. Ele contém apenas nomes públicos de ferramentas MCP além de fatos de ciclo de vida de leitura/escrita, destrutividade e depreciação, juntamente com contagens derivadas de registrados/preferidos/escrita.

Ele intencionalmente não publica módulos de implementação de ferramentas, hashes de esquema de entrada, mapeamentos REST, detalhes de armazenamento/cache, lógica de adaptadores de fonte, mecânicas de atualização, informações de implantação, credenciais ou outros detalhes internos de backend.

Aliases de compatibilidade depreciados permanecem na lista de nomes registrados, mas são excluídos de preferred_tool_count, para que diretórios e superfícies de produto não inflacionem as contagens de capacidade com aliases antigos.

Identidade no MCP Registry

O manifesto público do registro é server.json. A DalalOS já possui uma identidade oficial no MCP Registry sob:

io.github.aatharva16/dalalos

Essa identidade existente é intencionalmente preservada para que o endpoint hospedado tenha um único registro canônico no Registry. Alterações nos metadados do Registry devem ser publicadas usando credenciais autorizadas para esse namespace existente; este repositório público não armazena essas credenciais.

Propósito do repositório

Este repositório é a superfície pública de projeto, integração e descoberta da DalalOS. Ele existe para que usuários, registros MCP, diretórios de ferramentas de IA e listas do ecossistema de código aberto tenham uma referência pública estável no GitHub para o serviço hospedado.

Ele intencionalmente não contém a implementação de backend da DalalOS. Em particular, este repositório não publica lógica interna de ingestão, esquemas de banco de dados/cache, código de adaptadores de fonte, topologia de implantação, credenciais, ferramentas operacionais privadas, histórico privado de issues/PRs ou arquitetura não publicada.

Os arquivos públicos neste repositório são limitados a metadados de integração, documentação de conexão, descrições públicas de capacidades/procedência e exemplos seguros de uso.

Metadados públicos

  • server.json — metadados MCP Registry para o servidor hospedado.
  • capabilities.json — contrato sanitizado legível por máquina de nomes de capacidades/leitura-escrita/depreciação.
  • docs/CONNECT.md — notas de conexão e autenticação.
  • docs/DATA_SOURCES.md — contrato de procedência e atualização.
  • docs/DIRECTORY_LISTING.md — cópia canônica para diretórios MCP, catálogos de ferramentas de IA e listas de recursos selecionadas.
  • docs/OPENAI_PLUGIN_SUBMISSION.md — pacote público seguro de preparação para listagem/revisão de Plugin OpenAI, incluindo prompts iniciais e testes de capacidade positivos/negativos.
  • examples/PROMPTS.md — exemplos de prompts de pesquisa e exemplos de limites de capacidade.
  • CONTRIBUTING.md — diretrizes públicas de contribuição e proteção contra vazamento de implementação.
  • SECURITY.md — orientação responsável para reportar segurança.

Legal e privacidade

A DalalOS não é afiliada nem endossada pela NSE, BSE, SEBI, OpenAI, Anthropic, Cursor ou qualquer outro fornecedor de cliente de IA, salvo declaração explícita em contrário por essa parte.