AILAT MCP Server (npm CLI)

MCP stdio bridge for Islamic finance tools and market data. This package exposes a CLI that lets MCP clients (like Claude Desktop, Claude Code) access multiple financial tools via the Model Context Protocol.

Available Tools

• AAOIFI Consultant (query_aaoifi_consultant) - Query Islamic finance standards and regulations
• Fatwa Consultant (query_fatwa) - Query Islamic fatwas (religious rulings) on finance, trade, and investments
• Market Offers (search_market_offers, get_market_offer_details, get_market_offer_categories) - Search investment opportunities in Kazakhstan
• Stock Compliance Expert (query_stock_compliance) - Query Shariah compliance status for publicly traded stocks

Designed to be used via npx or an installed binary in MCP client configs.

Installation

You can use this package either via npx (no install) or install it globally/locally.

Option 1: npx (recommended)

npx ailat-mcp-server

Option 2: Global install

npm install -g ailat-mcp-server

ailat-mcp-server

Option 3: Local install

npm install ailat-mcp-server

npx ailat-mcp-server

MCP Client Configuration (Claude Desktop)

Configure Claude Desktop (or any MCP client) to start this CLI as a stdio MCP server.

Windows

Press on keyboard 'Win + R', type '%APPDATA%\Claude\claude_desktop_config.json', and press 'Enter'. Insert this connection settings:

{
  "mcpServers": {
    "ailat-consultant": {
      "command": "npx",
      "args": ["-y", "ailat-mcp-server"],
      "env": {},
      "disabled": false,
    },
  },
}

Close the text editor window, accept the changes in popup message to save the file. Restart Claude Desktop. Once configured, Claude will see mcp server connection named ailat-consultant and a tool named query_aaoifi_consultant in the tools list.

MCP Client Configuration (Claude Code)

Open terminal in desired folder and run this command:

claude mcp add ailat-consultant npx -y ailat-mcp-server

Then restart Claude Code.

Available MCP Tools

The MCP server exposes the following tools:

query_aaoifi_consultant

• Description: Query the AAOIFI standards AI consultant about Islamic finance standards and regulations.
• Input:
  • question – string, required. Your question about AAOIFI standards.

query_fatwa

• Description: Query the Islamic fatwa (religious rulings) knowledge base for guidance on finance, trade, and investment matters according to Shariah principles.
• Input:
  • question – string, required. Your question about Islamic fatwas or religious rulings.
  • category – string, optional. Filter by category: "trade", "finance", "investments", "banking", "insurance", or "other".
  • userId – string, optional. User identifier for tracking.
• Returns: JSON response with:
  • response – formatted answer citing specific fatwas with IDs and dates
  • language – detected language of the query
  • sourcesUsed – number of fatwas referenced
  • rawResults – full fatwa documents used for the response

Example Usage:

{
  "question": "Is cryptocurrency trading halal?",
  "category": "trade"
}

search_market_offers

• Description: Search for investment market offers in Kazakhstan.
• Input:
  • country – string, required. Currently only "Kazakhstan" is supported.
  • category – string, optional. Filter by "REGULAR" or "STARTUP".
  • search – string, optional. Search term for title, company, or description.
  • tagIds – array of numbers, optional. Filter by specific tag IDs.
  • limit – number, optional. Max results (default 10, max 50).
  • language – string, optional. Response language (default "ru").

get_market_offer_details

• Description: Get complete details for a specific market offer.
• Input:
  • offerId – number, required. The ID of the offer to retrieve.
  • country – string, required. Currently only "Kazakhstan" is supported.
  • language – string, optional. Response language (default "ru").

get_market_offer_categories

• Description: Get available market offer categories and counts.
• Input:
  • country – string, required. Currently only "Kazakhstan" is supported.
  • language – string, optional. Response language (default "ru").

query_stock_compliance

• Description: Query Shariah compliance status and detailed analysis for publicly traded stocks. Provides expert-approved verdicts on whether companies operate in accordance with Islamic finance principles.
• Input:
  • symbols – array of strings, required. Trading symbols (1-20 symbols, e.g., ["AAPL", "NVDA", "MSFT"]). Company names are not supported.
  • language – string, optional. Response language: "en" (English), "ru" (Russian), or "kk" (Kazakh). Default: "en". Unsupported languages fall back to English.
• Returns: JSON response with:
  • success – boolean indicating if at least one symbol was processed
  • data – array of stock compliance results with Shariah verdicts
  • errors – array of errors for symbols that couldn't be processed
  • language – the language used for the response

Example Usage:

{
  "symbols": ["AAPL", "NVDA"],
  "language": "en"
}

Response Structure:

{
  "success": true,
  "data": [
    {
      "symbol": "AAPL",
      "tradingSymbolId": 1,
      "mainActivity": "Design, manufacture...",
      "shariahVerdict": "NON_COMPLIANT",
      "shariahVerdictDescription": {
        "verdict": "Non permissible",
        "explanation": "...",
        "recommendation": "..."
      },
      "shariahApprovalDate": "2024-10-15T10:30:00Z"
    }
  ],
  "errors": [],
  "language": "en"
}

All tools return the backend's response as MCP text content.

Requirements

• Node.js 18+

License

MIT