@cryptyx/mcp-server

@cryptyx/mcp-server

CRYPTYX — the intelligence layer for digital assets.

Institutional-grade digital asset intelligence delivered via the Model Context Protocol and a human-facing CLI. CRYPTYX converts fragmented crypto telemetry into factor scores, signals, multi-factor backtests, and regime classifications — continuously compounding intelligence across hundreds of metrics, signals, and assets.

Not a data proxy. A quant research platform. 25 tools across 670+ metrics, 8 factor classes, 160 signals, 17 IC-weighted composites, ~200 tracked assets, and a daily-updating signal registry. Built for traders, funds, treasuries, researchers, and the agents that serve them.

Execution is complementary. Use CRYPTYX alongside exchange toolkits like OKX and Kraken: they execute, CRYPTYX provides the intelligence.

Install

MCP Server (for AI agents)

npx @cryptyx/mcp-server

CLI (for humans and scripts)

npx cryptyx --help

Or install globally:

npm install -g @cryptyx/mcp-server
cryptyx snapshot

Both entry points ship from the same package — one install, two interfaces.

CLI Quick Start

# Save your API key (persists to ~/.config/cryptyx/config.json)
cryptyx config set-key cx_your_api_key

# Full state snapshot — factor breadth, rankings, signal summary
cryptyx snapshot

# Market data for all assets
cryptyx market

# Factor scores for a single asset
cryptyx factors BTC

# Today's signal firings
cryptyx signals

# Top 10 signals by information coefficient
cryptyx signals top

# Backtest a signal over the last year
cryptyx signals backtest TR_WIN_RATE_60D_THR --from 2025-05-28 --to 2026-05-28

# Scan a metric across the universe for z-score extremes
cryptyx metrics scan VOL_RV_7D --operator gt --threshold 2

# Raw JSON output (pipe to jq, scripts, cron)
cryptyx market --json | jq '.[] | select(.composite_rank <= 10)'

Every command supports --json for raw output and --api-key / --api-url overrides.

CLI Commands

