Halal Terminal MCP
Investimento em conformidade com a Shariah para agentes de IA — filtre ações e ETFs em 5 metodologias (AAOIFI, DJIM, FTSE, MSCI, S&P), audite carteiras, calcule o zakat, obtenha dados de mercado, notícias e arquivos da SEC.
Documentação
Halal Terminal MCP — Triagem de ações e ETFs em conformidade com a Shariah para agentes de IA
English | العربية | Bahasa Indonesia | Melayu | اردو | Français
selo ao vivo da API, incorpore um para qualquer símbolo
O servidor oficial do Model Context Protocol para Halal Terminal. Dê ao seu agente de IA 22 ferramentas para responder perguntas sobre finanças islâmicas: triagem de qualquer ação ou ETF em 5 metodologias (AAOIFI, DJIM, FTSE, MSCI, S&P), auditoria de carteiras, cálculo de zakat e purificação de dividendos, além de dados de mercado em tempo real, notícias e arquivamentos na SEC. Funciona no Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Goose e em qualquer outro cliente MCP.
"AAPL é halal?" · "Audite minha carteira: AAPL 30%, MSFT 20%, JNJ 50%" · "Calcule o zakat sobre minhas participações."
Início rápido
- Obtenha uma chave de API gratuita — cadastro apenas com e-mail em api.halalterminal.com. Sem cartão de crédito. A chave chega na sua caixa de entrada em segundos.
- Conecte seu cliente — comandos de uma linha abaixo (ou veja CONNECT.md para Cursor, Windsurf, Cline e outros).
- Faça sua primeira pergunta —
"Is AAPL halal?"→ o agente chamascreen_stocke retorna veredictos em todas as 5 metodologias.
Instalação
# Recommended — no install needed
npx -y @halalterminal/mcp
# Or pin globally
npm install -g @halalterminal/mcp
Claude Desktop
{
"mcpServers": {
"halalterminal": {
"command": "npx",
"args": ["-y", "@halalterminal/mcp"],
"env": { "HALALTERMINAL_API_KEY": "ht_yourkey" }
}
}
}
Claude Code
claude mcp add --transport sse halalterminal \
https://mcp.halalterminal.com/sse \
--header "X-API-Key: ht_yourkey"
Cursor / Windsurf / SSE direto
https://mcp.halalterminal.com/sse?api_key=ht_yourkey
Guia completo de configuração para todos os clientes: CONNECT.md.
O que você obtém — 22 ferramentas em 8 categorias
| Categoria | Ferramentas |
|---|---|
| Triagem | screen_stock, screen_etf, bulk_screen, get_screening_result, get_all_screening_results |
| Dados de mercado | get_quote, get_stock_info, get_price_history, get_trending_stocks, search_stocks |
| Análise de ETFs | get_etf_info, etf_purification, compare_etfs |
| Carteira e lista de acompanhamento | scan_portfolio, manage_watchlist |
| Comparação | compare_stocks |
| Renda e zakat | get_dividends, calculate_zakat |
| Notícias e arquivamentos | get_news, get_sec_filings |
| Relatórios e educação | generate_report, islamic_finance_education |
Referência completa de entrada/saída em TOOLS.md. Exemplos de fluxos completos em EXAMPLES.md.
Por que Halal Terminal
- 5 metodologias, uma ferramenta. AAOIFI, DJIM, FTSE Shariah, MSCI Islamic e S&P Shariah — cada uma com regras distintas de atividade empresarial e limites de índices financeiros — exibidas lado a lado por ação para que os usuários escolham o padrão que seguem.
- Triagem de ETFs no nível das participações. Cada ativo subjacente é triado, ponderado e agregado em um veredicto geral, além de uma taxa de purificação por dólar. Cobre SPY, QQQ, VTI, ISDU, SPUS, HLAL e mais de 8.000 ETFs.
- Zakat e purificação, calculados. Zakat de 2,5% com base em um limite de nisab em tempo real; cálculo de renda impura por dividendo com base na proporção de receita não conforme do emissor.
- Triagens em massa de índices. Execuções com acionamento e consulta no S&P 500, NASDAQ-100, FTSE 100 e outros; filtre por metodologia, setor ou apenas conforme.
- Plano gratuito, sem cartão de crédito. Cadastro por e-mail → chave na sua caixa de entrada em segundos → cerca de 5–10 triagens completas por mês sem custo.
Endpoint e transporte
SSE: https://mcp.halalterminal.com/sse
Auth: X-API-Key: <your_key> (or ?api_key=<your_key>)
Transportes suportados: SSE (recomendado), stdio (via ponte @halalterminal/mcp para clientes que precisam).
Planos e cotas
A API do Halal Terminal é medida por tokens, não por requisições.
| Plano | Tokens mensais | Preço | Observações |
|---|---|---|---|
| Gratuito | 50 | $0 | ~5–10 triagens completas · cadastro por e-mail, sem cartão de crédito |
| Starter | 2.500 | $19 | Investidores individuais |
| Pro | 15.000 | $49 | Webhooks, prioridade em lote |
| Enterprise | Ilimitado | $199+ | Metodologias personalizadas, SLA |
Cadastre-se: api.halalterminal.com · Preços: halalterminal.com/pricing
O que este servidor MCP NÃO é
- Não é uma fatwa. Cada veredicto é uma triagem baseada em metodologia. Consulte um estudioso qualificado para decisões pessoais.
- Não é uma plataforma de negociação. Sem integrações com corretoras, sem execução de ordens.
- Não é um sistema de alertas em tempo real. Apenas requisição-resposta na v1; alertas via webhook estão no roadmap do Pro+.
- Somente em inglês na v1. Renderização em árabe e francês está no roadmap.
Perguntas frequentes
Este servidor MCP é gratuito?
Sim. O pacote @halalterminal/mcp é Apache-2.0 e gratuito. A API do Halal Terminal tem um plano gratuito (500 tokens/mês, sem cartão de crédito) que cobre cerca de 100 triagens completas de ações — suficiente para avaliar antes de atualizar.
Com quais clientes de IA ele funciona?
Qualquer cliente que suporte o Model Context Protocol via SSE ou stdio — Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Goose e outros. SSE é recomendado; o pacote @halalterminal/mcp o encapsula como stdio para clientes que ainda não suportam SSE.
Como o "halal" é determinado?
Cada veredicto aplica as regras publicadas da metodologia escolhida — AAOIFI, Dow Jones Islamic Market (DJIM), FTSE Shariah, MSCI Islamic e S&P Shariah. Duas camadas: (1) uma triagem de atividade empresarial (sem álcool, jogos de azar, finanças convencionais, conteúdo adulto, armas, carne suína, …) e, em seguida, (2) limites de índices financeiros (por exemplo, dívida com juros sobre capitalização de mercado, ativos ilíquidos, participação em receita de juros). O MCP expõe todos os cinco veredictos para que o usuário — ou estudioso — escolha o padrão que segue.
O que é purificação de dividendos?
Quando você possui uma ação com uma pequena parcela de receita não conforme, os estudiosos exigem a doação da fração não conforme de qualquer dividendo recebido. calculate_zakat(calculation_type="purification", …) e get_dividends(include_purification=True) calculam esse valor automaticamente.
Ele pode triar ETFs?
Sim — screen_etf percorre cada participação subjacente, aplica a metodologia a cada uma e retorna um veredicto geral, a porcentagem conforme e a taxa agregada de purificação. ETFs de sukuk são tratados separadamente (metodologias baseadas em ativos).
Posso triar um índice inteiro de uma vez?
Sim — bulk_screen aciona uma execução assíncrona em índices como S&P 500, NASDAQ-100, FTSE 100 e permite consultar o status, filtrar resultados por metodologia/setor/apenas conforme e comparar duas execuções.
Ele suporta webhooks para mudanças de conformidade?
Webhooks são um recurso do plano Pro no roadmap da API; a v1 deste MCP é apenas requisição-resposta.
Onde reporto bugs ou solicito ferramentas?
github.com/goww7/halalterminal-mcp/issues ou e-mail yassir@halalterminal.com.
Saiba mais
- Referência da API
- Construindo um servidor MCP de finanças islâmicas
- O que são finanças islâmicas?
- Guia de triagem de sukuk
- Minha ação é halal? Triagem
Parte do ecossistema Halal Terminal
Site · API · SDK Python · SDK JS · Plugin Claude · Bot Discord · Indicador TradingView · Rastreador de carteira
Projetos relacionados (OSS irmãos)
Ferramentas de código aberto que compartilham a mesma API do Halal Terminal — superfícies diferentes, mesmos dados:
| Projeto | O que é | Licença |
|---|---|---|
| halalterminal-claude-skills | Plugin do Claude Code — habilidades selecionadas, comandos de barra e um subagente construtor de carteira sobre este servidor MCP. | Apache-2.0 |
| yassir-oss | Agente ReAct de código aberto para pesquisa de finanças halal — CLI + interface web; suporta OpenAI / Anthropic / LLMs locais. | Apache-2.0 |
| halal-discord-bot | Bot do Discord — comandos de barra /halal AAPL, /portfolio, /trending. | MIT |
| halal-portfolio-tracker | Aplicativo Next.js 14 — insira participações, obtenha conformidade por ação + % halal da carteira + purificação devida. Deploy em um clique no Vercel. | MIT |
| halal-pine | Indicador Pine Script v5 para TradingView que sobrepõe o status de conformidade nos gráficos. Atualizado diariamente a partir desta API. | MIT |
Licença e marcas registradas
Apache-2.0 — veja LICENSE.
"Halal Terminal", "HalalTerminal" e o logotipo do Halal Terminal são marcas registradas reservadas — veja TRADEMARKS.md.
Legal
- Aviso legal e isenção de responsabilidade — enquadramento de pesquisa educacional, isenção de investimento, aviso de conformidade com a Shariah, limites de responsabilidade, avisos de jurisdição
- Política de privacidade
- Política de cookies
Suporte
- Contato: yassir@halalterminal.com
- Painel: api.halalterminal.com/dashboard
- Documentação da API: api.halalterminal.com/docs (Swagger) · api.halalterminal.com/redoc (ReDoc)
Desenvolvido por Halal Terminal — halalterminal.com
Parte do ecossistema aberto Halal Terminal: API · Servidor MCP · SDK Python · SDK JS · Conjuntos de dados · Awesome Islamic Finance