README.md

June 5, 2026 · View on GitHub

crypto-quant-signal-mcp

AlgoVault is the brain layer for AI trading agents — one MCP call returns verdict, confidence, and regime across 5 perp venues.

91.3% PFE win rate across 134,276+ verified calls. Merkle-verified on Base L2. Don't trust — verify.

100 free calls/month. HOLDs never cost. Start in 30 seconds.

🤖 Try Free in Telegram · algovault.com · Live Track Record · How it works · Sign Up · Docs

Quick start (30 seconds)

No code. No API key. No install. The server speaks Streamable HTTP at https://api.algovault.com/mcp — any Model Context Protocol client connects directly.

1. Add the connector. In Claude → Settings → Integrations → Add custom connector:

Field	Value
Name	`Crypto Quant Signal`
URL	`https://api.algovault.com/mcp`

Add Connector

2. Ask for a call. In plain language:

"Get me a trade call for ETH on the 4h timeframe"

BTC trade call response — Binance, 1h

Your Claude now has a quant analyst built in. Prefer local? Run npx -y crypto-quant-signal-mcp.

One API call. One verdict. Not 8 raw indicators. get_trade_call returns a directional BUY / SELL / HOLD with a confidence score and the detected market regime — a composite verdict, not a data dump for your agent to interpret.

Under the hood, a self-tuning model fuses momentum, trend structure, derivatives positioning, open interest, and volume into one weighted call. Weights are calibrated from live trade outcomes, not textbook defaults. Regime filters suppress low-edge setups, so the engine stays silent unless the signal is clear.

{
  "call": "BUY",
  "confidence": 78,
  "price": 84250.50,
  "indicators": {
    "funding_rate": 0.0001,
    "funding_24h_avg": 0.00008,
    "funding_state": "NORMAL",
    "oi_change_pct": 2.4,
    "volume_24h": 2381602633,
    "trend_persistence": "HIGH",
    "breakout_pending": "INACTIVE"
  },
  "regime": "TRENDING_UP",
  "reasoning": "Trending regime, upward bias. Funding pressure mild. Volatility neither expanding nor compressed. Trend persistence elevated; momentum structure. Strong conviction from aligned signals.",
  "timestamp": 1712764800,
  "coin": "BTC",
  "timeframe": "1h",
  "also_see": [
    { "coin": "ETH", "timeframe": "1h", "confidence": 82 },
    { "coin": "SOL", "timeframe": "15m", "confidence": 73 }
  ],
  "_algovault": {
    "version": "1.20.0",
    "tool": "get_trade_call",
    "compatible_with": ["crypto-quant-risk-mcp", "crypto-quant-backtest-mcp"]
  }
}

The _algovault block makes outputs composable: downstream risk and backtest tools accept the object directly.

Live, verifiable track record

91.3% PFE Win Rate · 134,276 trade calls · 50 on-chain batches · 98.9% HOLD rate

Every call is hashed at emission and anchored on Base L2 in daily Merkle batches. We cannot edit history.

The full record is public and on-chain — no cherry-picking, no survivorship bias:

Live dashboard — algovault.com/track-record
Merkle batch verifier — algovault.com/verify
Anchor contract on Base L2 — 0x6485…0f81
All batches (raw JSON) — api.algovault.com/api/merkle-batches

AlgoVault is also a verified agent on the ERC-8004 Identity Registry (Base L2), agentId 44544 — a portable, on-chain handle AI orchestrators can resolve.

Works with your stack

AlgoVault is drop-in for every MCP-spec client, every major agent framework, and every official exchange Agent Trade Kit — no SDK, no wrapper. It serves Streamable HTTP at https://api.algovault.com/mcp; tools/list + resources/list is the API surface.

MCP clients.

