Skip to main content
Glama

Save a strategy

create_strategy
Idempotent

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. Custom code is loaded in the sandbox before saving. Returns code and revision; saving does not run a backtest.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "request_key": "<request_key>",
      "name": "<name>",
      "symbol": "<symbol>",
      "interval": "<interval>"
    },
    "name": "create_strategy"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameYes
filesNo
rulesNo
symbolYesMarket id or alias from search_markets, such as BTC, SP500, NVDA or GOLD.
intervalYesBar size the strategy trades. Each market's bar sizes are in describe_market. Backtests run on every bar size the market offers; paper bots run on 1h bars and longer on every plan and on 5m bars and longer on Pro.
templateNo
request_keyYesIdempotency UUID identifying one requested write and its unchanged arguments.

Output Schema

NameRequiredDescriptionDefault
idYes
nameYes
filesNo
rulesYes
venueNo
symbolYes
app_urlYes
versionYes
intervalYes
revisionYes
templateYes
specificationNo
engine_versionNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / interval / description
      Previous value: -"Bar size the strategy trades. Each market's bar sizes are in describe_market. Backtests under 1h are on the Pro plan; paper bots run on 1h bars and longer on every plan."New value: +"Bar size the strategy trades. Each market's bar sizes are in describe_market. Backtests run on every bar size the market offers; paper bots run on 1h bars and longer on every plan and on 5m bars and longer on Pro."
  2. Changed6 schema fields changed
    • addedInput schema / properties / interval / description
      Added value: +"Bar size the strategy trades. Each market's bar sizes are in describe_market. Backtests under 1h are on the Pro plan; paper bots run on 1h bars and longer on every plan."
    • changedInput schema / properties / interval / enum
      Previous value: -[
      -  "1m",
      -  "3m",
      -  "5m",
      -  "15m",
      -  "30m",
      -  "1h",
      -  "2h",
      -  "4h",
      -  "6h",
      -  "8h",
      -  "12h",
      -  "1d",
      -  "3d",
      -  "1w",
      -  "1M"
      -]New value: +[
      +  "1m",
      +  "5m",
      +  "15m",
      +  "30m",
      +  "1h",
      +  "2h",
      +  "4h",
      +  "6h",
      +  "12h",
      +  "1d",
      +  "1w"
      +]
    • addedInput schema / properties / symbol / description
      Added value: +"Market id or alias from search_markets, such as BTC, SP500, NVDA or GOLD."
    • changedInput schema / properties / symbol / maxLength
      Previous value: -20New value: +40
    • addedOutput schema / properties / engine_version
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": -9007199254740991,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / specification
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "conditional_fills": {
      +      "default": "live_range_touch",
      +      "enum": [
      +        "completed_bar_touch",
      +        "live_range_touch"
      +      ],
      +      "type": "string"
      +    },
      +    "conversions": {
      +      "default": [],
      +      "items": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "assumption": {
      +                "maxLength": 300,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "currency": {
      +                "pattern": "^[A-Z][A-Z0-9]{1,15}$",
      +                "type": "string"
      +              },
      +              "kind": {
      +                "const": "fixed",
      +                "default": "fixed",
      +                "type": "string"
      +              },
      +              "rate": {
      +                "decimalBounds": {
      +                  "gt": 0,
      +                  "maxDigits": 42
      +                },
      +                "pattern": "^-?(0|[1-9][0-9]{0,41})(\\.[0-9]{1,18})?$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "assumption",
      +              "currency",
      +              "rate"
      +            ],
      +            "title": "FixedConversion",
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "currency": {
      +                "pattern": "^[A-Z][A-Z0-9]{1,15}$",
      +                "type": "string"
      +              },
      +              "feed_id": {
      +                "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                "type": "string"
      +              },
      +              "inverted": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "kind": {
      +                "const": "feed",
      +                "default": "feed",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "currency",
      +              "feed_id"
      +            ],
      +            "title": "FeedConversion",
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "maxItems": 16,
      +      "type": "array"
      +    },
      +    "execution_feeds": {
      +      "items": {
      +        "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +        "type": "string"
      +      },
      +      "maxItems": 16,
      +      "minItems": 1,
      +      "type": "array"
      +    },
      +    "feeds": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "adjustment": {
      +            "default": "raw",
      +            "enum": [
      +              "raw",
      +              "split_adjusted",
      +              "total_return"
      +            ],
      +            "type": "string"
      +          },
      +          "allow_gaps": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "calendar": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "id": {
      +            "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +            "type": "string"
      +          },
      +          "instrument": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "interval": {
      +            "maxLength": 32,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "lookback": {
      +            "default": 500,
      +            "maximum": 5000,
      +            "minimum": 1,
      +            "type": "integer"
      +          },
      +          "required_history": {
      +            "default": 1,
      +            "maximum": 5000,
      +            "minimum": 1,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "calendar",
      +          "id",
      +          "instrument",
      +          "interval"
      +        ],
      +        "title": "FeedSpec",
      +        "type": "object"
      +      },
      +      "maxItems": 32,
      +      "minItems": 1,
      +      "type": "array"
      +    },
      +    "fill_callback_orders": {
      +      "default": "next_trading_minute",
      +      "enum": [
      +        "next_execution_bar",
      +        "next_trading_minute"
      +      ],
      +      "type": "string"
      +    },
      +    "instruments": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "allow_short": {
      +            "default": false,
      +            "type": "boolean"
      +          },
      +          "asset_class": {
      +            "enum": [
      +              "crypto",
      +              "equity",
      +              "etf",
      +              "stock",
      +              "index",
      +              "commodity"
      +            ],
      +            "type": "string"
      +          },
      +          "base_currency": {
      +            "anyOf": [
      +              {
      +                "pattern": "^[A-Z][A-Z0-9]{1,15}$",
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "default": null
      +          },
      +          "id": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "perpetual": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "contract": {
      +                    "const": "linear",
      +                    "type": "string"
      +                  },
      +                  "funding_interval_ms": {
      +                    "const": 3600000,
      +                    "type": "number"
      +                  },
      +                  "leverage": {
      +                    "maximum": 100,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "liquidation": {
      +                    "const": "hyperliquid_isolated_v1",
      +                    "type": "string"
      +                  },
      +                  "margin_mode": {
      +                    "const": "isolated",
      +                    "type": "string"
      +                  },
      +                  "margin_tiers": {
      +                    "items": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "lower_bound": {
      +                          "decimalBounds": {
      +                            "ge": 0,
      +                            "maxDigits": 42
      +                          },
      +                          "pattern": "^-?(0|[1-9][0-9]{0,41})(\\.[0-9]{1,18})?$",
      +                          "type": "string"
      +                        },
      +                        "max_leverage": {
      +                          "maximum": 100,
      +                          "minimum": 1,
      +                          "type": "integer"
      +                        }
      +                      },
      +                      "required": [
      +                        "lower_bound",
      +                        "max_leverage"
      +                      ],
      +                      "title": "MarginTier",
      +                      "type": "object"
      +                    },
      +                    "maxItems": 8,
      +                    "minItems": 1,
      +                    "type": "array"
      +                  },
      +                  "min_order_notional": {
      +                    "decimalBounds": {
      +                      "gt": 0,
      +                      "maxDigits": 42
      +                    },
      +                    "default": "10",
      +                    "pattern": "^-?(0|[1-9][0-9]{0,41})(\\.[0-9]{1,18})?$",
      +                    "type": "string"
      +                  },
      +                  "price_basis": {
      +                    "const": "execution_trades",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "contract",
      +                  "funding_interval_ms",
      +                  "leverage",
      +                  "liquidation",
      +                  "margin_mode",
      +                  "margin_tiers",
      +                  "price_basis"
      +                ],
      +                "title": "PerpetualSpec",
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ],
      +            "default": null
      +          },
      +          "quantity_step": {
      +            "decimalBounds": {
      +              "gt": 0,
      +              "maxDigits": 42
      +            },
      +            "pattern": "^-?(0|[1-9][0-9]{0,41})(\\.[0-9]{1,18})?$",
      +            "type": "string"
      +          },
      +          "quote_currency": {
      +            "pattern": "^[A-Z][A-Z0-9]{1,15}$",
      +            "type": "string"
      +          },
      +          "symbol": {
      +            "maxLength": 64,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "venue": {
      +            "maxLength": 64,
      +            "minLength": 1,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "asset_class",
      +          "id",
      +          "quantity_step",
      +          "quote_currency",
      +          "symbol",
      +          "venue"
      +        ],
      +        "title": "InstrumentSpec",
      +        "type": "object"
      +      },
      +      "maxItems": 16,
      +      "minItems": 1,
      +      "type": "array"
      +    },
      +    "intrabar_ambiguity": {
      +      "default": "minute_detail_stop_first",
      +      "enum": [
      +        "reject",
      +        "minute_detail_stop_first"
      +      ],
      +      "type": "string"
      +    },
      +    "reporting_currency": {
      +      "default": "USD",
      +      "pattern": "^[A-Z][A-Z0-9]{1,15}$",
      +      "type": "string"
      +    },
      +    "schedules": {
      +      "default": [],
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "ambiguous_time": {
      +            "default": "first",
      +            "enum": [
      +              "first",
      +              "second"
      +            ],
      +            "type": "string"
      +          },
      +          "hour": {
      +            "maximum": 23,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "id": {
      +            "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +            "type": "string"
      +          },
      +          "minute": {
      +            "maximum": 59,
      +            "minimum": 0,
      +            "type": "integer"
      +          },
      +          "nonexistent_time": {
      +            "const": "skip",
      +            "default": "skip",
      +            "type": "string"
      +          },
      +          "timezone": {
      +            "maxLength": 128,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "weekdays": {
      +            "items": {
      +              "maximum": 6,
      +              "minimum": 0,
      +              "type": "integer"
      +            },
      +            "maxItems": 7,
      +            "minItems": 1,
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "hour",
      +          "id",
      +          "minute",
      +          "timezone",
      +          "weekdays"
      +        ],
      +        "title": "ScheduleSpec",
      +        "type": "object"
      +      },
      +      "maxItems": 16,
      +      "type": "array"
      +    },
      +    "schema_version": {
      +      "const": 2,
      +      "default": 2,
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "execution_feeds",
      +    "feeds",
      +    "instruments"
      +  ],
      +  "title": "SimulationSpec",
      +  "type": "object"
      +}
  3. First observed

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (readOnlyHint=false, idempotentHint=true, destructiveHint=false), the description discloses that custom code is sandbox-loaded before saving, that the package format matches the app, and that no backtest is executed as a side effect. These are genuine behavioral facts an agent could not derive from the structured fields, though nothing is said about validation failures or partial-save behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in the first clause, and the following sentences each add a distinct fact (input modes, package format, sandbox loading, no backtest). 'Uses the same package format as the app' is the weakest sentence and borders on redundant with the sandbox sentence, but overall it is tight.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be spelled out, and the annotations already declare idempotency and non-destructiveness. For a mutation tool with nested objects the description covers the essentials: what is created, the two input shapes, validation timing, and the absence of a backtest side effect.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is only 43%, so the description carries real weight here, and it does explain the crucial relationship between `files` (strategy.py plus helper modules) and `template` as alternative inputs. But it adds nothing about the `rules` object's four required sub-fields or the individual template parameters, leaving much of the low-coverage surface unexplained.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb+resource ('Save a new private strategy') and scopes it to 'any Premiss-supported market and timeframe', and the word 'new' implicitly separates it from update_strategy. It stops short of naming update_strategy or get_strategy explicitly, so the sibling differentiation is inferable rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It clarifies the two input modes (files+rules versus a convenience template) and notes that saving does not run a backtest, which nudges the agent toward start_backtest for that need. However, there is no explicit statement of when to use this versus update_strategy, nor any prerequisite or plan/permission guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources