MCP server for Shariah-compliant stock and ETF screening — connect Claude Code, Cursor, Cline, Codex, or any MCP client to the Halal Terminal API. Free tier available.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add halal-terminal --env HALALTERMINAL_API_KEY='<HALALTERMINAL_API_KEY>' -- npx -y @halalterminal/mcp~/.codex/config.toml
[mcp_servers.halal-terminal]
command = "npx"
args = ["-y", "@halalterminal/mcp"]
env = { HALALTERMINAL_API_KEY = "<HALALTERMINAL_API_KEY>" }
# codex mcp add halal-terminal --env HALALTERMINAL_API_KEY='<HALALTERMINAL_API_KEY>' -- npx -y @halalterminal/mcp~/.cursor/mcp.json
{
"mcpServers": {
"halal-terminal": {
"command": "npx",
"args": [
"-y",
"@halalterminal/mcp"
],
"env": {
"HALALTERMINAL_API_KEY": "<HALALTERMINAL_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"halal-terminal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@halalterminal/mcp"
],
"env": {
"HALALTERMINAL_API_KEY": "<HALALTERMINAL_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"halal-terminal": {
"command": "npx",
"args": [
"-y",
"@halalterminal/mcp"
],
"env": {
"HALALTERMINAL_API_KEY": "<HALALTERMINAL_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"halal-terminal": {
"command": "npx",
"args": [
"-y",
"@halalterminal/mcp"
],
"env": {
"HALALTERMINAL_API_KEY": "<HALALTERMINAL_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"halal-terminal": {
"command": "npx",
"args": [
"-y",
"@halalterminal/mcp"
],
"env": {
"HALALTERMINAL_API_KEY": "<HALALTERMINAL_API_KEY>"
}
}
}
}Remote
claude mcp add --transport sse halal-terminal https://mcp.halalterminal.com/sse --header 'X-API-Key: <X_API_KEY>'~/.codex/config.toml
# Codex has no SSE transport: bridged through mcp-remote
[mcp_servers.halal-terminal]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.halalterminal.com/sse", "--header", "X-API-Key:<X_API_KEY>"]~/.cursor/mcp.json
{
"mcpServers": {
"halal-terminal": {
"url": "https://mcp.halalterminal.com/sse",
"headers": {
"X-API-Key": "<X_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"halal-terminal": {
"type": "sse",
"url": "https://mcp.halalterminal.com/sse",
"headers": {
"X-API-Key": "<X_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"halal-terminal": {
"url": "https://mcp.halalterminal.com/sse",
"headers": {
"X-API-Key": "<X_API_KEY>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"halal-terminal": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.halalterminal.com/sse",
"--header",
"X-API-Key:<X_API_KEY>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"halal-terminal": {
"url": "https://mcp.halalterminal.com/sse",
"headers": {
"X-API-Key": "<X_API_KEY>"
}
}
}
}Environment variables
HALALTERMINAL_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.