<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">90.6%</span> PFE win rate across <span data-tr-field="total_calls">1,264,950</span>+ verified calls. Merkle-verified on Base L2. Don't trust — verify. <!-- SNAPSHOT-LINE -->
</p>

<p align="center">
  <strong>200 free calls/month, 100/day. 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://github.com/AlgoVaultLabs/crypto-quant-signal-mcp/blob/main/LICENSE"><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>
  <a href="https://mcpqueen.com/s/io.github.AlgoVaultFi/crypto-quant-signal-mcp"><img src="https://mcpqueen.com/badge/io.github.AlgoVaultFi/crypto-quant-signal-mcp.svg" alt="MCP Queen operational grade" /></a>
</p>

---

## Quick start (30 seconds)

No code. No install. No API key to start — sign in free when you need more. 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 → Customize → Connectors → + → Add custom connector:

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

If Claude asks how to sign in, choose **Sign in when needed**. When Claude asks, click **Connect** and sign in with your email.

![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": []
  }
}
```

The `_algovault` block is the envelope every tool response carries: the server version, the tool that answered, your quota, and `compatible_with` — the companion packages that accept this object directly. It projects from a machine-verified registry, so it lists a package only once that package is published and runnable. It is `[]` today, and that is the truthful answer: there is no companion package yet.

---

## 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">90.6%</span> PFE Win Rate</strong> · <strong><span data-tr-field="total_calls">1,264,950</span> trade calls</strong> · <strong><span data-tr-field="merkle_batches">206</span> on-chain batches</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](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.**

<!-- MCP_CLIENTS_README_TABLE:start -->
| Client | Config |
|---|---|
| **Claude Desktop** | Customize → Connectors → + → Add custom connector → `https://api.algovault.com/mcp` |
| **Claude Code** (CLI) | `claude mcp add --transport http crypto-quant-signal https://api.algovault.com/mcp` |
| **Cursor** | `~/.cursor/mcp.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` |
<!-- MCP_CLIENTS_README_TABLE:end -->

**Agent plugin hosts.** The npm package ships `plugin.json`, `mcp.json` and `.cursor-plugin/plugin.json`, so an Agent-Plugins-compatible host — Cursor included — can read the server definition out of the installed package instead of being handed a config block to paste.

**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/<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. 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.

<!-- BUILD:README_INTEGRATIONS_TABLE -->
| # | 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) |
<!-- /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`** <sub>(alias `get_trade_signal`)</sub> — 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_market_regimes`** — screens a whole venue by market regime in one call: every coin whose regime matches your filter, with confidence and how long the regime has held. One call per returned row (at least one per request); coins that don't match are free.
- **`pre_trade_check`** — checks an order against your own rules before you place it: each rule passes or fails with its numbers, then GO, CAUTION or WAIT, with isolated liquidation per venue against your stop. Read-only: it places no orders.
- **`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).

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

<!-- BUILD:README_SKILLS_TABLE -->
| # | 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` |
<!-- /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.

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 | <!-- SNAPSHOT-LINE-TABLE -->
| Assets | All 740+ | All 740+ | All 740+ | All 740+ | All 740+ | <!-- SNAPSHOT-LINE-TABLE -->
| 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.33.0

- **🛡️ Check an order against your own rules before you place it.** `pre_trade_check` takes the order you intend to place and your limits (maximum leverage, loss at your stop, accuracy needed to break even, funding) and returns each rule's pass or fail with its numbers, then GO, CAUTION or WAIT. It also shows where isolated liquidation sits on each venue that publishes its margin tiers, and whether it hits before your stop.
- **🔐 Sign in from inside Claude.** Add AlgoVault as a custom connector and choose Sign in when needed. When Claude asks, click Connect and sign in with your email. On a paid plan, sign in with your subscription email and your plan applies.

**Upgrading from v1.32.x** — one tool was added, `pre_trade_check`; no tool or parameter was renamed or removed. A call with an argument the tool doesn't take is now refused, unbilled, and the refusal names the valid parameters; the published schemas never allowed extra arguments. Added AlgoVault in Claude before? Remove it and add it again, choosing Sign in when needed.

### v1.32.x highlights (recap)

- **🧭 Screen a whole venue by market regime in one call.** `scan_market_regimes` returns every coin whose regime matches your filter — TRENDING_UP, TRENDING_DOWN, RANGING or VOLATILE — with confidence, trend strength, ADX, volatility ratio and how long the regime has held. Filter by regime, confidence, asset class, liquidity, regime age or your own watchlist, then sort by confidence or by the newest regime change. You pay one call per returned row (at least one per request); coins that don't match are free. A venue or timeframe it can't serve right now is refused with the alternatives, and isn't billed. The screener is served from the hosted endpoint; a local install lists it and refuses the call with a pointer there.

**Upgrading from v1.31.x** — additive. One tool was added, `scan_market_regimes`; no tool or parameter was renamed or removed. `GET /api/plans/public` gains two blocks under `free`: `keyless` (the allowance without a key) and `telegram` (the Telegram bot's own allowance, counted in alerts). One free-tier allowance changed: 20 calls a month without a key; a free key gives 200 (up to 100/day).

### v1.31.x highlights (recap)

- **🧩 Install from the package, not from a pasted config block.** `plugin.json`, `mcp.json` and `.cursor-plugin/plugin.json` now ship inside the npm tarball, so an Agent-Plugins-compatible host — Cursor included — reads the server definition straight out of the installed package. Until this release those files lived in the repository only, and no npm consumer could obtain them.

- **v1.31.1** — Trade-call verdicts are now chosen by one declared rule per timeframe and trend direction, instead of a global mode setting. The calls you receive are unchanged by the switch.

**Upgrading from v1.30.x** — one value in the response envelope changed: `_algovault.compatible_with` is now `[]` and names no companion package. If your client rendered those package names, stop rendering them; there is no companion package published today. Nothing else in the envelope changed, and no tool or parameter was added, renamed or removed.

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

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