QuantLogix MCP Server

Connect QuantLogix to your AI tools — Claude Desktop, Claude Code (with plugins), Goose, OpenCode, Google Antigravity, Cursor, or any MCP-aware client. Ask "What's the signal on NVDA?" or "Show me Berkshire's latest 13F" right where you already work.

Free to start — Pro unlocks the advanced tools. One server, one tool catalog, two ways to sign in. The server address is https://quantlogix.ai/api/mcp — a one-click OAuth connector; sign in with your QuantLogix account, no key to manage. If you need headless or CI access, the same catalog answers at https://quantlogix.ai/api/mcp/v1 with a ql_... API key from your profile. The only difference: account data (your saved Intelligence, QL Collab docs, CRM and meetings) needs the OAuth sign-in, because that is an explicit grant you can revoke rather than a long-lived key. Everything else — market data, signals, screener, private markets, the quant lab, and the AI tools (ask, run_agent) — works through either credential. AI spend is always capped: per key on the key path, per account (a daily cap plus your monthly AI budget) over OAuth. Most market-data and content tools are Free; intraday/options/13F and the screener are Pro.

Endpoint

The MCP server speaks JSON-RPC 2.0 over HTTP at a single URL:

https://quantlogix.ai/api/mcp/v1

Protocol version: 2025-06-18 · Transport: streamable-http · Auth: Authorization: Bearer ql_...

Setup

Pick your client. The config snippets below all assume your key is in an environment variable called QUANTLOGIX_API_KEY — you can also paste the key inline if you prefer.

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop:

{
  "mcpServers": {
    "quantlogix": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://quantlogix.ai/api/mcp/v1",
        "--header",
        "Authorization:Bearer ${QUANTLOGIX_API_KEY}"
      ],
      "env": {
        "QUANTLOGIX_API_KEY": "ql_paste_your_key_here"
      }
    }
  }
}

After restart, you'll see quantlogix in the 🔌 connectors menu with the tools listed. Ask "What's QuantLogix's signal for AMD?" to test. Tip: for the full catalog (including your saved Intelligence and QL Collab), add the OAuth connector https://quantlogix.ai/api/mcp via Claude's one-click "Add custom connector" instead — it signs you in, no key needed.

Recommended — install the QuantLogix plugins. You get the MCP tools plus ready-made slash commands (/ql-signal, /ql-screen, /ql-dd, /ql-workflow…), skills, and research subagents. From inside Claude Code:

/plugin marketplace add PortoLogix/quantlogix-plugins
/plugin install quantlogix-signals@quantlogix

Also available: quantlogix-quant (Pro+ agent-builder surface) and quantlogix-research (bull/bear due-diligence). Each plugin bundles the OAuth connector, so the first tool call signs you in — nothing to paste.

Just the tools (no commands)? Add the OAuth connector directly:

claude mcp add --transport http quantlogix https://quantlogix.ai/api/mcp

Then run /mcp and pick Authenticate — a browser opens for the QuantLogix sign-in, and the tools appear once you're back.

Prefer a headless API key (75 tools incl. QL Agents, good for CI)? Add to .mcp.json in the project root:

{
  "mcpServers": {
    "quantlogix": {
      "type": "http",
      "url": "https://quantlogix.ai/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer ql_paste_your_key_here"
      }
    }
  }
}

Mint a ql_... key on your profile. Once connected, the server's built-in prompts (morning_market_brief, pre_earnings_checklist, stock_deep_dive) show up as ready-to-run workflows.

Goose is Block's open-source AI agent. QuantLogix connects as a remote (Streamable HTTP) extension.

Recommended — OAuth connector (no API key). Run:

goose configure

Choose Add Extension → Remote Extension (Streaming HTTP), name it quantlogix, URL https://quantlogix.ai/api/mcp. Goose opens a browser to sign in to QuantLogix, then loads the full catalog. (In Goose Desktop: Settings → Extensions → Add → Remote/Streamable HTTP, same URL.)

