Basis

Connect it to your AI

Claude Code

claude mcp add --transport http basis https://www.basischarts.com/api/mcp

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://www.basischarts.com/api/mcp

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "basis": {
      "url": "https://www.basischarts.com/api/mcp"
    }
  }
}

Tools it offers

44 tools, as the server itself reported during our check on Oct 31, 2026.

• catalog_searchSearch what Basis can do: indicators, formula functions, built-in strategies, the extra series available inside strategy expressions, and the drawing tools with the number of anchors each one takes. This is a catalogue o
• catalog_describeFull detail for one catalogue entry: an indicator's parameters and defaults, a formula function's signature, a strategy's parameters, or drawing anchor order/text/style. Call this before passing parameters you have not s
• crypto_quant_guideDomain knowledge for a crypto analysis: the constraints of the topic, the Basis tool chain, and — the part worth calling for — findings Basis has actually measured, each with its sample and verdict, plus the conventional
• market_candlesLoad price history and return a handle to it, plus a summary. The bars themselves are deliberately not returned — pass the handle to the compute tools instead. lastClosedCandle is one exact OHLC bar; high/low are WHOLE-W
• market_relationshipsProfessional multi-asset relationship analysis on timestamp-aligned closed-bar log returns. Returns a correlation matrix plus rolling correlation, OLS beta/alpha, R-squared, upside/downside correlation, relative performa
• market_dominanceCurrent crypto market-cap structure from a server-cached aggregate source: real BTC and ETH dominance, total market cap/volume, tracked stablecoin share and leading asset shares with source and timestamps. Use this for B
• market_derivativesRead current perpetual funding (fonlama/takas ücreti), open interest and positioning directly by symbol, without loading candles first. Optional ref reuses a fresh derivatives handle. Funding is a transfer between longs/
• hyperliquid_whale_readRead current public Hyperliquid positions for a frozen, research-screened whale cohort. Returns account-normalized consensus, participation, agreement, effective-wallet count, single-wallet concentration, liquidity and o
• indicator_computeRun any indicator in the catalogue. Returns EVERY output series it has — Donchian gives three bands, MACD gives line, signal and histogram — each reduced, plus the indicator's own conventional levels so the reading can b
• formula_evaluateEvaluate a Basis formula expression over a loaded window. Functions are listed by catalog_search kind=formula; series named open, high, low, close, volume, returns and more. Multi-line with `let` bindings is supported; t
• backtest_runBacktest one built-in strategy with one set of parameters. Fills happen at the next bar's open and costs are charged per side. Returns risk-adjusted metrics alongside the raw return — judge on those, not on total return.
• strategy_researchRun one chronological research experiment across many built-in strategies, instruments and timeframes. Use this for broad discovery instead of many backtest_run calls — and in particular instead of testing one strategy o
• position_calculateRisk-first position sizing with quantity, notional, margin, effective leverage, fees, funding, breakeven, liquidation estimate, target R multiples and warnings. Use position_plan_on_chart instead when the user should see
• trade_experience_retrieveRetrieve compact historical trade analogues for the current market state. Plans are deterministic synthetic templates, while fills, stop/target ordering, MAE/MFE and outcomes are settled on later historical candles with
• news_recentRecent crypto headlines with an impact score and the assets each one touches. Impact is a keyword heuristic, not a judgement about the market. Pass hours for "today" or "the last 24 hours"; every headline says how old it
• news_detect_assetsWhich crypto assets a piece of text refers to. Word-bounded, so "button" does not match TON and "operation" does not match OP.
• chart_stateThe chart you are building for this person: venue, symbol, timeframe, chart type, every indicator with its instance id and parameters, and every drawing. Start here when you need an instance id, and call it again after c
• chart_set_instrumentPoint the chart at a market. Venue and symbol as the exchange writes them, e.g. BTCUSDT on binance. This changes the chart you are building, which the person opens through chart_link.
• chart_set_timeframeChange the chart timeframe, e.g. 15m, 1h, 4h, 1d. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
• chart_set_typeChange how price is drawn — candles, heikin ashi, line, renko, footprint and others. A wrong id is refused, and the refusal lists every one that works. Changes the chart you are building; finish with chart_link, or analy
• chart_add_indicatorPut an indicator on the chart. studyId is an id or a common name ("ema20", "bollinger"); catalog_describe lists parameters. Omitted ones use the default. Changes the chart you are building; finish with chart_link, or ana
• chart_update_indicatorEdit the parameters of an existing indicator instance. First call chart_state to get its instance id; use catalog_describe for supported parameters. To delete use chart_remove_indicator, to hide/show use chart_toggle_ind
• chart_remove_indicatorDelete an indicator instance from the chart. Use chart_state to find its instance id. To temporarily hide it instead, use chart_toggle_indicator. Changes the chart you are building; finish with chart_link, or analysis_pr
• chart_toggle_indicatorHide or show an indicator without removing it — useful for comparing a chart with and without something. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs huma
• drawing_addDraw measured geometry or explain it with text, note, callout or emoji. Points are {time, price} in chart coordinates — time in seconds, matching the candle timestamps a data handle reports. A horizontal line needs one p
• fibonacci_drawDraw a Fibonacci study directly on the chart with exact candle coordinates and optional custom ratios. Supports retracement, extension, channel, time, fan, circle, spiral, arc and wedge variants. Prefer swing timestamps/
• drawing_freehandCreate one or more precise freehand strokes as a single undoable composition. A stroke accepts arbitrary chart points; line accepts two endpoints; ellipse and rectangle accept two opposite corners and are generated smoot
• position_draw_on_chartThe chart-only long/short position drawing tool. Draw an entry, stop and target box immediately when those price levels are known. It needs no account equity or risk percentage, performs no position sizing and places no
• position_plan_on_chartCalculate a risk-first long/short position and draw the entry, stop and first target directly on the live chart. The drawing retains quantity, notional, margin, costs, liquidation estimate, targets, warnings and an optio
• drawing_styleEdit only the requested properties of an existing drawing; all others are preserved. For a text edit send just {id,text,fontSize}; never copy the entire stored style or its hex colours. Get the id from chart_state. Use i
• drawing_deleteDelete a drawing. This cannot be undone — the shape is not recoverable — so the user is asked first. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human re
• screener_runScan the venue's listed instruments for ones matching conditions, instead of looking at the open chart. Rules combine price fields, any indicator plot, or a formula expression, with ALL/ANY matching. This is the tool for
• daytrade_opportunity_scanRun one symmetric long/short scan over the same top-volume universe and return rule-independent breadth, 24h liquidity semantics and ranked directional candidates. Use this first for comprehensive day-trade or scalp disc
• screener_backtestHistorically replay a cross-sectional screen at every bar. Matching instruments form an equal-weight long or short portfolio, entered at the next bar open and held to the following bar open, then re-screened. Use this wh
• calendar_upcomingScheduled events ahead: FOMC rate decisions, US CPI and non-farm payrolls from the Fed's and BLS's published calendars, the next funding settlements for a contract, the Bitcoin halving projected from live block height, d
• orderflow_readEXECUTED trades only, not resting orders. For current resting liquidity or walls use orderbook_read. Aggressor-side order flow: buy and sell volume separated by who crossed the spread, delta, the footprint by price level
• orderbook_readRead current displayed resting bid/ask limit orders on Binance, Bybit, OKX or Hyperliquid perpetuals. Use for resting liquidity, order book/DOM and buy/sell walls, NOT orderflow_read, which reads executed trades. Returns
• news_historyRead archived crypto headlines, newest first, with source links. Use news_recent for live headlines. Paginate with nextBefore (ISO timestamp). Archive coverage starts when Basis began collecting; an empty page does not p
• calendar_historyPast calendar dates: FOMC rate decisions, US CPI and non-farm payroll releases from the Fed's and BLS's published calendars (February 2025 on), plus reconstructed conventions (options expiry, CME settlement). Dates only:
• chart_linkPublish the chart and get a URL the person can open in Basis. Call it at the end of any answer about a market: the chart is half the answer. Either build first with the chart tools, or pass symbol, timeframe, indicators

Questions