settings— hook

<p align="center"> <a href="https://algovault.com"> <img src="https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/logo.png" alt="AlgoVault" width="120" /> </a> </p>

<h1 align="center">crypto-quant-signal-mcp</h1>

<p align="center"> <strong>AlgoVault is the brain layer for AI trading agents — one MCP call returns verdict, confidence, and regime across major crypto perpetual venues.</strong> </p>

<p align="center"> <span data-tr-field="pfe_wr">91.3</span>% PFE win rate across <span data-tr-field="total_calls">134,276</span>+ verified calls. Merkle-verified on Base L2. Don't trust — verify. <!-- SNAPSHOT-LINE --> </p>

<p align="center"> <strong>100 free calls/month. HOLDs never cost. Start in 30 seconds.</strong> </p>

<p align="center"> <a href="https://t.me/algovaultofficialbot"><strong>🤖 Try Free in Telegram</strong></a> · <a href="https://algovault.com"><strong>algovault.com</strong></a> · <a href="https://algovault.com/track-record"><strong>Live Track Record</strong></a> · <a href="https://algovault.com/how-it-works"><strong>How it works</strong></a> · <a href="https://api.algovault.com/signup"><strong>Sign Up</strong></a> · <a href="https://algovault.com/docs.html"><strong>Docs</strong></a> </p>

<p align="center"> <a href="https://www.npmjs.com/package/crypto-quant-signal-mcp"><img src="https://img.shields.io/npm/v/crypto-quant-signal-mcp" alt="npm version" /></a> <a href="https://www.npmjs.com/package/crypto-quant-signal-mcp"><img src="https://img.shields.io/npm/dw/crypto-quant-signal-mcp" alt="npm downloads" /></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT" /></a> <a href="https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81"><img src="https://img.shields.io/badge/Track_Record-On--Chain_Verified-blue?logo=ethereum" alt="On-Chain Verified" /></a> <a href="https://basescan.org/token/0x8004A169FB4a3325136EB29fA0ceB6D2e539a432?a=44544"><img src="https://img.shields.io/badge/ERC--8004-Verified_Agent-8A2BE2?logo=ethereum" alt="ERC-8004 Verified Agent" /></a> <a href="https://github.com/AlgoVaultLabs/crypto-quant-signal-mcp"><img src="https://img.shields.io/github/stars/AlgoVaultLabs/crypto-quant-signal-mcp?style=social" alt="GitHub Repo stars" /></a> </p>

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:

2. Ask for a call. In plain language:

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

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

What one call returns

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

<!-- SoT: this README is the single canonical source. The data-tr-field numbers below are auto-injected from live /api/performance-public + /api/merkle-batches by scripts/snapshot-landing-data.mjs at npm-publish + Hetzner-deploy. Do NOT hand-edit the numbers; edit "What's new" by hand. Wired by OPS-NPM-README-SINGLE-SOT-W1 (2026-05-31). --> <p align="center"> <strong><span data-tr-field="pfe_wr">91.3</span>% PFE Win Rate</strong> · <strong><span data-tr-field="total_calls">134,276</span> trade calls</strong> · <strong><span data-tr-field="merkle_batches">50</span> on-chain batches</strong> · <strong><span data-tr-field="hold_rate">98.9</span>% HOLD rate</strong> <!-- SNAPSHOT-LINE --> </p>

<p align="center"> Every call is hashed at emission and anchored on <a href="https://docs.base.org">Base L2</a> in daily Merkle batches. We cannot edit history. </p>

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.

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

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.

<!-- BUILD:README_INTEGRATIONS_TABLE -->

<!-- /BUILD:README_INTEGRATIONS_TABLE -->

Tools & resources

The MCP tools live at https://api.algovault.com/mcp. Every asset works across the full supported timeframe range, on major crypto perpetual 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.

<details> <summary><strong>Show all 20 Skills</strong></summary>

<!-- BUILD:README_SKILLS_TABLE -->

<!-- /BUILD:README_SKILLS_TABLE -->

</details>

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.

\* 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.1

Live since 2026-06-05:

• 🔌 Three new exchange pairings: Gemini, Kraken, Alpaca. Step-by-step tutorials + runnable keyless demos that wire AlgoVault's analysis into each venue's own MCP execution kit — built for autonomous trading agents. AlgoVault calls the trade (composite verdict, market regime, and the scan_trade_calls market sweep); the venue executes. Browse them at algovault.com/integrations; tutorials live in algovault-skills.
• 🤖 Same drop-in pattern across every venue. ≤5 minutes to a runnable demo, testnet/demo only — zero real-money risk. AlgoVault stays the analysis layer; your agent and the venue handle execution.

v1.20.0 highlights (recap)

• 📡 `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.

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.

<p align="center"> Built by <a href="https://algovault.com"><strong>AlgoVault Labs</strong></a><br/> <a href="https://algovault.com">algovault.com</a> · <a href="https://algovault.com/how-it-works">how it works</a> · <a href="https://algovault.com/track-record">track-record</a> · <a href="https://api.algovault.com/mcp">MCP endpoint</a> · <a href="https://t.me/algovaultofficialbot">Telegram bot</a> </p>