Client	Config
Claude Desktop	Settings → Integrations → Add custom connector → `https://api.algovault.com/mcp`
Claude Code (CLI)	`claude mcp add crypto-quant-signal https://api.algovault.com/mcp`
Cursor	`~/.cursor/config.json` → `mcpServers` block → `url: "https://api.algovault.com/mcp"`
Cline	VS Code Cline extension → MCP server settings → add Streamable HTTP server
Codex (OpenAI CLI)	`~/.codex/config.toml` → `[mcp_servers.algovault]` table + `url = "https://api.algovault.com/mcp"` (or `codex mcp` CLI)
Windsurf	`~/.codeium/windsurf/mcp_config.json` → `mcpServers.algovault.serverUrl = "https://api.algovault.com/mcp"`
Continue.dev	`config.yaml` → `mcpServers: [{ name: algovault, type: streamable-http, url: "https://api.algovault.com/mcp" }]`
Any other MCP-spec-compliant client	Configure the Streamable HTTP transport with URL `https://api.algovault.com/mcp`

Agent frameworks. First-party tutorials pair AlgoVault with each framework's canonical MCP adapter — copy-pasteable demo code, no SDK.

Framework	Tutorial	Runnable demo	Mirror
LangChain	`docs/integrations/langchain.md`	`examples/langchain/demo.py`	algovault.com/integrations/langchain
LlamaIndex	`docs/integrations/llamaindex.md`	`examples/llamaindex/demo.py`	algovault.com/integrations/llamaindex
Microsoft Agent Framework	`docs/integrations/maf.md`	`examples/maf/demo.py`	algovault.com/integrations/maf
CrewAI	`docs/integrations/crewai.md`	`examples/crewai/demo.py`	algovault.com/integrations/crewai

Each demo is runnable as python examples/<framework>/demo.py BTC 4h — gets a real BUY/SELL/HOLD verdict from api.algovault.com/mcp, prints it. ≤5 minutes to first call.

Exchange Agent Trade Kits. AlgoVault returns the analytics; your agent's risk policy decides what to execute. All demos run testnet/demo only.

#	Exchange	Tutorial	Demo	Mirror
01	Binance	`docs/integrations/binance.md`	`examples/binance/demo.mjs`	algovault.com/integrations/binance
02	OKX	`docs/integrations/okx.md`	`examples/okx/demo.mjs`	algovault.com/integrations/okx
03	Bybit	`docs/integrations/bybit.md`	`examples/bybit/demo.mjs`	algovault.com/integrations/bybit
04	Bitget	`docs/integrations/bitget.md`	`examples/bitget/demo.mjs`	algovault.com/integrations/bitget

Tools & resources

The MCP tools live at https://api.algovault.com/mcp. Every asset works across all 11 timeframes (1m → 1d) on 5 perp venues.

get_trade_call _{(alias get_trade_signal)} — composite BUY/SELL/HOLD verdict with confidence + regime, any asset, any timeframe.
scan_trade_calls — scans the top-N perps by open interest on a venue; returns every actionable call in one shot.
scan_funding_arb — cross-venue funding-rate spreads, ranked. The only MCP server doing multi-exchange derivatives arbitrage.
get_market_regime — classifies TRENDING_UP / TRENDING_DOWN / RANGING / VOLATILE for strategy selection.
search_knowledge + chat_knowledge — free BM25 search and grounded Q&A over the full knowledge bundle.

Performance is exposed as a read-only MCP resource: performance://signal-performance (aggregated PFE win rate, never raw outcomes). Full parameter reference at algovault.com/docs.

Skills (20 ready-to-use Anthropic Agent Skills)

Single-prompt wrappers over 1–3 tool calls — regime gating, multi-timeframe consensus, funding-arb monitoring, and more. Install with claude plugin install AlgoVaultLabs/algovault-skills; browse at algovault.com/skills.

Show all 20 Skills

