Show HN: MCP server so AI agents can screen markets in plain English

XCREENER released an open-source MCP server that lets AI agents screen Crypto, Forex, Indices, Commodities, and Metals markets using plain English. The local stdio bridge exposes XQL validate, explain, run, and natural-language reference tools to Claude Desktop, Cursor, Windsurf, and other stdio MCP clients, with a one-click installer and no manual JSON configuration required.

Local stdio MCP bridge for XCREENER's XQL screener API — validate, explain, and run XQL queries from Claude Desktop, Cursor, Windsurf, or any stdio MCP client. XCREENER https://xcreener.com is a market screener that scans Crypto, Forex, Indices, Commodities, and Metals simultaneously, so you don't have to check charts one at a time. It's built for beginner traders through ready-made screeners as well as for developers and AI agents, who can express custom conditions in XCREENER Query Language XQL and run them instantly via a REST API or MCP. Learn more at xcreener.com https://xcreener.com . This package is the local stdio bridge to XCREENER's XQL API specifically. It exposes xql validate , xql explain , xql run , and xql nl reference as MCP tools, so any stdio MCP client can check and execute XQL screens against live market data without you writing any HTTP glue code. Download the latest xcreener.mcpb from this repo's Releases https://github.com/xcreener/xcreener-mcp/releases page, then double-click it to install — Desktop asks for your API key in a masked field as part of that same dialog. No JSON to hand-edit, no separate Node install. Add this to your client's MCP server config e.g. Cursor, Windsurf, Claude Code : { "mcpServers": { "xcreener": { "command": "npx", "args": "-y", "@xcreener/mcp" , "env": { "XCREENER API KEY": "your-api-key" } } } } git clone https://github.com/xcreener/xcreener-mcp.git cd xcreener-mcp npm install npm run build Then point your client at node dist/index.js with XCREENER API KEY set in its environment. | Variable | Required | Description | |---|---|---| XCREENER API KEY | Yes | Your XCREENER API key, from | The key is checked lazily — an invalid or missing key won't stop the server from starting, it'll just surface as an auth error the first time a tool is called. | Name | Type | Description | |---|---|---| xql validate | Tool | Validate XQL query text by parsing and planning it, without executing it against live data. | xql explain | Tool | Parse and plan an XQL query, returning its execution plan and a human-readable explanation. | xql run | Tool | Parse, plan, and execute an XQL query against live market data, returning matching instruments. | xql nl reference | Tool | Reference document mapping natural-language trading phrases to XQL syntax. | Under the hood, the assistant calls the xql nl reference tool, translates your plain-English ask into an XQL query, and calls xql validate / xql run — what you see is just the human-visible conversation. A few real examples: Multi-market screen You:check all markets and see which instruments are oversold at the moment XCREENER runs same query per market — CRYPTO , FOREX , INDICES , METALS , COMMODITIES : market = "CRYPTO" timeframe = h1 columns = rsi 14 sort = rsi 14 asc rsi 14 < 30 XCREENER:Oversold RSI 14 < 30, hourly across all markets: Market Symbol RSI 14 Crypto BTCUSDT 26.3 Crypto ETHUSDT 27.5 Crypto XRPUSDT 28.0 Commodities WHEATUSD 21.0 Commodities CORNUSD 22.6 Forex, Indices, and Metals had no oversold matches. Single-market snapshot You:can you give me updates on how the metals are doing? XCREENER runs: js market = "METALS" timeframe = h1 let uptrend = close sma 50 columns = close, roc 1 , rsi 14 , uptrend sort = roc 1 desc close 0 XCREENER:Metals snapshot, hourly: Symbol Close 1h ROC RSI 14 Trend vs SMA50 XPTUSD Platinum 1,637.98 +0.03% 54.8 Uptrend XAGUSD Silver 57.48 +0.02% 38.6 Downtrend XAUUSD Gold 4,043.69 +0.01% 41.0 Downtrend Overall: fairly quiet, no oversold/overbought extremes all RSI 38–55 . Platinum's the strongest — up-trending with the best momentum — while gold and silver are drifting below their 50-hour average. Cross-pair aggregate analysis You:which currency is the weakest and strongest? XCREENER runs: market = "FOREX" timeframe = h1 columns = close, roc 1 sort = roc 1 desc close 0 XCREENER:Based on the 1h ROC across all 28 pairs aggregating each currency's average move against the other seven : Rank Currency Avg 1h Strength 1 strongest CHF +0.0414% 2 JPY +0.0184% ... 8 weakest USD -0.0421% Strongest: CHF— up against every other major this hour.Weakest: USD— sold broadly against EUR, GBP, AUD, JPY, and CHF alike. Actionable trade plan You:NZD looks like the strongest currency this week — which pair should I long based on that, and what stop-loss/take-profit levels make sense? XCREENER runs: market = "FOREX" timeframe = h1 symbols = "NZDUSD" columns = close, atr 14 , sma 50 , highest high, 20 , lowest low, 20 , w::lowest low, 52 , rsi 14 close 0 XCREENER:Idea: Long NZDUSD— the cleanest multi-timeframe confluence: NZD is the 2 strongest currency of the week, daily is non-conflicting, and hourly shows an uptrend close 0.5881 SMA 50 0.5846 with bullish-but-not-overbought momentum RSI 14 60.8 . Level Rationale Entry ~0.5881 Current price Stop Loss 0.5845 Below the 20h swing low and h1 SMA 50 ; ~3× ATR 14 TP1 0.5940 ~1.6:1 R:R, partial scale-out TP2 0.6093 Weekly 52-week high, ~5.9:1 R:R Not financial advice — a technical read off the pulled data; confirm against execution/spread costs before entering. npm run dev tsup --watch npm run build build dist/index.js npm run build:mcpb build + pack dist-mcpb/xcreener.mcpb npm run lint npm run typecheck The build produces a single bundled ESM file dist/index.js with all dependencies inlined via tsup, so both the npm package and the .mcpb bundle ship without node modules . MIT — see LICENSE /xcreener/xcreener-mcp/blob/main/LICENSE .