Halal Terminal MCP
Inversión conforme a la Sharia para agentes de IA: filtra acciones y ETF según 5 metodologías (AAOIFI, DJIM, FTSE, MSCI, S&P), audita carteras, calcula el zakat, obtén datos de mercado, noticias y presentaciones ante la SEC.
Documentación
Halal Terminal MCP — Análisis de acciones y ETFs conforme a la Shariah para agentes de IA
English | العربية | Bahasa Indonesia | Melayu | اردو | Français
insignia en vivo desde la API, incrusta una para cualquier símbolo
El servidor oficial del Model Context Protocol para Halal Terminal. Dale a tu agente de IA 22 herramientas para responder preguntas de finanzas islámicas: analiza cualquier acción o ETF con 5 metodologías (AAOIFI, DJIM, FTSE, MSCI, S&P), audita carteras, calcula el zakat y la purificación de dividendos, y obtén datos de mercado en vivo, noticias y presentaciones ante la SEC. Funciona en Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Goose y cualquier otro cliente MCP.
"¿Es AAPL halal?" · "Audita mi cartera: AAPL 30%, MSFT 20%, JNJ 50%" · "Calcula el zakat sobre mis tenencias."
Inicio rápido
- Obtén una clave de API gratuita — registro solo con correo electrónico en api.halalterminal.com. Sin tarjeta de crédito. La clave llega a tu bandeja de entrada en segundos.
- Conecta tu cliente — comandos de una línea abajo (o consulta CONNECT.md para Cursor, Windsurf, Cline y otros).
- Haz tu primera pregunta —
"Is AAPL halal?"→ el agente llama ascreen_stocky devuelve veredictos con las 5 metodologías.
Instalación
# 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 directo
https://mcp.halalterminal.com/sse?api_key=ht_yourkey
Guía de configuración completa para todos los clientes: CONNECT.md.
Lo que obtienes — 22 herramientas en 8 categorías
| Categoría | Herramientas |
|---|---|
| Análisis | screen_stock, screen_etf, bulk_screen, get_screening_result, get_all_screening_results |
| Datos de mercado | get_quote, get_stock_info, get_price_history, get_trending_stocks, search_stocks |
| Análisis de ETFs | get_etf_info, etf_purification, compare_etfs |
| Cartera y lista de seguimiento | scan_portfolio, manage_watchlist |
| Comparación | compare_stocks |
| Ingresos y zakat | get_dividends, calculate_zakat |
| Noticias y presentaciones | get_news, get_sec_filings |
| Informes y educación | generate_report, islamic_finance_education |
Referencia completa de entrada/salida en TOOLS.md. Ejemplos de prompts de principio a fin en EXAMPLES.md.
Por qué Halal Terminal
- 5 metodologías, una sola herramienta. AAOIFI, DJIM, FTSE Shariah, MSCI Islamic y S&P Shariah — cada una con reglas de actividad empresarial y umbrales de ratios financieros distintos — presentadas lado a lado por acción para que los usuarios elijan el estándar que siguen.
- Análisis de ETFs a nivel de tenencias. Cada componente se analiza, pondera y agrega en un veredicto general más una tasa de purificación por dólar. Cubre SPY, QQQ, VTI, ISDU, SPUS, HLAL y más de 8.000 ETFs.
- Zakat y purificación, calculados. Zakat del 2,5% frente a un umbral de nisab en vivo; cálculo de ingresos impuros por dividendo basado en el ratio de ingresos no conformes del emisor.
- Análisis masivos de índices. Ejecuciones de activación y consulta en el S&P 500, NASDAQ-100, FTSE 100 y otros; filtra por metodología, sector o solo conformes.
- Plan gratuito, sin tarjeta de crédito. Registro por correo → clave en tu bandeja en segundos → ~5–10 análisis completos al mes sin costo.
Endpoint y transporte
SSE: https://mcp.halalterminal.com/sse
Auth: X-API-Key: <your_key> (or ?api_key=<your_key>)
Transportes compatibles: SSE (recomendado), stdio (a través de este puente @halalterminal/mcp para clientes que lo necesiten).
Planes y cuotas
La API de Halal Terminal se mide por tokens, no por solicitudes.
| Plan | Tokens mensuales | Precio | Notas |
|---|---|---|---|
| Gratuito | 50 | $0 | ~5–10 análisis completos · registro por correo, sin tarjeta de crédito |
| Starter | 2,500 | $19 | Inversores individuales |
| Pro | 15,000 | $49 | Webhooks, prioridad en lotes |
| Enterprise | Ilimitado | $199+ | Metodologías personalizadas, SLA |
Regístrate: api.halalterminal.com · Precios: halalterminal.com/pricing
Lo que este servidor MCP NO es
- No es una fatwa. Cada veredicto es un análisis basado en metodología. Consulta a un erudito cualificado para dictámenes personales.
- No es una plataforma de trading. Sin integraciones con brókers, sin ejecución de órdenes.
- No es un sistema de alertas en tiempo real. Solo solicitud-respuesta en v1; las alertas mediante webhooks están en la hoja de ruta de Pro+.
- Solo inglés en v1. La traducción al árabe y al francés está en la hoja de ruta.
Preguntas frecuentes
¿Este servidor MCP es gratuito?
Sí. El paquete @halalterminal/mcp es Apache-2.0 y gratuito. La API de Halal Terminal tiene un plan gratuito (500 tokens / mes, sin tarjeta de crédito) que cubre ~100 análisis completos de acciones — suficiente para evaluarlo antes de actualizar.
¿Con qué clientes de IA funciona?
Cualquier cliente que admita el Model Context Protocol sobre SSE o stdio — Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Goose y más. Se recomienda SSE; el paquete @halalterminal/mcp lo envuelve como stdio para clientes que aún no admiten SSE.
¿Cómo se determina "halal"?
Cada veredicto aplica las reglas publicadas de la metodología elegida — AAOIFI, Dow Jones Islamic Market (DJIM), FTSE Shariah, MSCI Islamic y S&P Shariah. Dos capas: (1) un análisis de actividad empresarial (sin alcohol, juegos de azar, finanzas convencionales, contenido para adultos, armas, cerdo, …), y luego (2) umbrales de ratios financieros (p. ej., deuda con intereses sobre capitalización de mercado, activos ilíquidos, proporción de ingresos por intereses). El MCP expone los cinco veredictos para que el usuario — o el erudito — elija el estándar que sigue.
¿Qué es la purificación de dividendos?
Cuando tienes una acción con una pequeña proporción de ingresos no conformes, los eruditos exigen donar la fracción no conforme de cualquier dividendo recibido. calculate_zakat(calculation_type="purification", …) y get_dividends(include_purification=True) calculan ese importe automáticamente.
¿Puede analizar ETFs?
Sí — screen_etf revisa cada tenencia subyacente, aplica la metodología a cada una y devuelve un veredicto general, el porcentaje conforme y la tasa de purificación agregada. Los ETFs de sukuk se gestionan por separado (metodologías basadas en activos).
¿Puedo analizar un índice completo de una vez?
Sí — bulk_screen activa una ejecución asíncrona en índices como S&P 500, NASDAQ-100, FTSE 100, y te permite consultar el estado, filtrar resultados por metodología / sector / solo conformes, y comparar dos ejecuciones.
¿Admite webhooks para cambios de conformidad?
Los webhooks son una función del plan Pro en la hoja de ruta de la API; la v1 de este MCP es solo solicitud-respuesta.
¿Dónde reporto errores o solicito herramientas?
github.com/goww7/halalterminal-mcp/issues o por correo a yassir@halalterminal.com.
Aprende más
- Referencia de la API
- Cómo crear un servidor MCP de finanzas islámicas
- ¿Qué son las finanzas islámicas?
- Guía de análisis de sukuk
- ¿Es halal mi acción? Analizador
Parte del ecosistema Halal Terminal
Sitio web · API · Python SDK · JS SDK · Plugin de Claude · Bot de Discord · Indicador de TradingView · Seguimiento de cartera
Proyectos relacionados (OSS hermanos)
Herramientas de código abierto que comparten la misma API de Halal Terminal — diferentes superficies, mismos datos:
| Proyecto | Qué es | Licencia |
|---|---|---|
| halalterminal-claude-skills | Plugin de Claude Code — habilidades seleccionadas, comandos de barra y un subagente constructor de carteras sobre este servidor MCP. | Apache-2.0 |
| yassir-oss | Agente ReAct de código abierto para investigación de finanzas halal — CLI + interfaz web; admite OpenAI / Anthropic / LLMs locales. | Apache-2.0 |
| halal-discord-bot | Bot de Discord — comandos de barra /halal AAPL, /portfolio, /trending. | MIT |
| halal-portfolio-tracker | Aplicación Next.js 14 — introduce tenencias, obtén conformidad por acción + % halal de la cartera + purificación pendiente. Despliegue en Vercel con un clic. | MIT |
| halal-pine | Indicador de TradingView Pine Script v5 que superpone el estado de conformidad en los gráficos. Se actualiza a diario desde esta API. | MIT |
Licencia y marcas comerciales
Apache-2.0 — consulta LICENSE.
"Halal Terminal", "HalalTerminal" y el logotipo de Halal Terminal son marcas comerciales reservadas — consulta TRADEMARKS.md.
Legal
- Legal y Aviso legal — marco de investigación educativa, aviso de inversión, notificación de conformidad con la Shariah, límites de responsabilidad, avisos de jurisdicción
- Política de privacidad
- Política de cookies
Soporte
- Contacto: yassir@halalterminal.com
- Panel: api.halalterminal.com/dashboard
- Documentación de la API: api.halalterminal.com/docs (Swagger) · api.halalterminal.com/redoc (ReDoc)
Desarrollado por Halal Terminal — halalterminal.com
Parte del ecosistema abierto de Halal Terminal: API · Servidor MCP · Python SDK · JS SDK · Conjuntos de datos · Awesome Islamic Finance