MCP Server

Bring your own AI

The VYX MCP server gives your own AI — Claude Desktop, Claude Code, claude.ai, ChatGPT, Codex, Cursor, or any client that speaks the Model Context Protocol — the same sight and hands the built-in VYX chat has. It reads your board scored live, previews candidates before saving, composes signals and regimes, and works your trade desks: reading a desk whole, setting what it trades, and authoring your AI trader's strategy. The in-app chat is the zero-setup way to do all this on us; the MCP server is the same copilot running on your own AI subscription, so your usage scales with the plan you already pay your AI provider for. On connect it briefs your client with built-in instructions — what VYX is, what each metric means, the workflow, and the guardrails — so a fresh session uses it well from the first message. It is non-custodial and holds no execution authority: it never places an order, and it cannot enable or arm a trader.

Connect it (one URL, no install)

Add the connector URL below in your AI client and sign in to VYX when it asks — that is the whole setup. There is nothing to install, it speaks Streamable HTTP, it works on mobile, and it auto-updates. Signing in this way grants your AI full access to compose on your account — signals, regimes, desks, watchlists, and trader strategies — so it can get you set up rather than only look around. You approve that on a consent screen that lists exactly what it can touch, and you can revoke it anytime under Settings → API & integrations. Connecting is free on every plan.

https://api.vyx.app/mcp

Client-by-client

The same URL works everywhere. Where a client asks for an API key instead of a sign-in, mint one under Settings → API & integrations and send it as a Bearer token.

• ChatGPT — Settings → Apps → Advanced settings → Developer mode, then Settings → Connectors → Create and paste the connector URL. Sign in to VYX when prompted.
• Claude (claude.ai, Desktop, Code) — add it as a custom connector and authorize with your VYX account.
• Codex, Cursor, and other MCP clients — add the same URL as a remote MCP server.
• Anything that wants a token instead of a sign-in — Authorization: Bearer vyx_sk_live_…

Authorization: Bearer vyx_sk_live_…

Let your AI set you up

The fastest way to a working desk is to ask for one. Once connected, your AI can read the live market, compose the signals that catch what you care about, stand up a desk around them, and explain what it built — the setup work you would otherwise do by hand in the app. It cannot enable or arm a trader, and it cannot place an order; those stay with you.

• "Connect to VYX, look at what the market is doing, and build me a desk for catching liquidity sweeps on the majors."
• "Set up VYX for someone who trades funding-rate extremes — compose the signals, preview them first, and light the ones that discriminate."
• "Read my board and tell me what it is set up to catch, in plain English."

Tools: see the market

The read tools are the in-app chat's sight, served fresh on every call — live scoring for every plan, not cached engine runs.

• vyx_scan — your board scored live by your active desk's signals (or one named signal), with per-signal contributions. Sort, filter, and cap the slice.
• vyx_symbol — one market's full state: your signals' scores with the per-indicator why, current-bar flow, and recent structure (range, breaks). Ask for bars to page full candle history.
• vyx_search — screen the whole universe by one metric condition (spread, imbalance, OFI, funding, OI change, and more).
• vyx_regime — your regime tiles evaluated on the live universe.
• vyx_signal_history — one signal's score bar-by-bar over history on one symbol.
• vyx_levels — a signal's level zones on one symbol: price bands, touches, breaks.
• vyx_pulse — the live order-flow pulse across the universe.
• vyx_list / vyx_watchlists — your saved objects and watchlists.
• vyx_analyst_latest / vyx_trader_decisions — the AI analyst's notes and a trader's auditable decision log.
• search / fetch — a plain-language way in: find the markets, signals, or desks relevant to a question, then pull the full live record for one. Clients that only support these two (ChatGPT's research modes among them) can still read VYX through them.

Tools: check, then build

The same check-your-work loop the in-app chat runs before it proposes anything — preview against the live field, create only what survives, validate against history after.

• vyx_preview_indicator — one formula across the universe: range, median, dead-data detection.
• vyx_preview_signal — a candidate composite's fire count, buy/sell split, and dead gates. Nothing is saved.
• vyx_preview_regime — a candidate regime's reading, distribution, and whether it moves.
• vyx_create_signal — create or update a composite from the same rich item shape the chat composes.
• vyx_create_regime — regime tiles.
• vyx_validate_signal — proof over history for a saved signal: volatility and direction verdicts.
• vyx_set_server_side — run a signal 24/7 server-side (Trader and up).
• vyx_delete — remove a saved object by kind and id.

Tools: work your trade desk

Full desk control, the way the in-app chat has it. A desk's lit signals are exactly what its AI trader trades — changing them changes what an armed trader acts on at its next tick, and your agent is briefed to say so before doing it. AI traders follow the same plan gating as in the app (Autopilot and up).

• vyx_desk — a desk whole: lit signals, interval, liquidity floor, its trader (strategy, mode, whether it can run and why), open trades, recent closed trades with R, and your armed posture.
• vyx_create_desk / vyx_switch_desk — stand up a new desk; switch the active one (syncs to your devices).
• vyx_set_desk_signals — set, add, or remove the desk's lit signals by id or name.
• vyx_create_trader — compose a trader with the chat's strategy model: summary, setups, planning, management, sizing, avoid. Modes: analyst or testnet. Always created disabled.
• vyx_edit_trader — revise the strategy in place (version bumps, learnings preserved). It cannot enable, arm, or switch modes.
• vyx_create_watchlist / vyx_update_watchlist — named watchlists.
• vyx_share_desk — make a desk public and get its no-login link.

Resources

Resources are read-only context you can attach so the model grounds its reasoning in your live board and the analyst's view — two analysts at once.

• vyx://signals — your signal definitions.
• vyx://board — your board scored live by your active desk signals.
• vyx://desk — your active trade desk whole: lit signals, trader, open trades, recent trades.
• vyx://pulse — the live order-flow pulse snapshot.
• vyx://analyst — the AI analyst's latest notes.

Guided prompts

The server ships slash-command prompt templates — pre-written best-practice workflows your client surfaces as commands. Pick one instead of writing the prompt yourself.

• get_started — new here: your AI reads the live market, composes signals for what you want to catch, previews them before saving, and stands up your first desk around the ones that survive.
• morning_brief — the pulse and regime across the universe plus your board digest and what changed.
• inspect_symbol — a deep microstructure read of one symbol (depth, imbalance, CVD, funding, OI, structure).
• build_signal — a guided composer: preview first, then vyx_create_signal.
• desk_review — read a desk whole, judge its trader's recent trades, and propose one strategy revision.

Example prompts

Or just ask in plain language and the model picks the right tools.

• "What is the order-flow pulse right now — where are funding and aggression concentrated?"
• "Scan my board and summarize the three strongest signals and why."
• "Preview a signal that fires when the book fractures — spread blowout plus an unstable spread — and create it if it discriminates."
• "Read my desk, review the trader's last ten trades, and suggest one change to its sizing rules."
• "Switch to my Majors desk and light only the OI Surge and Fracture signals."

What it will never do

The MCP server holds no execution authority, on purpose. It cannot place, modify, or cancel an order; it cannot enable a trader, arm your account, or switch a trader between analyst, testnet, and live. Traders it composes are born disabled. Your AI can see everything and shape everything — the decision to let a strategy touch money stays with you, inside the app, behind the same hard rails the built-in chat obeys.