#	Slug	Name	Difficulty	Tools
01	`quick-btc-check`	Quick BTC Check	Beginner	`get_trade_call`
02	`portfolio-scanner`	Portfolio Scanner	Intermediate	`get_trade_call`
03	`regime-aware-trading`	Regime-Aware Trading	Intermediate	`get_market_regime`, `get_trade_call`
04	`funding-arb-monitor`	Funding Arb Monitor	Intermediate	`scan_funding_arb`
05	`full-3-tool-pipeline`	Full 3-Tool Pipeline	Advanced	`get_market_regime`, `get_trade_call`, `scan_funding_arb`
06	`multi-timeframe-confirmation`	Multi-Timeframe Confirmation	Advanced	`get_trade_call`
07	`tradfi-rotation`	TradFi Rotation	Advanced	`get_market_regime`, `get_trade_call`
08	`risk-gated-entry`	Risk-Gated Entry	Advanced	`get_market_regime`, `get_trade_call`
09	`funding-sentiment-dashboard`	Funding Sentiment Dashboard	Advanced	`get_market_regime`
10	`contrarian-meme-scanner`	Contrarian Meme Scanner	Advanced	`get_market_regime`, `get_trade_call`
11	`divergence-detector`	Divergence Detector	Advanced	`get_market_regime`, `get_trade_call`
12	`hourly-digest-bot`	Hourly Digest Bot	Advanced	`get_trade_call`, `get_market_regime`
13	`hedging-advisor`	Hedging Advisor	Advanced	`get_market_regime`, `get_trade_call`, `scan_funding_arb`
14	`volatility-breakout-watch`	Volatility Breakout Watch	Advanced	`get_market_regime`, `get_trade_call`
15	`cross-asset-correlation`	Cross-Asset Correlation	Advanced	`get_trade_call`
16	`funding-cash-and-carry`	Funding Cash-and-Carry	Advanced	`scan_funding_arb`, `get_trade_call`
17	`weekend-vs-weekday-patterns`	Weekend vs Weekday Patterns	Research	`get_trade_call`, `get_market_regime`
18	`agent-portfolio-rebalance`	Agent Portfolio Rebalance	Advanced	`get_market_regime`
19	`smart-dca-bot`	Smart DCA Bot	Advanced	`get_trade_call`
20	`multi-agent-war-room`	Multi-Agent War Room	Expert	`get_market_regime`, `get_trade_call`, `scan_funding_arb`

Pricing

Quota-only tiers. Every tier gets all venues, all assets, all timeframes — you pay for call volume, nothing else. HOLD verdicts are always free.

Feature	Free	Starter ($9.99/mo)	Pro ($49/mo)	Enterprise ($299/mo)	x402 (per call)
Exchanges	All 5	All 5	All 5	All 5	All 5
Assets	All 740+	All 740+	All 740+	All 740+	All 740+
Asset classes	Crypto + TradFi	Crypto + TradFi	Crypto + TradFi	Crypto + TradFi	Crypto + TradFi
Timeframes	All 11	All 11	All 11	All 11	All 11
Funding arb results	Top 5	Unlimited	Unlimited	Unlimited	Unlimited
Track record	Full access	Full access	Full access	Full access	Full access
Monthly calls	100/mo	3,000/mo	15,000/mo	100,000/mo	Unlimited
Support	Community	Email	Priority	Dedicated	—
Price	$0	$9.99/mo	$49/mo	$299/mo	$0.01–0.05/call
HOLD calls	Free	Free	Free	Free	Free

* HOLD verdicts (engine says "don't trade") are always free across all tiers — no x402 charge, no quota deduction. We only get paid when we see a tradeable opportunity.

Subscriptions: Sign up at api.algovault.com/signup. Starter ($9.99/mo) unlocks 3,000 calls/mo. API key delivered instantly after checkout.

x402 micropayments: AI agents pay per HTTP call with USDC on Base — no signup, no API key, no billing. The payment receipt is the credential. See x402.org.

What's new in v1.20.0

Live since 2026-06-04:

📡 scan_trade_calls — market-wide scanner. One call scans the top-N perps (1–100, ranked by open interest) on your chosen venue and returns every actionable BUY/SELL with confidence and regime. HOLDs stay free — quota counts only actionable calls.
🔔 Webhooks: dynamic top:N watchlists. Subscribe with assets: ["top:25"] and your webhook follows the venue's top perps automatically. No manual list upkeep.
🏛️ TradFi-aware analysis. Both core tools now report the underlying market session (underlying_session, with weekend/holiday caveats), interpret fixed pre-IPO funding correctly, and aggregate cross-venue funding sentiment for stocks, indices, commodities, and FX across all 5 venues.
🧭 Smarter errors on young listings. Insufficient history returns a structured INSUFFICIENT_CANDLES error with suggested_timeframes instead of a plain string.

