Skip to main content
Glama

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


Related MCP server: fathom-fyi

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
  1. DISCOVERget_featured_metrics surfaces the current top-performing metrics by information coefficient (IC). Start here.

  2. DEFINEanalyze_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").

  3. VALIDATE — The same tools return forward returns at 8 horizons (1d to 365d). The agent sees whether the thesis has edge, not just vibes.

  4. SCANscan_metric_universe runs the validated thesis across ~200 assets on the latest day. Which assets match the conditions right now?

  5. STOREfork_signal persists the thesis as a new inactive signal variant. The daily pipeline will track it forever.

  6. 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).


License

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cryptyx-ai/cryptyx-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server