Get account information (equity, cash, buying power) from a broker.

broker_truth / live ops — open positions from a connected broker (flat check, exposure, unrealized P&L only). Use for 'am I flat', 'open positions', 'exposure'. Do NOT substitute web search or memory. unrealized_pnl ≠ realized session P&L.

broker_truth / live ops — working/open/closed orders from a connected broker. Use for 'working orders', 'pending orders'. Do NOT use web search.

broker_truth / live ops — unified portfolio across connected brokers (equity, positions, P&L). Use for owner 'today's P&L' / 'how did we do'. Do NOT invent numbers from web search or memory. Subscribers should use get_my_pnl / get_my_portfolio instead.

broker_truth / live ops — right-now bid/ask/last for a symbol from a connected broker. Use for 'MNQ price right now' / live quote. Do NOT scrape CME/Yahoo via web search. For historical OHLCV bars use data/backtest tools.

broker_truth / live ops — unified health for live futures bots (MNQ, CL, MES, NQ) and Kalshi: process up?, log mtime, last signal, regime, recent errors, token expiry, e2e_sentinel. Use for 'MNQ health check', 'is the bot running', 'bot status'. Do NOT use web search (CME/Yahoo) for bot liveness — that is market news, not AlgoChains processes. For live market price use get_quote. Pure read-only on control-tower host (logs/, state/, ps).

Hybrid (semantic + keyword + graph-traversal) search over the AlgoChains TEMPORAL knowledge graph (getzep/graphiti). Returns advisory facts with validity windows (valid_from/valid_to) extracted from REAL signal traces, debate transcripts, and Hive Brain synthesis. Use for 'what was true / what changed / what preceded what, over time' — e.g. 'MNQ behavior in trending regime'. agent_memory authority: ADVISORY ONLY, never broker truth (P&L/fills still require broker verification). Complements rag_search/onyx (semantic) and query_codegraph (structural). Fails closed with graphiti_unavailable.

Health probe for the Graphiti temporal knowledge-graph backend (Neo4j + graphiti-core, advisory/agent_memory). Reports provider, Neo4j URI, group_id, and reachability. Fails closed with graphiti_unavailable + recovery_command (per-host; not synced across machines).

Connect to a specific broker. Must be configured via environment variables.

Run the marketplace validation gates against reported strategy metrics (Sharpe, OOS trades, drawdown, win rate, MCPT). This is distinct from validate_strategy, which validates a StrategySpec schema.

Validate a StrategySpec for schema correctness, parameter ranges, and internal consistency.

Run a backtest on a StrategySpec using the Rust engine. Returns Sharpe, drawdown, win rate, P&L.

Run Optuna-based parameter optimization on a StrategySpec. Finds best params across n_trials.

BM25 search over all Massive market data API endpoints. Use this FIRST to find the right endpoint for stocks, options, futures, forex, crypto, or SEC filings.

Get parameter documentation for a Massive API endpoint. Pass the docs_url from massive_search_endpoints results.

Execute a Massive market data API call. Optionally store results as an in-memory DataFrame for SQL querying. Supports pagination auto-detection — check _next_page in results.

SQL queries over stored DataFrames from massive_call_api. Supports SHOW TABLES, DESCRIBE , DROP TABLE , and full SQL with JOIN/GROUP BY/window functions. Use apply for server-side Greeks and technicals.

Composable pipeline: search→fetch→store→query→apply in 1 call (saves 4 round-trips). Describe what data you want, optionally filter with SQL and apply Greeks/technicals.

Search for relevant AlgoChains tools using natural language. Returns the top-K most relevant tools with descriptions. Use this FIRST to find which tools are available for your task — 90%+ context reduction vs listing all 533 tools.

Get full details for a specific tool including its input schema, parameter types, and usage examples. Call after discover_tools to get the full spec before execution.

Execute any discovered tool by name with arguments. Use discover_tools first, then get_tool_details for the schema, then call this to execute. ORDER_EXEC and DESTRUCTIVE tools require owner_token and confirm=true inside arguments.

Return JSON manifest of all registered MCP tools with implementation_status (full|partial|stub), required env vars, and Tier-1 flags. Use for CI, Onyx indexing, and honest agent planning — call before relying on V8-V20 tools.