Or drop this into ~/.config/goose/config.yaml — the API-key variant needs no browser (mint a ql_... key on your profile):

extensions:
  quantlogix:
    enabled: true
    type: streamable_http
    name: quantlogix
    uri: https://quantlogix.ai/api/mcp/v1
    headers:
      Authorization: "Bearer ql_paste_your_key_here"
    timeout: 300
    description: "QuantLogix — live stock signals, options, 13F & research"

For the full catalog instead, set uri: https://quantlogix.ai/api/mcp and drop the headers block — Goose runs the OAuth sign-in. Test with "What's QuantLogix's signal on NVDA?"

OpenCode is an open-source terminal AI coding agent. It auto-handles OAuth for remote MCP servers, so the full catalog needs just a URL.

Recommended — OAuth connector (no API key). Add to opencode.json (project root or ~/.config/opencode/opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "quantlogix": {
      "type": "remote",
      "url": "https://quantlogix.ai/api/mcp",
      "enabled": true
    }
  }
}

On first tool use OpenCode runs the QuantLogix sign-in in your browser and stores the token — nothing to paste.

Prefer a headless API key (75 tools incl. QL Agents)? Point at /api/mcp/v1 and pass the header (mint a ql_... key on your profile):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "quantlogix": {
      "type": "remote",
      "url": "https://quantlogix.ai/api/mcp/v1",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer ql_paste_your_key_here"
      }
    }
  }
}

Google Antigravity is Google's agentic IDE. Open its MCP config via the agent panel … → MCP Servers → Manage → View raw config (or Settings → Customizations → Open MCP Config) — the file lives at ~/.gemini/config/mcp_config.json (global) or .agents/mcp_config.json (per-workspace).

Note: Antigravity uses serverUrl (not url) for remote servers. Add a ql_... key from your profile:

{
  "mcpServers": {
    "quantlogix": {
      "serverUrl": "https://quantlogix.ai/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer ql_paste_your_key_here"
      }
    }
  }
}

That is the 75-tool API-key catalog (everything except your account-scoped Intelligence, Collab, CRM and meetings). If your Antigravity build supports MCP OAuth, point serverUrl at https://quantlogix.ai/api/mcp and drop the headers block for the full 107-tool catalog with account sign-in. New MCP tools run in Ask mode until you allow them (e.g. mcp(quantlogix/*)).

Cursor has no plugin marketplace, but it's a full MCP client. Two files give you parity — the connection and a rule that teaches the agent how to use the tools.

1. Connect — .cursor/mcp.json (project) or ~/.cursor/mcp.json (global). OAuth connector, no key on recent Cursor:

{
  "mcpServers": {
    "quantlogix": { "url": "https://quantlogix.ai/api/mcp" }
  }
}

Enable it under Settings → MCP. Older Cursor (no MCP OAuth): use https://quantlogix.ai/api/mcp/v1 with an Authorization: Bearer ql_... header (key from your profile).

2. Add the rule — .cursor/rules/quantlogix.mdc. It routes stock/market questions through the QuantLogix tools (which tool for what, no invented numbers, disclaimers) — the Cursor-native equivalent of our Claude Code plugin skill. Download quantlogix.mdc and drop it into .cursor/rules/.

List available tools:

curl -s https://quantlogix.ai/api/mcp/v1 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool (requires a ql_... key — Free tier works for signal and news):

curl -s https://quantlogix.ai/api/mcp/v1 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ql_paste_your_key_here" \
  -d '{
    "jsonrpc":"2.0",
    "id":2,
    "method":"tools/call",
    "params":{
      "name":"signal",
      "arguments":{"ticker":"NVDA"}
    }
  }'

The ql CLI

Everything on the OAuth connector is also available from your terminal — CRM (contacts, deals, tasks, goals & metrics, live report), QL Notes, Sheets, Slides, Draw diagrams, and every market-data tool. Zero dependencies; needs Node 18+.

# install
curl -fsSL https://quantlogix.ai/cli/ql.mjs -o /usr/local/bin/ql && chmod +x /usr/local/bin/ql

