MCP.Market

XCREENER MCP server

by xcreener.com·com.xcreener/xcreener-mcp·v0.2.1·1 stars
No reviews yet

Local stdio MCP bridge for XCREENER's XQL screener API — validate, explain, and run queries.

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
Growing

1 stars25 downloads/wk

Reviews

Write one

Nobody has reviewed XCREENER yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

XCREENER tools (4, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • xql_explain

    Parse and plan an XQL query, returning its execution plan and a human-readable explanation.

  • xql_nl_reference

    Fetch the XQL natural-language reference document, mapping retail-trader phrasing to valid XQL syntax and documenting hard limits (300-bar lookback ceiling, closed market/timeframe enums, the atr no-source-argument exception, etc.). Call this before writing a query, or after xql_validate/xql_explain/xql_run returns isError: true, to see the exact construct you likely got wrong.

  • xql_runwrite action

    Parse, plan, and execute an XQL query against live market data, returning matching instruments. Call xql_validate on the query first to catch syntax errors before spending a live-data round trip on this call.

  • xql_validate

    Validate XQL query text by parsing and planning it, without executing it against live data.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

1 medium
  • Code scan2 source files scanned20/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 41 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; website matches verified namespace9/10

Findings (1)

  • mediumeval / new Function usedexec.eval
    dist/index.js: …ode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How XCREENER compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 38% of 48,255 servers
Tools
4
the typical server has 7
Tools that change things
25%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,688 servers
Downloads a week
25
more than 11% of 12,191 servers with a package

What its tools let an agent do: 3 read · 1 change

Install XCREENER in Claude Code, Cursor or VS Code

Runs npx -y @xcreener/mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add xcreener-mcp -- npx -y @xcreener/mcp
Add to Cursor

What the publisher says

From the XCREENER repository's README, as published. We do not edit it. Read it on GitHub

@xcreener/mcp

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.

About XCREENER

XCREENER 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.

What this MCP server does

This package is the local stdio bridge to XCREENER's XQL API specifically. It exposes xqlvalidate, xqlexplain, xqlrun, and xqlnl_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.

Installation

Claude Desktop (.mcpb)

Download the latest xcreener.mcpb from this repo's 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.

Other MCP clients (npx)

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" }
    }
  }
}

From source

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 XCREENERAPIKEY set in its environment.

Configuration

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.

Available tools

Example session

Under the hood, the assistant calls the xqlnlreference tool, translates your plain-English ask into an XQL query, and calls xqlvalidate/xqlrun — what you see is just the human-visible conversation. A few real examples:

Multi-market screen

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

XCREENER: common questions

Is XCREENER MCP server safe?
Mostly: it is graded B (72/100). Read the XCREENER safety report
How do I install XCREENER?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does XCREENER need an API key?
Yes. The registry entry asks for XCREENER_API_KEY.
Is XCREENER maintained?
The last commit was 82 days ago (2026-08-13). The latest release is v0.2.1.
How does XCREENER compare with other MCP servers?
safety score 72/100 (higher than 38% of 48,255 servers); tools 4 (the typical server has 7); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.