Transform a natural language trading intent into a concrete plan and execute it. Example: 'Get me $10K AI exposure, max 2% per stock'. Parses intent → solves constraints → presents plan for approval → executes.

Approve a pending intent plan for execution. The plan must be in 'pending_approval' status.

Create a shadow (paper) portfolio to forward-test a strategy without risking capital. Track P&L, fills, and metrics alongside your real portfolio.

Detect current market regime from VIX, SPY trend, breadth, and credit signals. Returns regime classification (bull/bear/range/volatile/crisis), recommended strategies, and risk multiplier for position sizing.

Run 13 pre-trade safety checks before placing an order. Checks position sizing, daily loss limits, drawdown, fat fingers, buying power, concentration, VIX killswitch, margin, correlation, and more. Returns ALLOW or BLOCK with reasons.

View current account protection settings including daily loss limits, drawdown thresholds, position size caps, VIX killswitch levels, and max positions.

Query AlgoChains data warehouses (Builder tier $199/mo). Access 3.09B+ rows: 409M crypto, 1.3B stocks, 1.4B forex minute bars. Returns OHLCV data for backtesting.

Start an AlgoClaw MCP-only agent session in an app-owned sandbox (path allowlist, no inherited broker/owner env, runtime quotas). Requires agent:sandbox scope. Fail closed without the scope.

Atomically reserve USD against the developer key's daily LLM budget (spend:llm_budget). Fail closed on ledger errors or exhaustion.

Validate a strategy for marketplace readiness. Tier-1 calls are dry-run unless LISTING_API_KEY is configured; staging then requires a verified local artifact path + SHA-256 that VirusTotal reports clean (Django scan-hash; 5 scans/person/day).

Compute full implied volatility surface from real Polygon options chain: IV per strike/expiry, 25-delta skew, term structure, IV rank (0-1), IV percentile, and vol regime (low/normal/elevated/extreme). Generates actionable signal: long_vol/short_vol/sell_skew/buy_skew.

Decompose a symbol's returns into Fama-French 5-factor + momentum exposures using real Polygon daily data. Returns alpha, market beta, SMB/HML/momentum betas, R-squared, information ratio, tracking error. Identifies alpha-generating vs factor-exposed regimes.

Detect market regime using Hidden Markov Model on real daily returns: bull_trending, bear_trending, choppy, or crisis. Returns regime probability, days in current regime, transition probabilities, vol regime, and Sharpe. Uses hmmlearn if available, statistical fallback otherwise. Real Polygon data only.

Aggregate shadow-only quant regime telemetry from bot_metrics_live and state/quant_shadow_snapshot.json: GARCH status, OFI intensity, Kalman shadow slope, HMM regime status, and 7-day agreement summary when available. Does not compute models.

Get VIX term structure from real CBOE data: spot VIX, VIX3M, VIX6M contango/backwardation. High contango (>10%) is bullish for equities; backwardation signals fear. Returns regime: contango, backwardation, flat.

Compute real-time cross-asset correlation matrix for a list of symbols using actual daily returns. Detects regime changes (correlation spikes during crises). Returns heatmap data, average pairwise correlation, and risk concentration score.

MCP Elicitation: request structured human confirmation before executing a high-value or destructive trade action. Shows the user a form with trade details; execution is gated on approval.

Submit a durable long-running MCP Task (backtest, optimization, ML retrain). Returns a task_id immediately. Use get_task_status to poll. Tasks persist across disconnects.

Get status and progress of a long-running MCP Task. Returns phase, progress percentage, result (when done), or error.

Trigger an AlphaLoop evolution cycle: SCAN underperformers → MUTATE parameters via Optuna → VALIDATE against real trade history → PROMOTE winner. Uses RL reward model. Requires real trade history (min 5 trades).

Compute footprint chart for a symbol: bid/ask volume at each price level per candle, detecting absorption (sellers absorbed at support), imbalance (>3:1 ratio), and delta exhaustion. Uses real Databento tick data.

Fetch dark pool volume for a symbol from real FINRA ATS reports + Polygon off-exchange trade conditions. Returns dark pool %, total off-exchange volume, and institutional activity score. NO synthetic data — fails if real sources unavailable.

Run earnings NLP pipeline: fetch SEC EDGAR filing, compute FinBERT sentiment, extract key themes (guidance, EPS beat/miss, capex), detect tone shift vs prior quarter. Returns catalyst score and actionable signal.

Fetch real prediction market probabilities from Polymarket and Kalshi for macro events (Fed rate decisions, election outcomes, economic releases). Derives equity market signals from contract odds.

Search live Polymarket and/or Kalshi markets by keyword. Returns real contract YES/NO prices, volume, liquidity, and URLs. Fails closed if no API data.

List highest 24h-volume Polymarket markets right now (real Gamma API). Useful for Roo-style early YES/NO flow and liquidity discovery.

Read recent JSONL metric entries for a prediction-market bot_id from the local audit log.

Fetch detailed info for a specific Polymarket market by condition ID or event slug. Returns question, YES/NO prices, volume, liquidity, resolution date, and status. More precise than search — use when you have a specific market ID.

Get historical YES price data for a specific Polymarket market. Returns timestamped price series. Accepts slug, Gamma numeric ID, or CLOB token ID — auto-resolves. Useful for charting probability movement, analyzing market efficiency, and detecting smart money flow timing.

List Polymarket prediction markets with status filtering and pagination. Unlike search, this returns all markets in a category. status=open (default) | closed | resolved. Sorts by 24h volume descending.

Read AlgoChains business identity files (TELOS system, adapted from PAI). Returns mission, goals, strategies, mental models, lessons learned, challenges, ideas, and KPIs. Use section='all' for full context or specify: mission|goals|strategies|models|learned|challenges|ideas|metrics. Every agent should read TELOS at session start for full business context.

Append a new entry to an AlgoChains TELOS file (goals, learned, ideas, challenges, etc.). Use to capture new lessons learned, ideas, or goal updates during a session. The log is append-only — entries are never overwritten.

Fetch US economic indicators from FRED (Federal Reserve Economic Data). Covers 16 key indicators: VIX, Fed Funds Rate, CPI, PCE, 10Y-2Y Treasury spread, unemployment, M2, GDP, housing starts, consumer sentiment. Requires FRED_API_KEY (free at fred.stlouisfed.org). Results cached 6h. Essential for regime detection across all bots.

Fetch EIA weekly crude oil inventory data — critical signal for the CL (crude oil) futures bot. Covers US commercial crude stocks, Cushing Oklahoma (WTI delivery point), and field production. Released every Wednesday ~10:30 AM ET. Build above estimate = bearish CL; draw below = bullish. Requires EIA_API_KEY (free at eia.gov/opendata).

Get the 7 most important Fed policy indicators in one call: Fed Funds Rate, CPI, PCE, 10Y-2Y spread, VIX, 10Y yield, 2Y yield — with AI-derived regime interpretation (restrictive/neutral/accommodative, crisis/normal, inverted/normal yield curve). Use for MNQ/NQ regime context before trading sessions. Requires FRED_API_KEY.

Record the outcome of an agent action or skill invocation for continuous learning. After 30+ signals, patterns emerge: which skills produce the best outcomes, where failure is common, what to improve. Stored in state/learning_signals.jsonl (append-only audit log). Use after any significant agent action.

Retrieve and analyze historical learning signals from state/learning_signals.jsonl. Returns signals with optional summary statistics: success rate by action type, top skills by effectiveness, bot activity, average ratings. Use to identify where agent performance is strongest/weakest and drive improvement priorities.