# one-time browser sign-in (OAuth + PKCE — same auth as the connector)
ql login

# try it
ql crm report                          # live pipeline + goal pace
ql crm goal metric=revenue_won target=50000 period=quarter
ql notes new title="Meeting notes" --file notes.md
ql call get_signal ticker=NVDA
ql help                                # the full command map

Available Tools

The catalog below is the shared tool set — 107 tools — served by both /api/mcp (OAuth, all 107) and /api/mcp/v1 (API key, 75 of them), and by the ql CLI. Each tier badge is the minimum access required; every tool inherits the same gate as its underlying QuantLogix endpoint. Tools marked sign-in required are OAuth-only; everything else — including ask and run_agent — works through either credential. Older tool names still work: the key server's original names (signal, agents_list, day_signal, …) remain permanent aliases for their verb_noun equivalents (get_signal, list_agents, get_day_signal), so existing configs and saved prompts keep running unchanged.

Free any signed-in account Pro Pro / Institutional Tiered monthly cap scales by subscription Write creates / edits data

📈 Market Data & Signals Free

get_signalLong-term 5-factor composite signal — Bullish/Neutral/Bearish, score 0-100, per-factor breakdown (technical, momentum, fundamental, options, microstructure), pattern prediction. (get_long_term_signal is the same engine.)
get_quoteLive price quote for a stock or ETF.
get_signal_rankingsTop-N tickers ranked by composite signal score, optionally filtered.
compare_tickersHead-to-head 5-factor comparison of 2–8 tickers — ranked by composite score with each name's per-factor breakdown, plus a verdict naming the strongest and the factor it leads on. Doubles as watchlist triage.
get_market_overviewIndices, VIX, and broad-market snapshot.
get_market_trendsDaily Trend Monitor — quantitative trend read per major index (score, direction, flags, key MA levels), SPY regime with flip probability, private-markets WoW trend, and detected trend flips.
get_macroUS macro indicators (FRED) — rates, inflation, employment, growth, with a composite macro-sentiment score.
get_track_recordVerified signal track record — win-rate, returns, and the four validation grades behind /proof.
get_ipo_calendarUpcoming + recent IPOs.
get_price_chartRendered price-chart image for a ticker.
get_heatmapS&P 500 sector performance heatmap — the 11 GICS sectors colored green→red by today's move, as an inline image (+ leaders/laggards text). No ticker needed.

📰 News & Content Free

get_newsPer-ticker aggregated news with sentiment.
get_ticker_sentimentAggregate news-sentiment score for a ticker.
get_market_newsMarket-wide aggregated headlines from a 14-source feed, each with an AI summary + sentiment tone.
list_wires · get_wireQL Wire — short AI-authored market wires tied to S&P 500 tickers (analyst-call recaps, earnings reactions, sector moves). List + full body.
list_ql_updates · get_ql_updateQL Updates — QuantLogix editorial / product posts (VC intelligence, macro strategy, persona briefs). List + full body.
list_briefings · get_briefingDaily / weekly / quarterly market briefings. List (kind filter) + full body.

🎯 QL Oracle — Verified Data Free

The verified stack as a data source: records graded by the platform against real prices — never self-reported. Every payload carries an attribution block (source, methodology, disclaimer, cite_as) so agents cite QuantLogix when using the data. Same shapes as GET /api/v1/verified.

get_verified_convictionThe Conviction Book — raw crowd vs track-record-weighted consensus per ticker, plus the sharpest crowd-vs-verified divergences. Optional ticker filter.
get_verified_indexThe QL Verified Index — the live long/short model book, cumulative level (inception 100), and equity curve.
get_verified_creatorsThe Creator Leaderboard — approved analysts ranked by the graded win rate of the agents they publish.
get_verified_recordOne creator's aggregate verified record by handle — the portable answer to "has this analyst actually been right?".

🧺 Strategy Baskets Free to browse Tiered to build

