# Basis

> Crypto market data, 200 indicators, order flow and a chart link. No account, no API key.

- name: com.basischarts/basis
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 80/100 flags: no-repository
- quality: 72/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.basischarts%2Fbasis
- tools: https://api.protogrid.dev/v1/servers/com.basischarts%2Fbasis/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "basis": {
      "type": "http",
      "url": "https://www.basischarts.com/api/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 85
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% ~updated-30d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 72/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 43 of 43 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- warn `tools.token_cost`: about 13,234 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 32 tool changes in 30 days
- fail `stability.rug_pull`: 2 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 43, about 13,234 tokens to load them all
- tool set hash: 1445740e4703fe5b014f1fd95380376c
- tools last changed: 2026-10-19T19:09:48.929Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.basischarts/basis.svg)](https://protogrid.dev/servers/com.basischarts/basis)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-19 `analysis_prepare` added
  - Prepare a PRIVATE sharing package of the current chart image, editable analysis and social caption. Only use when asked for something shareable. Returns a private review link, NOT a public link. The person must open it, edit/review and explicitly publish; you cannot publish or post on their behalf. Chart annotations are included. Do not include private account information.
- 2026-10-19 `drawing_delete` changed (description)
  - before: Delete a drawing. This cannot be undone — the shape is not recoverable — so the user is asked first. Changes the chart you are building; call chart_link when you are done so the person can open it.
  - after: Delete 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 review.
- 2026-10-19 `drawing_style` changed (description)
  - before: Change how an existing drawing looks. Get the id from chart_state. Use it to keep several drawings apart — a measured level and a projected one should not be the same colour, and a reader has only the picture to tell them by. Changes the chart you are building; call chart_link when you are done so the person can open it.
  - after: Change how an existing drawing looks. Get the id from chart_state. Use it to keep several drawings apart — a measured level and a projected one should not be the same colour, and a reader has only the picture to tell them by. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- 2026-10-19 `position_plan_on_chart` changed (description)
  - before: Calculate 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 optional sandbox program id so later analysis reads the same plan the user sees. Changes the chart you are building; call chart_link when you are done so the person can open it.
  - after: Calculate 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 optional sandbox program id so later analysis reads the same plan the user sees. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- 2026-10-19 `position_draw_on_chart` changed (description)
  - before: The 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 order. Use position_plan_on_chart instead only when the user also wants quantity and risk calculations. Changes the chart you are building; call chart_link when you are done so the person can open it.
  - after: The 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 order. Use position_plan_on_chart instead only when the user also wants quantity and risk calculations. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- 2026-10-19 `drawing_freehand` changed (description)
  - before: Create 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 smoothly. Use highlighter for translucent emphasis and brush for circles, paths and marks. Changes the chart you are building; call chart_link when you are done so the person can open it.
  - after: Create 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 smoothly. Use highlighter for translucent emphasis and brush for circles, paths and marks. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- 2026-10-19 `fibonacci_draw` changed (description)
  - before: Draw 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/prices returned by market_candles computations rather than visual guesses. Changes the chart you are building; call chart_link when you are done so the person can open it.
  - after: Draw 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/prices returned by market_candles computations rather than visual guesses. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- 2026-10-19 `drawing_add` changed (description)
  - before: Draw on the chart. Points are {time, price} in chart coordinates — time in seconds, matching the candle timestamps a data handle reports. A horizontal line needs one point; a trendline or box needs two. Both numbers must be copied from a tool result — a summary's max with its maxAt, a crossing with its time — never read off your own prose or carried over from a different computation. The result echoes back what was drawn: check it against the figures you are about to quote, because a line that disagrees with the paragraph beside it is worse than no line. Changes the chart you are building; call chart_link when you are done so the person can open it.
  - after: Draw on the chart. Points are {time, price} in chart coordinates — time in seconds, matching the candle timestamps a data handle reports. A horizontal line needs one point; a trendline or box needs two. Both numbers must be copied from a tool result — a summary's max with its maxAt, a crossing with its time — never read off your own prose or carried over from a different computation. The result echoes back what was drawn: check it against the figures you are about to quote, because a line that disagrees with the paragraph beside it is worse than no line. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- 2026-10-19 `chart_toggle_indicator` changed (description)
  - before: Hide or show an indicator without removing it — useful for comparing a chart with and without something. Changes the chart you are building; call chart_link when you are done so the person can open it.
  - after: Hide 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 human review.
- 2026-10-19 `chart_remove_indicator` changed (description)
  - before: Delete 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; call chart_link when you are done so the person can open it.
  - after: Delete 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_prepare for a sharing draft that needs human review.

Full history: https://api.protogrid.dev/v1/servers/com.basischarts%2Fbasis/changes

## Remotes

- https://www.basischarts.com/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (43)

- `alert_link`: Prepare a price, indicator, chart-drawing, news, calendar or Founder whale-group alert and get a link that sets it in Basis in one click. Use it whenever the person wants to be told when something happens -- a level breaks, RSI crosses 70, price crosses a trend line, a high-impact ETF headline lands, or an event approaches. Pass exactly one of price, conditions, drawingId or eventTrigger. Give the URL as a link and say in one line what it watches. Nothing is armed until they open it and confirm. Market alerts can run in an open tab; background and event alerts require a signed-in Basis account. The link lasts seven days.
- `analysis_prepare`: Prepare a PRIVATE sharing package of the current chart image, editable analysis and social caption. Only use when asked for something shareable. Returns a private review link, NOT a public link. The person must open it, edit/review and explicitly publish; you cannot publish or post on their behalf. Chart annotations are included. Do not include private account information.
- `backtest_run`: Backtest 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.
- `calendar_history`: Past 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: NOT actual, forecast or previous economic values. No historical funding or halving feed. Use calendar_upcoming for future events.
- `calendar_upcoming`: Scheduled 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, difficulty retargets, monthly options expiry and CME settlement. Every row states where its date came from — live, an official schedule, a published rule, an estimate, or the user — because a halving projected from block arrival and an expiry fixed by convention are not equally certain. Use it before saying anything about what happens next; nothing else here looks forward.
- `catalog_describe`: Full detail for one catalogue entry: an indicator's parameters and defaults, a formula function's signature, or a strategy's parameters. Call this before passing parameters you have not seen.
- `catalog_search`: Search 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. Exact counts are in the system prompt catalogue. Use this before assuming something does or does not exist — and always before drawing, because a drawing tool id you guessed is refused. An empty query lists a kind; no kind searches them all.
- `chart_add_indicator`: Put 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 analysis_prepare for a sharing draft that needs human review.
- `chart_image`: See the chart you are building: returns a PNG of it -- candles, volume, every indicator and drawing -- rendered the way Basis draws it, plus the exact figures it shows. Use it to check structure, levels and what you drew before you describe them. Build first with the chart tools, or pass symbol, timeframe, indicators and levels to build and look in one call. Pixels are for shape; quote numbers from the figures or the data tools.
- `chart_link`: Publish 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 and levels here to build and publish in one call. Give the URL as a link and say in one line what it shows. No account needed; the link lasts seven days.
- `chart_remove_indicator`: Delete 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_prepare for a sharing draft that needs human review.
- `chart_set_instrument`: Point 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_timeframe`: Change 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_type`: Change 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 analysis_prepare for a sharing draft that needs human review.
- `chart_state`: The 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 changes to confirm what landed. Finish with chart_link to give the person something to open.
- `chart_toggle_indicator`: Hide 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 human review.
- `chart_update_indicator`: Edit 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_indicator. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- `crypto_quant_guide`: Domain 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 readings it has NOT measured, marked as such. Call it before analysing a chart pattern, interpreting an indicator level, designing a strategy or judging a result that looks strong. It carries no live market data.
- `daytrade_opportunity_scan`: Run 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 discovery; then deep-dive only the shortlist with derivatives/order-flow tools. A low match count is never reported as breadth.
- `drawing_add`: Draw on the chart. Points are {time, price} in chart coordinates — time in seconds, matching the candle timestamps a data handle reports. A horizontal line needs one point; a trendline or box needs two. Both numbers must be copied from a tool result — a summary's max with its maxAt, a crossing with its time — never read off your own prose or carried over from a different computation. The result echoes back what was drawn: check it against the figures you are about to quote, because a line that disagrees with the paragraph beside it is worse than no line. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- `drawing_delete`: Delete 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 review.
- `drawing_freehand`: Create 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 smoothly. Use highlighter for translucent emphasis and brush for circles, paths and marks. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- `drawing_style`: Change how an existing drawing looks. Get the id from chart_state. Use it to keep several drawings apart — a measured level and a projected one should not be the same colour, and a reader has only the picture to tell them by. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- `fibonacci_draw`: Draw 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/prices returned by market_candles computations rather than visual guesses. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- `formula_evaluate`: Evaluate 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; the last expression is the result.
- `founders_preview`: What Basis Founders adds to this connection, and the live totals a non-member may see: how many screened Hyperliquid whales are tracked, their combined book and the coin most of them hold. Founders is an optional paid membership; this tool is free and always answers. Use it when a question needs whale positions, whale or gamma levels, more than 30 days of derivatives history, or a stock or commodity on Hyperliquid or Binance.
- `hyperliquid_whale_read`: Read 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 optional recent fills for the focus symbol. Use this for whale/smart-money positioning as one evidence family, never as a standalone signal.
- `indicator_compute`: Run 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 be interpreted against its actual scale. Pass a symbol to load and compute in one call, or a handle to reuse data. The forming bar is excluded unless you ask for it.
- `market_candles`: Load 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. Defaults to whatever is on the chart.
- `market_derivatives`: Funding, open interest, positioning and taker flow for a loaded contract. Venues publish different subsets; anything a venue does not publish comes back as unavailable rather than zero.
- `market_dominance`: Current 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 BTC.D/rotation context. This is a current snapshot, not a historical dominance backtest series.
- `market_relationships`: Professional 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 performance, one-bar lead/lag diagnostics and a rolling log-price spread z-score versus a benchmark. Use this for BTC correlation, beta, pairs and relative-strength work; price-level correlation is deliberately not reported.
- `news_detect_assets`: Which crypto assets a piece of text refers to. Word-bounded, so "button" does not match TON and "operation" does not match OP.
- `news_history`: Read 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 prove no news occurred. No full article text.
- `news_recent`: Recent 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 is.
- `orderflow_read`: Aggressor-side order flow: buy and sell volume separated by who crossed the spread, delta, the footprint by price level, the point of control, and absorption or stacked imbalance. Measured from the venue aggressor tag, not inferred from bar direction — use it when the question is who is being aggressive, which candles cannot answer. For one candle pass candleTime, which reads exactly that bar; otherwise it reads the last `minutes`. Report coveredMinutes, not the minutes asked for.
- `position_calculate`: Risk-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 the plan on the chart.
- `position_draw_on_chart`: The 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 order. Use position_plan_on_chart instead only when the user also wants quantity and risk calculations. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- `position_plan_on_chart`: Calculate 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 optional sandbox program id so later analysis reads the same plan the user sees. Changes the chart you are building; finish with chart_link, or analysis_prepare for a sharing draft that needs human review.
- `screener_backtest`: Historically 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 when the question is whether repeatedly trading screener matches worked — a single-symbol backtest of coins that match today is not a substitute. Costs follow actual portfolio turnover, so an unchanged holding is not charged as a fresh round trip.
- `screener_run`: Scan 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 "which coins are doing X right now". It fetches history for every instrument in the universe, so it is slow and worth asking for once with the right conditions rather than repeatedly with narrower ones.
- `strategy_research`: Run 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 on coin after coin, which is a search whether or not it is called one. It ranks only on a selection window, checks several subperiods, leaves an embargo, reveals held-out performance, doubles costs as a stress test, compares buy-and-hold, and corrects the selected Sharpe for every strategy/symbol/timeframe combination tried.
- `trade_experience_retrieve`: Retrieve 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 costs. Use it to compare similar wins and failures, never as proof of an edge.