MCP clients cache tools/list at session start — toggle the connector off/on (or restart the MCP connection) to see scan_trade_calls.

v1.19.0 highlights (recap)

🔔 Webhook Delivery Service. Subscribe a URL; receive trade_call and regime_shift events as push, not poll. Payloads are HMAC-SHA256 signed, retried, and idempotent. Manage over HTTP: POST / GET / DELETE /api/webhooks, plus POST /api/webhooks/:id/test for a live test fire. API key required.
🔗 One-call signal verification. Every webhook payload carries a verify_url. Resolve it at GET /api/verify-signal?hash=<signal_hash> for that call's public, on-chain-anchored record.
🔌 Two more platform integration examples. The algovault-integrations mono-repo now ships 7 reference implementations — Hummingbot and FreqTrade join the existing five. New tiles on algovault.com/integrations.

→ Set up a webhook: algovault.com/integrations#webhooks · Webhook docs: docs/WEBHOOKS.md

v1.18.2 highlights (recap)

🔌 Two new platform integration examples. The algovault-integrations mono-repo now ships 5 reference implementations total (was 3 at v1.18.0):
- QuantDinger (reference-architecture doc) — cross-MCP IDE-mediated orchestration. AlgoVault MCP and QuantDinger MCP connect through the user's IDE (Claude Desktop / Cursor / Codex CLI); no transformer code.
- Cryptohopper (TypeScript) — Signaler webhook with HMAC-sha512 signed payloads. First HMAC-authed transport in the integrations repo.
🧭 "Connect Your Trading Platform" section added to algovault.com/integrations. Discoverable tiles for the 5 platform examples; "Why integrate with AlgoVault?" framing replaces the prior exchange-kit framing.

v1.18.0 highlights (recap)

⏱️ 3-minute timeframe goes LIVE on the public Live Track Record. The 3m card and Methodology > Evaluation Windows row are now visible at algovault.com/track-record. The 9th evaluated timeframe is live. (The 3m key shipped to /api/performance-public.byTimeframe in v1.16.0; v1.18.0 completes the dashboard-display chain.)
🔌 Platform integration examples. New public repo at github.com/AlgoVaultLabs/algovault-integrations ships reference implementations of the Verifiable-Signal v1.0 spec (introduced in v1.17.0). Three platforms in v1.18.0:
- AI4Trade (TypeScript) — REST POST with token-in-body auth.
- Nautilus Trader (Python) — Subclass of Nautilus's Data abstract base.
- 3Commas (TypeScript) — Signal Bot webhook via per-bot curry-pattern factory.

Upgrading from v1.19.x or earlier? The six original tools — get_trade_call, get_trade_signal, scan_funding_arb, get_market_regime, search_knowledge, chat_knowledge — keep their parameter shapes unchanged. v1.20.0 adds ONE new tool, scan_trade_calls (top-N market scanner), and additive output fields on the core tools (underlying_session, session_note, metrics.funding_by_venue) plus a structured INSUFFICIENT_CANDLES error — all backward-compatible. Because MCP clients (Claude Desktop, Cursor, Cline) cache tools/list at session start, reconnect (toggle the connector off/on) once to see scan_trade_calls; existing integrations keep working without changes.

Privacy

Local mode: zero telemetry — call history stays on your machine. Remote mode: request metadata logged for analytics (IP hashed, never stored raw). See the privacy policy.

License

MIT

Disclaimer: AlgoVault provides directional entry interpretation for AI agents. Exit timing is determined by your agent or strategy. This is not financial advice. Past performance does not guarantee future results.

Built by AlgoVault Labs
algovault.com · how it works · track-record · MCP endpoint · Telegram bot