Send a mobile push notification via ntfy (https://ntfy.sh). Topics: bots (bot up/down/trade), risk (circuit breaker, daily loss), marketplace (new subscriber, bot promoted), ops (deploy, system health), alpha (high-confidence signal). Priority: max/urgent = always-on screen; high = with sound; default = normal; low/min = silent. Requires NTFY_BASE_URL + optional NTFY_AUTH_TOKEN.

Check if the AlgoChains Django signal propagation service (Roo architecture) is reachable and whether copy-trade paper fanout has active backlog. Separates active_lag_seconds from idle_since_last_signal_seconds so quiet markets do not look stalled.

Run the GUARDRAIL pre-flight middleware chain before placing any order. Executes 6 gates: VIX, daily-loss, stoploss-guard, cooldown, confidence, R/R. Returns approved=true only if all gates pass. Wire this before every order execution.

Get pre-computed macro alpha signal fabric: yield curve shape (2y-10y), credit spreads (HY-IG), DXY momentum, PMI regime, VIX term structure contango/backwardation. All from real FRED/CBOE/Polygon APIs.

Get real-time dashboard of all live trading bots: PIDs, positions, today's P&L, signal counts, win rates computed from actual fill history. Data from ~/.algochains/bot_metrics.db.

Subscribe to real-time bot metrics stream via MCP resource notifications. Fires on every fill, signal, and position update. Perfect for the private bot showcase on AlgoChains marketplace.

List all available AlgoChains skills from OpenClaw (363+), Windsurf (80+), Cursor (15), and Claude (8) skill libraries. Filter by category (trading, research, operations, intelligence, agent, comms, risk, data, ml, marketplace) or platform. Returns name, description, categories, tools used, and trigger type.

Get the full SKILL.md content and metadata for any skill by name (e.g. 'moltbook-debate', 'bot-diagnostics', 'autonomous-researcher', 'backtest-governance'). Returns complete instructions, tool requirements, trigger conditions, and schedule. Use list_skills or search_skills to discover skill names.

Search across all 450+ skills by keyword. Returns ranked matches from OpenClaw, Windsurf, Cursor, and Claude libraries. Use to find the right skill for a task before reading its full SKILL.md.

Given a task description in plain language, return the 3-5 best skills to use. Matches your task against skill descriptions across all platforms. Use when you do not know which skill to call.

Read the OpenClaw agent memory store. Contains trade lessons, regime history, signal quality scores, and cross-session agent context. Filter by key_prefix (e.g. 'trade', 'regime', 'bot') to narrow results.

Persist a trade lesson to OpenClaw memory so autonomous agents can learn from it. Lessons are retrieved during future trade decisions for similar setups. Required: symbol, direction, outcome, lesson text.

Read the current market regime from OpenClaw state (written by autonomous regime_detector skill). Returns regime label, confidence, and timestamp. This is the regime all live bots use for signal filtering.

Read ~/.openclaw/bot_heartbeat.json. This file is MNQ-only and fill-triggered (written by FUTURES_SCALPER_UPGRADED._track_openclaw_feedback on slippage/fill feedback), NOT by autonomous_watchdog every 5 minutes. Schema is typically {ts, bot, symbol}. For fleet process liveness use get_bot_health / get_all_bot_ops_status; for failover primary use control-tower logs/bot_heartbeat.json.

Get existence, size, and last-modified time for all OpenClaw state files (memory, regime, heartbeat, monitor, evaluations, AI cost, calibration). Use to verify OpenClaw is healthy and its state files are current.

Trigger a Moltbook bull/bear multi-agent debate for a trading signal. Shadow mode — does NOT place orders. Returns consensus direction, confidence, agreement %, and per-agent reasoning. Use before significant trades for multi-agent validation.

Run the MCPT marketplace autopilot pipeline. Steps: decay (check edge decay), graduate (30-day paper trading gates), audit (batch MCPT re-validation), listing (generate marketplace JSON), slack (post summary to #quant-lab). Calls scripts/mcpt_autopilot.py.

Run the regime detection pipeline — analyzes VIX term structure, market breadth, and price action to classify current market as trending/choppy/volatile/mean_reverting. Updates OpenClaw current_regime.json used by all live bots.

Semantic search over the AlgoChains Onyx knowledge base: 400+ strategy research JSONs, 45+ blueprints, 126 skills, live bot logs. Returns ranked documents with relevance scores.

Ask a natural language question against the Onyx knowledge base with RAG grounding. Returns an answer with cited sources. E.g. 'What is the best CL swing setup in trending regimes?' or 'How do I configure Token Guardian?'

Get real-time perpetual futures funding rates from Binance, Bybit, and Hyperliquid. Identifies funding rate arbitrage opportunities and predicts funding-driven price pressure.

Get real staking APY from Lido Finance (stETH), Binance Simple Earn, Cosmos validators, and Ethereum Beacon Chain. Compares yield opportunities across protocols.

Get status and result of a dispatched tower job. Polls the tower via SSH for the result file.

Check the configured compute node (ALGOCHAINS_TOWER_HOST) health: reachable, memory, active jobs, GPU status.

Run the autonomous marketplace pipeline: Research→Backtest→MCPT Validate→Stage for marketplace. Scans recent strategy research, runs tick backtests, applies 5-gate validation, stages passing strategies as marketplace JSON listings. Triggers Onyx ingest and Slack notification. No synthetic data — real tick engines only.

Get all staged marketplace bot listings with real metrics: futures (owner-only), equities, crypto, forex. Includes Sharpe, win rate, max DD, subscription pricing, and paper trading status. Supabase-first with local filesystem fallback.

Check Onyx knowledge base status: health, last sync time, total indexed documents, connector status (self-hosted host via ONYX_API_URL).

Check AlgoChains Learn Hub health: HTTP status of /learn/, /learn/feed.xml RSS MIME, and learn.algochains.ai subdomain redirect. Read-only — does NOT deploy. Use to verify the live Learn Hub is up and public (no login required).

Get real-time trading metrics for live bots (Tradovate + Alpaca paper). Supabase-first (bot_metrics_live table). Returns daily P&L, win rate, last signal, confidence, error count. Bot IDs: mnq, cl, mes, nq, alpaca_paper_equities, alpaca_paper_crypto. Omit bot_id to get all. Falls back to log parser if Supabase unavailable.

Get real-time trading metrics for all 4 live Tradovate bots (MNQ, CL, MES, NQ) in a single call. Returns daily P&L, win rates, signals, error states, and MCPT validation badges. Data from real log files.

Check whether this MCP server node is the primary trader (MacBook offline) or standby (MacBook alive). Reads the Mac heartbeat file to determine heartbeat age, Mac liveness, desktop bot process counts (expected 5: MNQ/CL/MES/NQ + Kalshi), and which node is currently running the bots. Critical for dual-node failover awareness.

Read adaptive_brain.py daemon liveness from bounded process, script, state, and log evidence. Read-only; does not restart or mutate daemon state.

Run the trading-system-health audit: bot process/log liveness (with legacy log alias resolution), disk space on control-tower and home volumes, and optional health_snapshot.json. Use to triage SEV1 trading-system-health watchdog alerts without false inactive signals from stale cl_bot_live.log.

Get all academic citations, SSRN papers, and published works that provide the theoretical basis for a specific bot's strategy. Includes authors, year, venue, DOI/SSRN link, and relevance explanation. Bot IDs: mnq, cl, mes, nq.

Get the complete bot card data payload for algochains.ai marketplace display. Includes strategy summary, academic citations, backtest artifact paths (MCPT JSON, whitepapers, blueprints), skills references, and subscription tier. Use to populate or refresh a bot card on the marketplace site.

List all research attachments available for a bot: MCPT validation JSON files, backtest PDFs, whitepapers, and blueprint markdown files. Shows local path and whether the file exists. Use to prepare uploads to Supabase storage for bot card attachment panel.

Read the persisted position state file for a bot. Returns direction (BUY/SELL/null), qty, entry_price, and flat status. This is the bot's internal tracking — compare to Tradovate get_positions() to detect drift.

Parse the bot log to determine current bracket order status. Returns mode (live/oso_only/none/unknown), stop/target order IDs and prices, and whether the position is unprotected. Critical for detecting missing stops after an entry.

Check AI ensemble/debate pipeline health. Detects Anthropic quota errors, Cerebras model errors (llama3.1-8b), pipeline timeout events, and shadow mode. The pipeline is ADVISORY ONLY — primary confidence gate controls all trades regardless of pipeline state.

broker_truth / live ops — cross-check ALL open Tradovate positions vs working orders to find unprotected exposure (position open, no stop/target). Use for 'unprotected?', 'do I have stops?', 'bracket check'. Do NOT use web search. Returns OK | UNPROTECTED_EXPOSURE. Run before P&L reports and after restarts (prevents Apr 14 2026 -$4.9k class).

Live Tradovate bracket audit for non-MNQ positions (CL/MES/NQ). Each open position must have BOTH a working stop and target order. Returns checked_count, missing_brackets, and formatted_line for BRACKET-INTEGRITY-MONITOR. Status DEGRADED when bot state files show open exposure but broker returns zero positions (fail-closed).

Read the bracket integrity guardian daemon state. Returns last check time, any unprotected positions currently flagged, and whether auto-flatten has fired. When guardian positions_count is 0 (or guardian inactive), also runs live bracket_integrity_check against Tradovate so watchdogs cannot report OK with 0 checked without broker verification.

Begin the AlgoChains setup wizard. Shows risk disclosure, privacy notice, and compliance acknowledgment. MUST be called first by new users before connecting any broker. Returns the disclosure text and required acknowledgment string.

Acknowledge the AlgoChains risk disclosure to unlock trading tools. User must type the exact acknowledgment text shown by start_onboarding(). Creates an auditable timestamp of acknowledgment.

Get step-by-step setup guide for a broker: required env vars, where to get credentials, paper trading instructions, rate limits. Includes broker-specific risk warnings. Brokers: tradovate | alpaca | oanda

Test broker connectivity using credentials from environment variables. Returns success/failure with specific error messages. Fails loudly if credentials are missing or invalid — never silently proceeds.

Get setup guide for a market data provider: required env vars, where to get API keys, free tier details. Providers: polygon | databento | onyx | fred

Test market data provider connectivity: polygon, databento, onyx, or fred. Uses credentials from environment variables. Returns connected/failed with error details.

Run end-to-end connectivity smoke test for all configured brokers and data providers. Marks onboarding complete if all pass. Call this after setting up credentials to verify everything works before trading.

Check current onboarding progress: steps completed, steps remaining, connected brokers/providers, AlgoChains API key status, guardrail prefs, and next required action.

Step 4: Set your AlgoChains developer API key (ac_live_* or ac_test_*) for marketplace and bridge access. Validates against the bridge health endpoint. Get a key via create_developer_key tool or at algochains.ai/account/developer-keys/.

Step 6: Configure guardrail notification thresholds. Hard-coded limits (daily loss $500, max drawdown 15%, VIX>35 gate) cannot be changed — this only controls when you are notified.

Generate the MCP config file (mcporter.json / mcp.json) for your IDE based on your connected brokers and data providers. IDEs: cursor | windsurf | claude | vscode. Mode: smart (default, 181 tools) | full (533 tools). Output includes install instructions.

Read current state of all hard-coded trading circuit breakers. Shows which brokers are OPEN/CLOSED/HALF_OPEN, trip reasons, cooldown timers, and current order velocity. These limits are code-level constants — the AI cannot modify them. Use to understand why orders are being blocked.

Read daily loss proximity guard status: today's P&L vs the $500 hard limit, utilization %, alert/block thresholds (80% alert, 95% block scalpers, MNQ swing exempt), and whether P&L evidence is verified. Returns DEGRADED when P&L source is unknown instead of fail-open OK.

Check AI agent loop detection metrics: calls in last 60s, unique call signatures, max identical call count, and loop risk level (LOW/MEDIUM/HIGH). If loop risk is HIGH, a circuit breaker may trip on the next repeated call. Read-only — limits are hard-coded constants.

Get real-time latency profile for this MCP session: tool call overhead, broker API round-trip times, and current execution tier. Includes a reminder that MCP AI-assisted execution is Tier 4 (120ms-2s) — not suitable for HFT. Use to set correct expectations for strategy timing.

Ingest a user-provided CSV file of OHLCV market data into AlgoChains. Validates columns, parses rows, and stores in state/custom_data/. The data becomes available for backtesting via run_backtest(data_source='custom'). Requires real file on disk — no synthetic substitution.

Ingest a JSON file of pre-computed signals, ML features, labels, or regime tags into AlgoChains. Supports entry/exit signals, feature vectors, classification labels, and regime classifications. Data becomes available for ML training.

Index local research documents (PDF, Markdown, JSON, TXT) into the Onyx RAG knowledge base. Documents become searchable via onyx_ask() and onyx_search(). Supports recursive directory scanning. Requires Onyx to be running at ONYX_API_URL. Owner-only side effect (AC-MCP-009).

Register a custom strategy spec JSON with the AlgoChains platform. The spec must contain entry_rules and exit_rules. Once registered, the strategy can be backtested via run_backtest(strategy_id=...). Validates the spec file before registering.

List all custom OHLCV datasets, signal files, Onyx document ingestions, and registered strategies. Shows what proprietary data has been brought into AlgoChains.

Generate an OAuth authorization URL for a user to connect their broker account (Schwab, Alpaca, Tradovate, OANDA). Returns the URL to redirect the user to.

Exchange an OAuth authorization code for broker access/refresh tokens. Call this after the user returns from the broker's authorization page.

List all brokers a user has connected via OAuth, with token expiry and scope information.

Disconnect a broker OAuth connection and remove stored tokens.

Create a new AlgoChains account with email + password via Supabase Auth. Returns session on success or requires_email_confirm. Next step: verify_email_otp → enroll_mfa → create_developer_key.

Verify the email OTP token from the AlgoChains confirmation email. Activates your account and starts a session.

Login to AlgoChains with email + password. Stores session locally for subsequent MFA and key operations.

Refresh an expiring AlgoChains session using the stored refresh_token. Call before session expires to stay logged in.

Revoke current AlgoChains session and clear stored credentials.

Enroll a new MFA factor (TOTP authenticator app or SMS). Returns QR code URI for TOTP — scan with Google Authenticator, Authy, etc. Then call verify_mfa to complete and upgrade session to AAL2.

Create an MFA challenge for login step-up verification. Required before verify_mfa during subsequent logins.

Verify MFA code to complete enrollment or step up to AAL2 session. AAL2 is required for create_developer_key, rotate_developer_key, revoke_developer_key.

List enrolled MFA factors for the current session.

Remove an enrolled MFA factor. Requires owner_token — destructive, downgrades session to AAL1.

Mint a new ac_live_* or ac_test_* developer API key. Requires AAL2 session (enroll_mfa + verify_mfa first). Plaintext key returned ONCE ONLY — save immediately.

List your developer API keys (masked — plaintext never returned after creation).

Atomically rotate a developer key (revoke old, mint new). Requires AAL2 session. New plaintext returned ONCE ONLY.

Revoke (soft-delete) a developer API key. Requires AAL2 session.

Get usage metadata for a developer key (last used, scopes, active status).

Test a developer API key against the hosted AlgoChains bridge (mcp.algochains.ai). Returns auth status and scopes.

START HERE. Guided next-steps for a brand-new user, by goal. No auth, no setup. Call get_started(goal='subscriber') for copy-trade signals, 'creator' to publish a strategy, 'developer' to build on the API, or 'explore' to look around with zero signup. Returns the exact tool calls to make next.

Transparent AlgoChains pricing: paper ($29/mo) and live ($99/mo) tiers, what's included, usage overage, the 20%/3-month referral reward, and the 80% creator revenue share. Flat subscription + usage; no performance fees. No auth required.

Consumer-facing platform health: version, live signal-bot roster (MNQ/CL/MES/NQ), tool count, and public marketplace listing count. No auth, no secrets — safe to call anytime.

Generate a Stripe checkout URL for an AlgoChains subscription. Returns a URL the user clicks once to pay — Stripe handles the payment UI. After payment, a sub_live_… key is emailed automatically and the subscriber can subscribe to MNQ copy-trade signals (delivered for the subscriber to review and act on — no automated execution; the subscriber stays in control). Tiers: 'paper' ($29/mo — subscriber tools + MNQ copy-trade signals, simulated paper account, no broker needed) or 'live' ($99/mo — subscriber connects their own broker and places their own trades). Flat subscription only. Set ALGOCHAINS_SUBSCRIBER_KEY= to activate.

Return a direct payment link for an AlgoChains subscription tier. Unlike get_checkout_url, this returns a pre-configured shareable URL that works without entering an email first. paper=$29/mo, live=$99/mo. After payment, set ALGOCHAINS_SUBSCRIBER_KEY=.

Subscribe the authenticated subscriber to a strategy's published copy-trade SIGNALS (the subscriber reviews and acts on them — the platform does not auto-execute or exercise discretion). The subscriber sets their own size and can pause/leave anytime. Strategies: MNQ (micro Nasdaq scalper), CL (crude oil scalper), MES (micro S&P swing), NQ (Nasdaq swing). Enforces a seat cap per strategy — returns bot_at_capacity if full. Requires the futures risk disclosure to be acknowledged first (accept_subscriber_terms) and ALGOCHAINS_SUBSCRIBER_KEY to be set. Re-calling with an existing subscription updates size_multiplier and un-pauses.

Return a full status snapshot for the authenticated subscriber: which bots they're assigned to, paper account balance, key_active flag, and suggested next_steps based on their current state. Good first call after setting ALGOCHAINS_SUBSCRIBER_KEY. Requires ALGOCHAINS_SUBSCRIBER_KEY to be set.

Record the authenticated subscriber's explicit acknowledgment of the futures risk disclosure and Terms of Service. REQUIRED before active copy-trade (join_bot). Call once with no arguments to retrieve the disclosure text and the exact acknowledgment phrase, then call again with acknowledgment= to record consent. CFTC/NFA compliance gate. Requires ALGOCHAINS_SUBSCRIBER_KEY.

Your current-month MCP API usage: total metered calls, included quota, overage calls, overage cost (USD), and a projected month-end overage cost. Read-only; reflects this subscriber's billing tier. Requires ALGOCHAINS_SUBSCRIBER_KEY.

Create (or fetch) the authenticated subscriber's shareable referral code. Returns the code and a share_url (https://algochains.ai/r/). One active code per subscriber. Referrers earn 20% of each referral's subscription for their first 3 months. Requires ALGOCHAINS_SUBSCRIBER_KEY.

Return the authenticated subscriber's referral summary: their referral code, count of subscribers referred, and commission counts + sums by status. Requires ALGOCHAINS_SUBSCRIBER_KEY.

Return total referral earnings (pending + paid commission_usd) for the authenticated subscriber, with the 20%/3-month policy and compliance disclaimer. Requires ALGOCHAINS_SUBSCRIBER_KEY.

Your realized P&L with LIVE (real broker) and PAPER (simulated) results STRICTLY segregated. Paper results carry the CFTC Reg. 4.41(b) hypothetical-performance disclaimer; they are never co-mingled with live results. Requires ALGOCHAINS_SUBSCRIBER_KEY.

Add an email to the AlgoChains waitlist. Stores in Supabase, sends welcome email via Resend. Returns waitlist position.

Get waitlist aggregate statistics: total signups, by status, by broker interest.

Verify a code sent via email or SMS. Returns valid=true if the code is correct and not expired.

Track a platform analytics event (page_view, signup, broker_connected, purchase, etc.). Used for soft-launch funnel monitoring.

Get platform analytics summary for the last N days: total events, unique users, conversion funnel, top pages, by-day breakdown.

Send a password reset link to a user's email via Supabase Auth. Always returns success to prevent user enumeration.

Complete a password reset using the access token from the reset email link. Validates password policy (12 chars, upper/lower/number/special).

Start account recovery for users who cannot receive the reset email. Creates a support ticket and provides recovery instructions.

Return the current password policy requirements for AlgoChains accounts.

Get Kronos foundation model shadow-mode prediction statistics per bot. Shows agreement_rate, total_logged, direction accuracy, and promotion readiness vs the Bayesian ensemble. Read-only observer — Kronos has zero influence on live trades until manually graduated.

Read-only signal->trade traceability audit. Joins signals_trace to trade_log and returns NULL-rate KPIs (fill_id_coverage, placed_price_coverage, bracket intent nulls, P&L gap, per-column null rates). Thin wrapper over the control-tower correlation-audit script (runs --json --no-slack) — does not post to Slack. Defaults to filled-only rows so unfilled signal-only rows do not inflate fill-stage NULL rates.

List supported prop firms with 2026-verified rules (Apex, Topstep, MyFundedFutures, TradeDay, Bulenox, Earn2Trade, FTMO, Tradeify). Returns fees, profit targets, drawdown type/limits, consistency rules, automation policy, and rules_verified_date.

Score a strategy against every supported prop firm (or a specific one) using its live stats. Returns ranked eligible funds with strengths/warnings.

Return Numerai tournament configuration status: env vars as booleans (never key values), dataset version, round cadence, and proxy_mmc labeling notes. Safe to call anytime — no API calls made. HK-6: NUMERAI_SECRET_KEY never appears in response.