AlgoVault

crypto-quant-signal-mcp

AlgoVault is the brain layer for AI trading agents โ€” one MCP call returns verdict, confidence, and regime across major crypto perpetual venues.

91.2% PFE win rate across 764,026+ verified calls. Merkle-verified on Base L2. Don't trust โ€” verify.

200 free calls/month, 100/day. Start in 30 seconds.

๐Ÿค– Try Free in Telegram ยท algovault.com ยท Live Track Record ยท How it works ยท Sign Up ยท Docs

npm version npm downloads MIT On-Chain Verified ERC-8004 Verified Agent GitHub Repo stars

--- ## 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](https://github.com/modelcontextprotocol) client connects directly. **1. Add the connector.** In Claude โ†’ Settings โ†’ Connectors โ†’ Add custom connector: | Field | Value | |---|---| | Name | `Crypto Quant Signal` | | URL | `https://api.algovault.com/mcp` | ![Add Connector](https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/docs/screenshots/Add-Connector.png) **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](https://raw.githubusercontent.com/AlgoVaultLabs/crypto-quant-signal-mcp/main/docs/screenshots/BTC-trade-call.png) Your Claude now has a quant analyst built in. Prefer local? Run `npx -y crypto-quant-signal-mcp`. > Running locally on npm 12+? npm v12 disables dependency install scripts by default. AlgoVault's optional local SQLite mode uses the native `better-sqlite3` module โ€” if you install it into a project, run `npm approve-scripts` (or `npm install --allow-scripts`) to build it. The hosted HTTP transport (`api.algovault.com/mcp`) needs no local build. --- ## 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. Every call reports market regime โ€” trending, ranging, or volatile โ€” alongside direction and confidence. Directional calls fire only when conviction clears the threshold; roughly 99% of evaluations return HOLD. ```json { "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.30.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.2% PFE Win Rate ยท 764,026 trade calls ยท 162 on-chain batches

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](https://algovault.com/track-record) - **Merkle batch verifier** โ€” [algovault.com/verify](https://algovault.com/verify) - **Anchor contract on Base L2** โ€” [`0x6485โ€ฆ0f81`](https://basescan.org/address/0x6485396ac981fe0a58540dfbf3e730f6f7bcbf81) - **All batches (raw JSON)** โ€” [api.algovault.com/api/merkle-batches](https://api.algovault.com/api/merkle-batches) AlgoVault is also a verified agent on the ERC-8004 Identity Registry (Base L2), agentId [`44544`](https://basescan.org/token/0x8004A169FB4a3325136EB29fA0ceB6D2e539a432?a=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 โ†’ Connectors โ†’ 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`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/langchain.md) | [`examples/langchain/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/langchain/demo.py) | [algovault.com/integrations/langchain](https://algovault.com/integrations/langchain) | | **LlamaIndex** | [`docs/integrations/llamaindex.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/llamaindex.md) | [`examples/llamaindex/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/llamaindex/demo.py) | [algovault.com/integrations/llamaindex](https://algovault.com/integrations/llamaindex) | | **Microsoft Agent Framework** | [`docs/integrations/maf.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/maf.md) | [`examples/maf/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/maf/demo.py) | [algovault.com/integrations/maf](https://algovault.com/integrations/maf) | | **CrewAI** | [`docs/integrations/crewai.md`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/docs/integrations/crewai.md) | [`examples/crewai/demo.py`](https://github.com/AlgoVaultLabs/algovault-skills/blob/main/examples/crewai/demo.py) | [algovault.com/integrations/crewai](https://algovault.com/integrations/crewai) | Each demo is runnable as `python examples//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. For Binance, the Agent OS path is the recommended default for new integrations โ€” OAuth at connect time, no API keys on the machine; the key-based kit remains right for custom order types. | # | Exchange | Tutorial | Demo | Mirror | |---|---|---|---|---| | 01 | Binance | [`docs/integrations/binance.md`](docs/integrations/binance.md) | [`examples/binance/demo.mjs`](examples/binance/demo.mjs) | [algovault.com/docs/integrations/binance](https://algovault.com/docs/integrations/binance) | | 02 | OKX | [`docs/integrations/okx.md`](docs/integrations/okx.md) | [`examples/okx/demo.mjs`](examples/okx/demo.mjs) | [algovault.com/docs/integrations/okx](https://algovault.com/docs/integrations/okx) | | 03 | Bybit | [`docs/integrations/bybit.md`](docs/integrations/bybit.md) | [`examples/bybit/demo.mjs`](examples/bybit/demo.mjs) | [algovault.com/docs/integrations/bybit](https://algovault.com/docs/integrations/bybit) | | 04 | Bitget | [`docs/integrations/bitget.md`](docs/integrations/bitget.md) | [`examples/bitget/demo.mjs`](examples/bitget/demo.mjs) | [algovault.com/docs/integrations/bitget](https://algovault.com/docs/integrations/bitget) | | 05 | Hyperliquid | [`docs/integrations/hyperliquid.md`](docs/integrations/hyperliquid.md) | [`examples/hyperliquid/demo.mjs`](examples/hyperliquid/demo.mjs) | [algovault.com/docs/integrations/hyperliquid](https://algovault.com/integrations/hyperliquid) | | 06 | Aster | [`docs/integrations/aster.md`](docs/integrations/aster.md) | [`examples/aster/demo.mjs`](examples/aster/demo.mjs) | [algovault.com/docs/integrations/aster](https://algovault.com/integrations/aster) | | 07 | BingX | [`docs/integrations/bingx.md`](docs/integrations/bingx.md) | [`examples/bingx/demo.mjs`](examples/bingx/demo.mjs) | [algovault.com/docs/integrations/bingx](https://algovault.com/integrations/bingx) | | 08 | KuCoin | [`docs/integrations/kucoin.md`](docs/integrations/kucoin.md) | [`examples/kucoin/demo.mjs`](examples/kucoin/demo.mjs) | [algovault.com/docs/integrations/kucoin](https://algovault.com/integrations/kucoin) | | 09 | Gemini | [`docs/integrations/gemini.md`](docs/integrations/gemini.md) | [`examples/gemini/demo.mjs`](examples/gemini/demo.mjs) | [algovault.com/docs/integrations/gemini](https://algovault.com/integrations/gemini) | | 10 | Kraken | [`docs/integrations/kraken.md`](docs/integrations/kraken.md) | [`examples/kraken/demo.mjs`](examples/kraken/demo.mjs) | [algovault.com/docs/integrations/kraken](https://algovault.com/integrations/kraken) | | 11 | Alpaca | [`docs/integrations/alpaca.md`](docs/integrations/alpaca.md) | [`examples/alpaca/demo.mjs`](examples/alpaca/demo.mjs) | [algovault.com/docs/integrations/alpaca](https://algovault.com/integrations/alpaca) | | 12 | Gate.io | [`docs/integrations/gateio.md`](docs/integrations/gateio.md) | [`examples/gateio/demo.mjs`](examples/gateio/demo.mjs) | [algovault.com/docs/integrations/gateio](https://algovault.com/integrations/gateio) | | 13 | Binance Agent OS | [`docs/integrations/exchange-kits/binance-agent-os.md`](docs/integrations/exchange-kits/binance-agent-os.md) | โ€” | [algovault.com/integrations/binance-agent-os](https://algovault.com/integrations/binance-agent-os) | --- ## 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 across 7 venues (Hyperliquid, Binance, Bybit, Gate, KuCoin, Aster, OKX), 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. - **`get_track_record`** โ€” the published track record as a tool call, for clients that bridge tools but not resources. `include` opens the per-asset, per-venue and recent-call sections. 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](https://algovault.com/docs.html). ### 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](https://algovault.com/skills).
Show all 20 Skills | # | Slug | Name | Difficulty | Tools | |---|---|---|---|---| | 01 | [`quick-btc-check`](skills/quick-btc-check/SKILL.md) | Quick BTC Check | Beginner | `get_trade_signal` | | 02 | [`portfolio-scanner`](skills/portfolio-scanner/SKILL.md) | Portfolio Scanner | Intermediate | `get_trade_signal` | | 03 | [`regime-aware-trading`](skills/regime-aware-trading/SKILL.md) | Regime-Aware Trading | Intermediate | `get_market_regime`, `get_trade_signal` | | 04 | [`funding-arb-monitor`](skills/funding-arb-monitor/SKILL.md) | Funding Arb Monitor | Intermediate | `scan_funding_arb` | | 05 | [`full-3-tool-pipeline`](skills/full-3-tool-pipeline/SKILL.md) | Full 3-Tool Pipeline | Advanced | `get_market_regime`, `get_trade_signal`, `scan_funding_arb` | | 06 | [`multi-timeframe-confirmation`](skills/multi-timeframe-confirmation/SKILL.md) | Multi-Timeframe Confirmation | Advanced | `get_trade_signal` | | 07 | [`tradfi-rotation`](skills/tradfi-rotation/SKILL.md) | TradFi Rotation | Advanced | `get_market_regime`, `get_trade_signal` | | 08 | [`risk-gated-entry`](skills/risk-gated-entry/SKILL.md) | Risk-Gated Entry | Advanced | `get_market_regime`, `get_trade_signal` | | 09 | [`funding-sentiment-dashboard`](skills/funding-sentiment-dashboard/SKILL.md) | Funding Sentiment Dashboard | Advanced | `get_market_regime` | | 10 | [`contrarian-meme-scanner`](skills/contrarian-meme-scanner/SKILL.md) | Contrarian Meme Scanner | Advanced | `get_market_regime`, `get_trade_signal` | | 11 | [`divergence-detector`](skills/divergence-detector/SKILL.md) | Divergence Detector | Advanced | `get_market_regime`, `get_trade_signal` | | 12 | [`hourly-digest-bot`](skills/hourly-digest-bot/SKILL.md) | Hourly Digest Bot | Advanced | `get_trade_signal`, `get_market_regime` | | 13 | [`hedging-advisor`](skills/hedging-advisor/SKILL.md) | Hedging Advisor | Advanced | `get_market_regime`, `get_trade_signal`, `scan_funding_arb` | | 14 | [`volatility-breakout-watch`](skills/volatility-breakout-watch/SKILL.md) | Volatility Breakout Watch | Advanced | `get_market_regime`, `get_trade_signal` | | 15 | [`cross-asset-correlation`](skills/cross-asset-correlation/SKILL.md) | Cross-Asset Correlation | Advanced | `get_trade_signal` | | 16 | [`funding-cash-and-carry`](skills/funding-cash-and-carry/SKILL.md) | Funding Cash-and-Carry | Advanced | `scan_funding_arb`, `get_trade_signal` | | 17 | [`weekend-vs-weekday-patterns`](skills/weekend-vs-weekday-patterns/SKILL.md) | Weekend vs Weekday Patterns | Research | `get_trade_signal`, `get_market_regime` | | 18 | [`agent-portfolio-rebalance`](skills/agent-portfolio-rebalance/SKILL.md) | Agent Portfolio Rebalance | Advanced | `get_market_regime` | | 19 | [`smart-dca-bot`](skills/smart-dca-bot/SKILL.md) | Smart DCA Bot | Advanced | `get_trade_signal` | | 20 | [`multi-agent-war-room`](skills/multi-agent-war-room/SKILL.md) | Multi-Agent War Room | Expert | `get_market_regime`, `get_trade_signal`, `scan_funding_arb` |
--- ## Pricing Quota-only tiers. Every tier gets all venues, all assets, all timeframes โ€” you pay for call volume, nothing else. Two meters per paid tier, monthly and daily, enforced independently: a call is refused when either is exhausted, and the daily window is a UTC calendar day resetting at 00:00 UTC. Quota is counted per call, regardless of verdict. | Feature | Free | Starter ($9.99/mo ยท $39.90/6mo) | Pro ($49/mo ยท $129/6mo) | Enterprise (contact us) | x402 (per call) | |---------|------|-------------------|-------------|---------------------|-----------------| | Exchanges | All 15 | All 15 | All 15 | All 15 | All 15 | | 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 | 200/mo | 10,000/mo | 100,000/mo | Custom volume โ€” contact us | Unlimited | | Daily calls | 100/day | 1,000/day | 10,000/day | Custom volume โ€” contact us | Unlimited | | Price | $0 | $9.99/mo or $39.90/6mo | $49/mo or $129/6mo | Contact us | $0.01โ€“0.05/call | **Subscriptions:** Sign up at [api.algovault.com/signup](https://api.algovault.com/signup). Starter unlocks 10,000 calls/mo (up to 1,000/day) for $9.99/mo, or $39.90 for six months prepaid โ€” add `?interval=6month` to pick the prepay term. API key delivered instantly after checkout. Pro 6-month is currently $129 โ€” limited-time pricing; subscribe now and renewals keep your price. **x402 micropayments:** AI agents pay per HTTP call with USDC on [Base](https://www.base.org) โ€” no signup, no API key, no billing. The payment receipt is the credential. See [x402.org](https://x402.org). --- ## What's new in v1.30.0 - **๐Ÿ”‘ Your key, one click away.** Every tool response that carries an auth block now returns `claim_url` and `claim_hint` in the `_algovault` envelope โ€” a direct link to keep the key you are already using, and a heads-up before you reach the cap. - **๐Ÿ’ต Six-month pricing is machine-readable.** `GET /api/plans/public` gains `price_usd_6month` on every tier, so a client can render prepay pricing instead of hardcoding it. - **๐Ÿค Enterprise is quoted, not published.** The plans endpoint now returns `null` for Enterprise price and limits rather than a fixed figure. No key was removed โ€” the values are null. **Upgrading from v1.29.x** โ€” nothing breaking, but one value changed: if you rendered an Enterprise price from `GET /api/plans/public`, it is now `null` and Enterprise is quoted directly. Every tier key is still present. Two response fields were added, no tool was added or renamed. ### v1.29.x highlights (recap) - **๐Ÿ“Š The track record is a tool, not only a resource.** `get_track_record` returns the same verified aggregate as `performance://signal-performance`, so a harness that bridges tools but not resources can read it. - **โœ‹ HOLD means HOLD.** When a book is not currently trading, the call returns HOLD instead of a direction, and the reasoning says so and says when it resumes. - **๐Ÿ”“ Allowances are machine-readable.** `GET /api/plans/public` returns the current free and paid call limits, unauthenticated. ### v1.28.x highlights (recap) - **๐Ÿ” Authentication tells you what happened.** Every response carries `_algovault.auth`. A well-formed but unrecognised key is refused instead of being quietly served free-tier data, and "malformed", "unknown" and "we couldn't verify" are three distinct outcomes. - **๐Ÿ“˜ Two parameters that were always there, now documented.** `assetClass` on the trade-call tools and `minLiquidityUsd` on `scan_trade_calls`, both projected from the live schema so the docs cannot drift from the server. - **๐Ÿค Pair with [Binance Agent OS](https://algovault.com/integrations/binance-agent-os).** One MCP client, two servers: AlgoVault returns the verdict, Binance Agent OS executes it. OAuth at connect time โ€” no API keys on your machine, and trading confined to a sub-account you fund yourself. > **Refresh your MCP client to pick up this release.** MCP clients cache `tools/list` at session start โ€” Claude.ai/Desktop: toggle the connector off+on; Cursor/Cline: restart the MCP server connection. --- ## 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](https://api.algovault.com/privacy). ## 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