Halel MCP connector
Halel's connector lets Claude, ChatGPT and other Model Context Protocol (MCP) clients look up stocks on the Saudi Exchange (Tadawul), GCC and US markets and major crypto: latest quotes, today's biggest movers and market breadth, Halel's Shariah screening classification with its source, and how the Halel Ideas community leans on a stock. It works in Arabic and English.
Information only, not investment advice. Halel never recommends buying, selling or holding a security, never gives price targets, and Shariah results are screening classifications from the cited source, not a fatwa.
Connect
Server URL: https://halel.co/mcp
Transport: Streamable HTTP · Authentication: none · All tools are read-only
- Claude: Settings → Connectors → Add custom connector, paste the URL, choose "No sign in".
- ChatGPT: install Halel from the plugin directory, or add a custom MCP server with the URL above.
- Other MCP clients: add a remote (HTTP) MCP server with the URL above. No API key is needed.
Tools
| Tool | What it returns |
|---|---|
search_stocks | Matches for a company name or ticker (Arabic or English) with the symbol and market to use with the other tools. |
get_stock_quote | Latest price, today's change, day and 52-week ranges, volume, currency and the as-of time. Prices may be delayed. |
get_shariah_screening | Compliant, non-compliant or needs review, with the source (for Saudi listings, the Al Rajhi Capital Shariah Board list), confidence, purification percentage and the activity and financial-ratio checks. |
get_market_movers | Today's top gainers and decliners and the market breadth across the most-traded names in Saudi, US, GCC or crypto. |
get_community_sentiment | Counts of bullish, neutral and bearish Halel Ideas on a stock over the last 30 days. Aggregate and anonymous. |
Try it
- Is Saudi Aramco Shariah compliant according to Halel?
- What are the biggest movers on Tadawul today?
- كم سعر سهم الراجحي الآن؟
- How is the Halel community leaning on Al Rajhi Bank (1120)?
Walkthrough video: halel.co/mcp-review/halel-demo.mp4
Data and privacy
The connector needs no account and receives only the tool arguments your assistant sends (a company name, ticker or market). It does not read or store any Halel user account, portfolio or personal data, and community sentiment is aggregate only. Requests are rate-limited to keep the service available. See the privacy policy and terms.
Methodology and support
How Halel screens stocks: halal standards and methodology. Data providers: data sources. Questions or problems: see the FAQ, where you can also contact us on Telegram.