Command	Description
cryptyx snapshot	Full state snapshot: factor breadth, rankings, signal summary
cryptyx market	Asset universe with composite scores and returns
cryptyx signals	Today's active signal triggers
cryptyx signals top	Top 10 signals by 7d IC
cryptyx signals catalog	All signals with parameters and 30d stats
cryptyx signals explain SIG ASSET DAY	Why a signal fired (or didn't)
cryptyx signals backtest SIG --from --to	Signal backtest over date range
cryptyx signals fork SIG --params '{}'	Fork a signal with new parameters
cryptyx signals simulate SIG --key --value	Estimate trigger rate for threshold change
cryptyx factors ASSET	Factor t-scores across 8 classes
cryptyx regime ASSET	Regime classification with confidence
cryptyx macro-regime	Market-wide macro regime classification across all horizons
cryptyx divergences	Cross-factor divergence alerts (distribution, capitulation, ignition)
cryptyx pulse	Factor breadth across the universe
cryptyx prices	Live spot prices (15m refresh)
cryptyx price ASSET	Daily OHLCV candles
cryptyx assets	Full tracked universe with tags
cryptyx liquidity ASSET	Order book depth at 50/100/200bp
cryptyx metrics featured	Top metrics by IC
cryptyx metrics analyze METRIC ASSET --operator --threshold	Single-metric z-score backtest
cryptyx metrics scan METRIC --operator --threshold	Universe-wide z-score scan
cryptyx metrics composite ASSET --conditions '[...]'	Multi-factor intersection backtest
cryptyx competition	Competition leaderboard
cryptyx competition rounds	All competition rounds
cryptyx config set-key KEY	Save API key
cryptyx config show	Show current config
cryptyx config clear	Clear saved config

MCP Configuration

Claude Desktop

{
  "mcpServers": {
    "cryptyx": {
      "command": "npx",
      "args": ["@cryptyx/mcp-server"],
      "env": {
        "CRYPTYX_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add cryptyx -- npx @cryptyx/mcp-server
export CRYPTYX_API_KEY=cx_your_key

Remote HTTP (Claude.ai Connectors)

Endpoint:  https://cryptyx.ai/api/mcp
Transport: Streamable HTTP (JSON-RPC 2.0 over POST)
Auth:      Bearer token (cx_* API key)

Environment Variables

Variable	Required	Default	Description
CRYPTYX_API_KEY	Yes	—	API key from cryptyx.ai
CRYPTYX_API_URL	No	https://cryptyx.ai	Override for self-hosted deployments

The 6-step conviction loop

CRYPTYX is designed for a specific agentic workflow. Most tools map to a step in this loop:

DISCOVER  →  DEFINE  →  VALIDATE  →  SCAN  →  STORE  →  EXECUTE

• DISCOVER — get_featured_metrics surfaces the current top-performing metrics by information coefficient (IC). Start here.
• DEFINE — analyze_metric or analyze_metrics_composite lets the agent build a multi-factor thesis (e.g. "trend momentum z > 1.5 AND funding stress z > 2.0").
• VALIDATE — The same tools return forward returns at 8 horizons (1d to 365d). The agent sees whether the thesis has edge, not just vibes.
• SCAN — scan_metric_universe runs the validated thesis across ~200 assets on the latest day. Which assets match the conditions right now?
• STORE — fork_signal persists the thesis as a new inactive signal variant. The daily pipeline will track it forever.
• EXECUTE — CRYPTYX doesn't execute. Hand off to OKX, Kraken, or whatever execution layer your agent uses.

Tool reference (25 tools)

Factor discovery — the IP moat

The core value of CRYPTYX. These tools let the agent do real quantitative research against 670+ metrics across 8 factor classes.

Tool	What it does
get_featured_metrics	Top-performing metrics by information coefficient. Returns the 8 highest-conviction metrics with A/B grades. Best starting point.
get_asset_top_predictors	Per-asset predictive power — metrics ranked by time-series IC for a specific asset. Surfaces hidden alpha (CS Grade F but TS Grade A).
analyze_metric	Single-metric z-score backtest with forward returns across 8 horizons. The core factor discovery tool.
analyze_metrics_composite	Multi-factor intersection backtest. Define 2-4 metric conditions and see when ALL fire simultaneously, with forward returns at every horizon. This is where theses are born.
scan_metric_universe	Scan a metric across all ~200 assets for z-score extremes on the latest day. Ranked results with forward-return backtests at 1d/7d/30d.
get_factor_scores	Factor t-scores for an asset across 8 factor classes and multiple horizons.

Signal engine — parameterised conviction

A signal is a persistent, versioned, parameterised thesis. CRYPTYX ships with a catalog of active signals and lets agents backtest, fork, and tune them.

Tool	What it does
get_signal_triggers	Today's active signal firings across all assets. Atomic signals + composite rollups with confidence scores.
get_top_signals	Curated top 10 signals ranked by 7d information coefficient (IC). Pre-filtered to A/B health grade with proven predictive power.
get_signal_catalog	Full signal catalog with active parameters and 30-day trigger statistics.
get_signal_explanation	Structured explanation of why a specific signal fired (or didn't) for an asset on a given day. Returns factor scores and composite context.
backtest_signal	Backtest a signal over any date range. Returns per-day trigger counts + aggregate stats (trigger rate, avg confidence).
fork_signal	Create a new inactive parameter variant of an existing signal. The fork is tracked forever but doesn't affect the live signal. Human approval required to activate.
simulate_signal	Estimate the trigger rate if a signal threshold were changed — without making any changes. Cheap what-ifs.

Market intelligence — state of the universe

Tool	What it does
get_market_snapshot	Asset universe with composite scores, returns, rankings. Latest or time series.
get_market_pulse	Factor breadth across the universe. Shows how many assets are positive / negative / neutral per factor class.
get_composite_rankings	Full agent-optimised state snapshot: factor breadth, top/bottom rankings, signal summary, pipeline status. Ideal grounding context before reasoning.
get_regime_analysis	Current regime classification (trending, mean-reverting, volatile) with primary + secondary regime confidence scores.
get_macro_regime	Market-wide macro regime classification across all horizons. Returns regime label, confidence, breadth, and horizon alignment over time.
get_divergences	Cross-factor divergence alerts: distribution (bearish), capitulation (bullish), ignition (bullish). Detects when factor classes disagree — early warning of regime shifts.
get_price_history	Daily OHLCV candles for a single asset.
get_live_prices	15-minute refresh spot prices across all tracked assets.
search_assets	Full tracked universe with universe tags.

Execution context

Tool	What it does
get_asset_liquidity	Order book depth at 50 / 100 / 200 bp from mid, spot and optionally futures. Critical for sizing real-world execution.

CRYPTYX Challenge

An open, public leaderboard where AI trading agents compete using real CRYPTYX signals. Used by the community, and a great source of benchmarking context.

Tool	What it does
get_competition_rounds	List all competition rounds with rules, asset universe, and entry counts.
get_competition_leaderboard	Live leaderboard — ranked entries with Sharpe ratio, total return, max drawdown, composite score.

Factor classes

Code	Name	What it captures
CORR	Correlation	Cross-asset correlation dynamics, regime coupling
EFF	Efficiency	Market efficiency, mean reversion, trend exhaustion
FLOW	Flow	Capital flow, fund movement, stablecoin rotation
FUT	Futures	Derivatives positioning, funding rates, open interest, sentiment
OB	Order Book	Spot and futures depth, bid/ask imbalance, microstructure
OPT	Options	Implied volatility, skew, term structure (BTC/ETH scope)
TR	Trend	Price momentum, trend strength, regime transitions
VOL	Volatility	Realized and implied volatility dynamics, compression/expansion

Scale & data freshness

• 670+ metrics defined across 8 factor classes
• 160 signals (4 geometry types) + 17 IC-weighted composites
• ~200 digital assets tracked daily (target: 500+)
• 8 horizons: 1d, 7d, 14d, 30d, 60d, 90d, 180d, 365d
• Daily pipelines:
  • Metrics: 01:20 UTC
  • Signals: 02:27 UTC
  • Evaluation scorecards: 02:45 UTC
  • Agent optimisation: 03:00 UTC
• 15-minute refresh for spot prices and order book snapshots
• Weekly data source discovery agent scans 12+ providers for new signals

Example prompts

Build a thesis from scratch:

Use CRYPTYX to find the top metrics by IC, build a multi-factor thesis combining trend momentum with funding stress, backtest it on BTC, then scan the universe for assets matching both conditions today.

Explain a signal firing:

What signals fired today? Pick the highest-confidence one and explain why it fired on that specific asset.

Fork and tune:

Fork the TR_WIN_RATE_60D_THR signal with a stricter z_threshold of 2.5, backtest both versions over the last 90 days, and tell me which one has better IC.

Regime-aware position sizing:

For my top 10 composite assets, what's the current regime? Size positions inversely to volatility regime — larger in trending, smaller in volatile.

x402 Pay-Per-Call

CRYPTYX also supports the x402 protocol for pay-per-call access — no API key, no signup. Your agent pays in USDC on Base per request.

Agent → GET /api/signals/catalog → 402 Payment Required (price + wallet)
Agent → signs gasless USDC transfer → retries with X-PAYMENT header
Server → verifies via CDP facilitator → settles on-chain → returns data

49 endpoints across 4 tiers: $0.01 (market data, signals), $0.05 (backtesting, conviction), $0.10 (trade ideas), $0.25 (reports, custom composites).

• Pricing manifest: cryptyx.ai/.well-known/x402-manifest.json
• Documentation: cryptyx.ai/docs/x402
• Client SDK: x402 + viem

Links

• Homepage: cryptyx.ai
• Documentation: cryptyx.ai/docs/mcp
• Source: github.com/cryptyx-ai/cryptyx-mcp-server
• OpenAPI spec: cryptyx.ai/openapi.yaml
• AI plugin manifest: cryptyx.ai/.well-known/ai-plugin.json
• AI reference: cryptyx.ai/llms-full.txt
• Changelog: CHANGELOG.md

License

MIT