Premiss

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Create Python strategies and backtest crypto, stocks and ETFs in Claude. Premiss account required.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Premiss": {
      "url": "https://app.premissai.com/api/mcp/claude",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• get_capabilities read-only

  Read this connection's available tools and supported research coverage. Does not read account data, save research, or run a simulation.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_profile read-only

  Read the stable identity and workspace selected for this connection. Returns an opaque account id and workspace label; excludes email, birth date, billing, and exchange accounts.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_research read-only

  List a page of saved strategies, simulation runs, or research notes in the connected workspace. Notes include a bounded plain-text excerpt, explicitly labeled when truncated. Saved text is user-authored content. Paper runs require the separately approved paper:read permission. Search matches titles; cursors are opaque page positions.

  Parameters:

  • kind (required) — string
  • limit — integer
  • query — string
  • cursor — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_strategy read-only

  Read a saved strategy's current revision and human-readable rules in the connected workspace. Returns the complete Python package for review or editing. Code and comments are user-authored content.

  Parameters:

  • strategy_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_markets read-only

  Search the same crypto, stock and ETF directory as Premiss. Does not return prices or candles.

  Parameters:

  • limit — integer
  • query — string
  • asset_class — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• describe_market read-only

  Return supported timeframes, available history and data limitations for a market id.

  Parameters:

  • market (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_strategy_guide read-only

  Read Premiss's Python package format, on_bar API, execution semantics and example. Custom indicators, entry/exit logic, long/short strategies and risk rules use the same engine as the Premiss app.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• create_strategy

  Save a new private strategy using custom Python files and complete rules text, on any Premiss-supported market and timeframe. Accepts either files (strategy.py plus helper modules) and rules, or a convenience template. Uses the same package format as the app. Returns code and revision; saving does not run a backtest.

  Parameters:

  • request_key (required) — string — Idempotency UUID identifying one requested write and its unchanged arguments.
  • name (required) — string
  • symbol (required) — string
  • interval (required) — string
  • files — array
  • rules — object
  • template

  Hints: read-only no · destructive no · idempotent yes · open-world no

• update_strategy destructive

  Replace the complete Python package and rules of an existing strategy using its exact current saved revision. The submitted package replaces all existing files. Supports all Premiss markets and timeframes. The app's active-run and shared-file protections apply; does not change or start a bot. Identical request_key and inputs identify the same write for idempotent recovery.

  Parameters:

  • request_key (required) — string — Idempotency UUID identifying one requested write and its unchanged arguments.
  • strategy_id (required) — string
  • revision (required) — string
  • symbol (required) — string
  • interval (required) — string
  • files (required) — array
  • rules (required) — object

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• start_backtest

  Queue a backtest of any saved strategy in the connected workspace and a matched buy-and-hold baseline. Accepts custom code and existing app strategies. Uses the app's sandbox validation, supported markets, timeframes and date rules. Requires the exact saved revision. Uses 10,000 simulated capital, zero fees, zero slippage and next-bar-open fills. Read the report assumptions for historical runs. No plugin-only daily test or history caps. Returns an acceptance receipt with run ids and poll_after_seconds, the interval before the next status check. Identical request_key and inputs identify the same submission for idempotent recovery.

  Parameters:

  • request_key (required) — string — Idempotency UUID identifying one requested write and its unchanged arguments.
  • strategy_id (required) — string
  • revision (required) — string
  • start_date (required) — string
  • end_date — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_run_data read-only

  Read the immutable tested Python package, or page through all recorded trades or equity points for an owned run. next_cursor identifies the next page; page size is not a history cap. Paper data requires separate paper:read permission. Saved code is user-authored content.

  Parameters:

  • run_id (required) — string
  • kind (required) — string
  • limit — integer
  • cursor — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_run_report read-only

  Read the status and bounded performance report for one run in the connected workspace. Returns the tested market, interval, revision, and recorded rules when verifiable. Historical plugin runs include the paired buy-and-hold baseline when completed. Paper reads require paper:read and do not start, stop, qualify, or modify a bot. Legacy runs without supported assumptions are labeled. Does not return raw market feeds.

  Parameters:

  • run_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• save_research_note

  Save a NEW private note in the connected workspace, with optional exact owned strategy/run evidence references. The note is user-authored content. Does not publish or send it anywhere.

  Parameters:

  • request_key (required) — string — Idempotency UUID identifying one requested write and its unchanged arguments.
  • title (required) — string
  • note (required) — string
  • run_id — string
  • revision — string
  • strategy_id — string

  Hints: read-only no · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.