View input schema
{
"type": "object",
"properties": {
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"description": {
"maxLength": 1000,
"type": "string"
},
"template_id": {
"description": "An id from acubic_list_strategy_templates: a preset, or advanced for the engine.",
"maxLength": 40,
"type": "string"
},
"experience": {
"description": "Legacy: beginner or intermediate with risk_level selects a preset; prefer template_id. Omit for an engine build.",
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string"
},
"risk_level": {
"description": "Preset only (legacy path): largest acceptable drawdown; prefer template_id.",
"enum": [
"low",
"medium",
"high",
"unconstrained"
],
"type": "string"
},
"asset_classes": {
"uniqueItems": true,
"items": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
],
"type": "string"
},
"minItems": 1,
"type": "array"
},
"regions": {
"uniqueItems": true,
"items": {
"enum": [
"north_america",
"latin_america",
"europe",
"asia_pacific",
"middle_east_africa"
],
"type": "string"
},
"type": "array"
},
"sectors": {
"uniqueItems": true,
"items": {
"enum": [
"technology",
"healthcare",
"financials",
"energy",
"consumer_discretionary",
"consumer_staples",
"industrials",
"materials",
"utilities",
"real_estate",
"communication_services"
],
"type": "string"
},
"type": "array"
},
"include": {
"additionalProperties": false,
"description": "Ids per acubic_list_strategy_options section (index: indices).",
"properties": {
"countries": {
"type": "array"
},
"country_groups": {
"type": "array"
},
"exchanges": {
"type": "array"
},
"currencies": {
"type": "array"
},
"industries": {
"type": "array"
},
"themes": {
"type": "array"
},
"instrument_types": {
"type": "array"
},
"etf_exposures": {
"type": "array"
},
"crypto": {
"type": "array"
},
"index": {
"type": "array"
},
"symbols_only": {
"type": "array"
},
"exclude_leveraged": {
"type": "boolean"
}
},
"type": "object"
},
"asset_count": {
"description": "Number of assets.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"asset_count_range": {
"description": "Instead of asset_count (default 15 to 25).",
"$ref": "#/$defs/McpCountRange",
"type": "object"
},
"position_sizing": {
"description": "Default: the sizes recommended for the number of assets.",
"$ref": "#/$defs/McpSizing",
"type": "object"
},
"class_position_sizing": {
"description": "Per-asset-class sizes overriding position_sizing.",
"additionalProperties": {
"$ref": "#/$defs/McpSizing",
"type": "object"
},
"propertyNames": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
]
},
"type": "object"
},
"ranking": {
"description": "A preset: card (its menu: acubic_list_strategy_templates). The engine: rank_method or rank_blend.",
"$ref": "#/$defs/McpRanking",
"type": "object"
},
"allocation": {
"description": "Weighting id (acubic_list_strategy_options, weighting); default: the recommended one. To compare: acubic_rank_candidates once, then this tool with its candidates_id and each allocation in turn.",
"enum": [
"hrp",
"mvo",
"cvar",
"equal",
"rank",
"rank_equal",
"cap_10",
"cap_20",
"cap_rank_10",
"cap_rank_20",
"cap_score_tilt",
"erc"
],
"type": "string"
},
"filter_rules": {
"description": "Each rule: metric, op, value in the metric's unit (US dollars for market_cap, percent for pct metrics: 40 = 40%).",
"items": {
"$ref": "#/$defs/FilterRule",
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"excluded_symbols": {
"description": "Names removed from the screened pool (Step 1).",
"items": {
"maxLength": 32,
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"locked_symbols": {
"description": "Always held, exempt from every filter.",
"items": {
"maxLength": 32,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"custom_symbols": {
"description": "Tickers to add to the pool, checked as on acubic.ai.",
"uniqueItems": true,
"items": {
"maxLength": 32,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"correlation_limit": {
"description": "Not offered yet: omit it unless acubic_list_strategy_options shows it offered; then 0.50-0.95, step 0.05 (preset: 0.80).",
"maximum": 0.95,
"minimum": 0.5,
"type": "number"
},
"selection_limits": {
"description": "Min/max share of the selection per sector, country or asset class.",
"$ref": "#/$defs/McpSelectionLimits",
"type": "object"
},
"candidates_id": {
"description": "A ranked list from acubic_rank_candidates (valid 1 hour).",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"selected_symbols": {
"description": "Hand-picked names of the candidates_id list (not with allocation or correlation limits).",
"uniqueItems": true,
"items": {
"maxLength": 32,
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"select_count": {
"description": "Top N to select (10, 15, 20, 30 or 50 within the count range; see selection.select_counts). Not with selected_symbols.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"index_card": {
"description": "Build the level's index card (template level_mix.index_card) instead of ranked stocks; no ranking or allocation.",
"type": "boolean"
},
"recipe_id": {
"description": "A recipe id (acubic_list_strategy_options, recipes): sets ranking, sectors, allocation and asset count unless given; your filter_rules add to its own.",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"type": "string"
},
"client_request_id": {
"description": "Idempotency key.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"response_format": {
"default": "concise",
"enum": [
"concise",
"detailed"
],
"type": "string"
},
"locale": {
"description": "The language of this conversation.",
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string"
}
},
"required": [
"name"
],
"$defs": {
"FilterRule": {
"additionalProperties": false,
"description": "One rule: metric op value.",
"properties": {
"metric": {
"description": "A filter metric id (acubic_list_strategy_options, section filters).",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"type": "string"
},
"op": {
"enum": [
">=",
"<=",
">",
"<"
],
"type": "string"
},
"value": {
"description": "The metric's unit: US dollars for market_cap, percent for pct metrics (40 = 40%).",
"type": "number"
}
},
"required": [
"metric",
"op",
"value"
],
"type": "object"
},
"McpBlendEntry": {
"additionalProperties": false,
"description": "One factor of a blend.",
"properties": {
"factor": {
"description": "A ranking factor id (acubic_list_strategy_options).",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"type": "string"
},
"weight": {
"description": "Relative; normalised to sum to 1.",
"exclusiveMinimum": 0,
"type": "number"
},
"window_days": {
"description": "Look-back in days (per factor).",
"enum": [
7,
30,
90,
180,
365,
730,
1095
],
"type": "integer"
}
},
"required": [
"factor",
"weight"
],
"type": "object"
},
"McpCountRange": {
"additionalProperties": false,
"description": "Number of assets, min and max.",
"examples": [
{
"max": 25,
"min": 15
}
],
"properties": {
"min": {
"description": "1 to 50.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"max": {
"description": "1 to 50.",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
"McpDefaultMax": {
"additionalProperties": false,
"properties": {
"sectors": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"countries": {
"maximum": 100,
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"McpGroupBound": {
"additionalProperties": false,
"description": "Share of the selection by count, percent.",
"properties": {
"min_pct": {
"maximum": 100,
"minimum": 0,
"type": "number"
},
"max_pct": {
"maximum": 100,
"minimum": 0,
"type": "number"
}
},
"type": "object"
},
"McpRanking": {
"additionalProperties": false,
"description": "A preset: card. The engine: rank_method or rank_blend.",
"examples": [
{
"card": "momentum"
},
{
"rank_method": "momentum_1y"
}
],
"properties": {
"card": {
"description": "A preset's ranking card, from its menu in acubic_list_strategy_templates (by template_id, or experience and risk_level).",
"enum": [
"market_cap",
"momentum",
"sortino_momentum",
"market_cap_sortino",
"market_cap_sharpe",
"momentum_market_cap"
],
"type": "string"
},
"rank_method": {
"description": "A ranking method id.",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"type": "string"
},
"rank_blend": {
"description": "Up to 20 weighted factors.",
"items": {
"$ref": "#/$defs/McpBlendEntry",
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"type": "object"
},
"McpSelectionLimits": {
"additionalProperties": false,
"description": "Group names as acubic_rank_candidates rows show them.",
"properties": {
"sectors": {
"description": "e.g. Technology",
"additionalProperties": {
"$ref": "#/$defs/McpGroupBound",
"type": "object"
},
"maxProperties": 40,
"type": "object"
},
"countries": {
"description": "e.g. United States",
"additionalProperties": {
"$ref": "#/$defs/McpGroupBound",
"type": "object"
},
"maxProperties": 80,
"type": "object"
},
"asset_classes": {
"additionalProperties": {
"$ref": "#/$defs/McpGroupBound",
"type": "object"
},
"propertyNames": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
]
},
"type": "object"
},
"default_max_pct": {
"description": "Default max percent for every sector or country without its own cap.",
"$ref": "#/$defs/McpDefaultMax",
"type": "object"
}
},
"type": "object"
},
"McpSizing": {
"additionalProperties": false,
"description": "Weight per asset, percent.",
"properties": {
"min_weight_pct": {
"description": "0 to 20, step 0.5 (2.5 is 2.5%).",
"maximum": 20,
"minimum": 0,
"type": "number"
},
"max_weight_pct": {
"description": "1 to 100, step 1; at most 60 unless the lowest asset count is 1 (then 100).",
"maximum": 100,
"minimum": 1,
"type": "number"
}
},
"required": [
"min_weight_pct",
"max_weight_pct"
],
"type": "object"
}
},
"additionalProperties": false
}