Browsing the curated catalog and the theme taxonomy is free for everyone. Resolving a theme into a live basket is metered by subscription tier — so basket-building availability is tier-based, not unlimited on Free.

list_baskets · get_basket FreeCurated strategy/thematic baskets catalog + detail (constituents, live track record).
list_basket_themes FreeBrowse the 487-theme investment taxonomy.
resolve_theme_basket Write TieredResolve a theme into a live equal-weight basket. Monthly distinct-theme cap by tier — Free 5 · Starter 25 · Pro 100 · Institutional unlimited. The cap is shared with the website, so switching surfaces doesn't reset it; admins bypass.

🔬 Advanced Signals & Fundamentals Pro

get_day_signalIntraday QDTSS signal — 4-layer scoring with VWAP, ORB, session classifier, trade plan.
get_swing_signalSwing signal — A/B/C/D conviction grade + 3-pillar breakdown (Technical / Flow / Sentiment), 2d-4wk.
get_microstructureOrder-flow microstructure — VPIN, OFI, smart-money score, institutional bias, volume profile, spread.
get_options_flowUnusual options activity — large/sweeps, premium, sentiment.
get_options_dataFull Options-tab data — pick an action: chain (Greeks + IV + max-pain + put/call), iv_skew (surface + term structure), large_flow, gex (gamma exposure, dealer flip, call/put walls), earnings_move (ATM-straddle implied move), expirations.
get_options_strategyRanked multi-leg options strategies for a thesis (bullish/bearish/neutral/volatility/earnings × short/medium/long) — concrete strikes + expirations from the live chain, debit/credit, max P/L, breakevens, delta-POP, IV-rank context.
get_earnings_calendar · get_earnings_setupPer-quarter EPS/revenue actuals + estimates, and the combined earnings-setup read (implied move + engine signal + revision momentum).
get_corporate_eventsDividends, splits, spinoffs, M&A for a ticker.
get_institutional_holders · get_institutional_fundTop 13F holders for a ticker (Berkshire, BlackRock, Vanguard, Renaissance, Citadel, …) and a fund's full 13F portfolio by CIK.
list_private_companies · get_private_company · get_private_company_financials~30 top private / pre-IPO companies (Anthropic, OpenAI, Stripe, Databricks, Anduril, …) + single-company profile + dilution waterfall / financing scorecard / public-comp valuation bridge. Profiles carry the live enrichment overlay: freshest sourced valuation mark + live-tracked C-suite leadership changes.
get_ipo_readiness · get_private_liquidity · get_investor_fitPrivate-market intelligence engines: 5-axis IPO-readiness composite (single company or ranked universe), secondary-market liquidity read (marks, instruments, restriction/timing model), and "who would invest right now" investor-fit ranking (deployment pace, dry powder, check-size/sector/stage fit).
list_investors · get_investor~280 VC / PE / CVC / Sovereign-wealth firms (Andreessen Horowitz, Sequoia, Founders Fund, Thrive, Tiger Global, …) — AUM, active fund, stage + sector focus, notable partners + portfolio, recent investments. Directory + single-firm profile.
screenerMulti-criteria Pro Screener across stocks + ETFs. Pro tier only on the API-key path.
analyze_portfolioRoll the 5-factor engine up over a whole portfolio or watchlist (up to 25 holdings, weighted by percent / market value / shares). Returns the weighted composite posture, signal mix by weight, weighted per-factor exposure, position + sector concentration (HHI, top-position, effective #positions), plain-English risk flags, and a prioritized list of the positions most worth reviewing.

🧠 Your Saved Intelligence Free

Your own saved AI research / chat sessions. Sign-in required (OAuth connector) — every call is scoped to your account; you can never read another user's data.

list_intelligence_articles · get_intelligence_article · search_intelligenceList, read, and full-text-search your saved QL Intelligence articles (research / due-diligence / Monte-Carlo / saved chat sessions).

⚙️ Your QL Agents Free

Set up + manage your own scheduled AI agents (a recurring digest, a conditional alert, or a one-time scheduled run). Sign-in required (OAuth connector); every call is scoped to your account. Create is capped per tier (Free 1 / Starter 3 / Pro 15 / Institutional 50). Agents run on the server schedule and notify you by push + email — manage them anytime at /agents.

list_agents · get_agentList your agents (name, mode, schedule, enabled state, run count) and read one in detail with its recent run history + performance stats (success rate, fired rate, errors, spend).
create_agent · update_agent · delete_agent WriteCreate a digest/alert agent on a premarket/close/weekly schedule — or a one-time run at a specific date & time (cadence once + run_at, fires once then auto-pauses). Update reschedules / edits / enables / pauses; delete removes it.

👥 Your QL Collab Workspace Free

Your team's Collab spaces (Clerk-org-scoped). Reads + writes are restricted to spaces you belong to; a write re-checks membership on the row first.

list_collab_spaces · list_collab_items · get_collab_item · search_collabBrowse your team channels and read/search their messages, notes, sheets, slides, and diagrams.
create_collab_note · update_collab_note WriteCreate / edit a Notion-style markdown note in a Collab space.
create_collab_sheet · update_collab_sheet WriteCreate / edit a live spreadsheet (formulas + live market-data functions; exports to CSV/Excel).
create_collab_diagram · update_collab_diagram WriteGenerate / edit a Mermaid diagram (flowchart, sequence, entity graph, mindmap, gantt).
create_collab_deck · update_collab_deck WriteCreate / edit a Marp markdown slide deck (presentable, exports to PDF).

📇 Your CRM Starter+

Your /crm — goal & metrics driven. Sign-in required (OAuth connector); every call is scoped to your contacts, deals, tasks, and goals. Same Starter+ gate as the app.

get_crm_reportLive analytics rollup — contact pipeline, deal pipeline value (open / weighted / won), tasks, and every active goal with pace.
list_crm_goals · set_crm_goal · update_crm_goal WriteGoals & metrics: set measurable targets (revenue won, deals won/qualified, contacts added, activity logged) over a week/month/quarter/custom window — progress is measured LIVE against your CRM data with on-pace / behind / achieved states.
list_crm_contacts · get_crm_contact · create_crm_contact · log_crm_interaction WriteBrowse / read contacts with interaction history; add contacts and log calls, emails, meetings, notes.
list_crm_deals · create_crm_deal · update_crm_deal WriteThe deals Kanban — list with the live pipeline rollup, create deals, move stages (won/lost closes them).
list_crm_tasks · create_crm_task · complete_crm_task WriteTask list (open / overdue / today / done scopes), add tasks with due dates + priority, mark done.

🎙️ Your Meeting Rooms Free

Transcripts + AI recaps from your QL Collab video rooms. Sign-in required (OAuth connector); scoped to rooms in your own team.

list_meetingsList your team's QL Collab meeting rooms that have a transcript on record.
get_meeting_transcriptFetch the full speaker-attributed transcript of one meeting room.
summarize_meetingAI recap of a meeting — TL;DR, decisions, and action items — generated from the transcript.

⚙️ QL Agents — build & run AI agents from your AI tool Pro NEW

On the API-key path (/api/mcp/v1) too — a Pro+ ql_... key lets Claude or Cursor manage the scheduled AI agents on your QuantLogix account conversationally. ask and agent_run spend your account's monthly AI token budget.

askGrounded AI market Q&A — the QL Agents pipeline pulls live data and returns a cited answer with confidence + as-of stamp.
agents_listList your scheduled agents with config, last-run status, and your plan's agent cap.
agent_create · agent_update · agent_delete WriteCreate, edit, pause/resume, or remove agents — digest / alert / research / committee modes on premarket, close, weekly, intraday, or one-time cadences, delivering via push, email, Telegram, or webhook.
agent_runRun a saved agent (or an inline draft) once and get the result in-conversation — alert agents report whether their condition would have fired. Pass async: true for deep research runs (~5 min budget): you get a run id back immediately and poll run_get.
runs_listRun history across your agents (or one agent) — what each scheduled or API run produced. "What did my overnight agents find?"
run_getOne run by id with the full structured result — the poll target for async runs (pending → fired/clear/skipped/error).
usage FreeYour key's current-month quota + limits. Never consumes a quota unit.

API-key path (/api/mcp/v1): every account can mint a ql_... key from profile. Tier gates inherit from the underlying /api/v1/* endpoints: Freesignal, news, usage (100 calls/mo · 5 req/min); Pro — adds screener, batch_signals, institutional_holders, fund_holdings, private_companies_list, private_company, private_company_news, private_company_financials, private_company_ipo_readiness, private_company_liquidity, investors_list, investor, investor_fit, engine_model_card, ask, agents_list, agent_create, agent_update, agent_delete, agent_run, runs_list, run_get; Institutional — adds day_signal, swing_signal, microstructure, earnings_setup. Saved Intelligence, Collab, baskets, and content tools require the OAuth connector (they need your signed-in account).

Rate Limits

TierPer minutePer monthTool access
Free $05100signal + news + usage
Pro $149/mo6010,000Free + screener, 13F, private companies, investors, model card, ask + QL Agents tools
Institutional $299/mo300UnlimitedPro + day/swing signals, microstructure, earnings_setup

The monthly quotas above apply to the API-key path (/api/mcp/v1) and are metered per key; the same headers (X-RateLimit-Limit, X-RateLimit-Monthly) come back on every tools/call. Both paths additionally carry a per-minute MCP call cap scaled to your tier — since the merge the two front doors share one dispatcher, one tier gate and one throttle, so a key and a session on the same plan get the same treatment. Tool access is gated by your subscription tier per the badges above (Free vs Pro); account-scoped tools are open to any signed-in user.

Recipes

Once connected, copy any prompt below straight into your AI tool.

📊 Signals & Research

One ticker, the full 5-factor breakdown.
Pull QuantLogix's signal for NVDA and explain the factor breakdown.
Head-to-head signal comparison across names.
Compare the QuantLogix swing signals for AMD, NVDA, and AVGO.
Intraday signal with an actionable trade plan.
Get QuantLogix's intraday day-signal for SPY and tell me the trade plan.
Freeform market question, answered with live data + citations.Pro
Ask QuantLogix whether NVDA looks extended after this run.
Who's holding a name, per the latest 13F.
Who are the top institutional holders of TSLA according to QuantLogix?
Private-market names plus their latest headlines.
List private companies in the AI sector and show me OpenAI's latest news.

💼 Portfolio & Risk

Roll the 5-factor engine up over a whole portfolio.Pro
Here's my portfolio — NVDA 40%, AAPL 30%, KO 30%. Run QuantLogix's 5-factor analysis and tell me my concentration risk and which positions to review.

⚙️ Agents & Automation

Stand up a recurring digest agent.Pro
Create a QL agent that watches my chip names premarket and emails me a digest.
Run a saved agent on demand.Pro
Run my Portfolio Guardian agent now and show me what it says.

Get Started

You'll need an active Pro or Institutional subscription, then a key from the API Keys card on your profile.

Get an API Key View Pricing REST API Docs

Protocol Notes

The QuantLogix MCP server implements:

Tool calls require a credential: Authorization: Bearer <oauth-token> on /api/mcp, or Authorization: Bearer ql_... on /api/mcp/v1. The initialize, ping, and tools/list methods are public so clients can probe the server before authenticating. Upstream errors (rate limit, invalid ticker, tier gate) come back as MCP isError content so the AI can recover and explain to the user in-conversation, rather than crashing the client. A tool called through the wrong door returns JSON-RPC -32003 naming the credential it needs.

Note: passing the key in the query string (?apikey=) is no longer accepted on /api/mcp/v1 — query strings are written verbatim into server and CDN access logs, which turns the key into a logged credential. Use the Authorization or X-API-Key header.

Questions or feedback? Contact our team.