XCREENER — Claude Code MCP server: what it does, how to install
Screens crypto, forex, indices, commodities, and metals via XQL queries directly from your coding assistant.
claude mcp add xcreener-mcp -e XCREENER_API_KEY=<XCREENER_API_KEY> -- npx -y @xcreener/mcpWhat XCREENER does
This stdio bridge links coding clients to the XCREENER market scanning API. It registers four tools: xql_validate to parse queries without touching real data, xql_explain to inspect the plan, xql_run to fetch matching tickers from live feeds, and xql_nl_reference. The assistant reads the reference tool to turn conversational trading prompts into valid XQL queries.
Running any query requires an API key in the XCREENER_API_KEY variable from xcreener.com/account/api-key. Verification happens lazily: the process will start up cleanly even with an empty key, then throw an auth error as soon as you trigger an actual screen.
What it helps with
- filter oversold or overbought assets across multiple asset classes simultaneously
- rank currency strength across forex pairs without manual calculations
- validate and explain XQL syntax before hitting live market feeds
- identify trend direction and momentum for metals or commodities
Example prompts for the agent
- Check all markets to find any instruments oversold right now on the 1h timeframe
- Which currency is performing strongest and weakest across forex pairs this hour?
- Draft a trade plan for NZDUSD with stop loss below the 20-hour low
How to install XCREENER
Platform CLI
claude mcp add xcreener-mcp -e XCREENER_API_KEY=<XCREENER_API_KEY> -- npx -y @xcreener/mcpReplace <…> with your own values
Platform CLI
codex mcp add xcreener --env XCREENER_API_KEY=<XCREENER_API_KEY> -- npx -y @xcreener/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"xcreener": {
"command": "npx",
"args": [
"-y",
"@xcreener/mcp"
],
"env": {
"XCREENER_API_KEY": "<XCREENER_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"xcreener": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xcreener/mcp"
],
"env": {
"XCREENER_API_KEY": "<XCREENER_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e XCREENER_API_KEY=<XCREENER_API_KEY> xcreener npx -y @xcreener/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about XCREENER
How do I install XCREENER in Claude Code?
Run claude mcp add xcreener-mcp -e XCREENER_API_KEY=<XCREENER_API_KEY> -- npx -y @xcreener/mcp in your terminal.
What does the XCREENER MCP server do?
It lets MCP clients inspect and execute XQL queries against live market data for crypto, currencies, commodities, indices, and metals.
What happens if XCREENER_API_KEY is missing or wrong?
The process starts without crashing, but the first tool call will immediately fail with an authentication error.
