Explain, screen, build and backtest systematic portfolios from eToro and Trading 212 universes.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancels a backtest that is still running, like Cancel on acubic.ai: the allowance it used is returned and the previous saved result stays. Needs the run_id from acubic_run_backtest. To remove a strategy use acubic_delete_strategy.
The run_id acubic_run_backtest returned.
The strategy the run belongs to.
The language of this conversation.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http acubic https://mcp.acubic.ai/mcp
Cancels a backtest that is still running, like Cancel on acubic.ai: the allowance it used is returned and the previous saved result stays. Needs the run_id from acubic_run_backtest. To remove a strategy use acubic_delete_strategy.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| run_id* | string | The run_id acubic_run_backtest returned. |
| strategy_id* | string | The strategy the run belongs to. |
{
"type": "object",
"required": [
"strategy_id",
"run_id"
],
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"run_id": {
"type": "string",
"format": "uuid",
"description": "The run_id acubic_run_backtest returned."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The strategy the run belongs to."
}
},
"additionalProperties": false
}Creates and saves a new draft strategy from the acubic.ai builder's choices: universe, include lists, asset count, sizes, ranking, weighting, filter rules, limits, and tickers to add, exclude or lock. A preset (template_id) fixes the menu; without one every engine argument is open. It uses one portfolio generation from the plan's allowance; with a candidates_id from acubic_rank_candidates it saves that pick at no generation cost. A saved strategy keeps its method: to try another, build again (see allocation); acubic_regenerate_suggestion does not change it. May return a build_id for acubic_get_build_status. To edit one use acubic_update_strategy. Always show the automation.url it returns (automate on acubic.ai).
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| locale | string | The language of this conversation. |
| include | object | Ids per acubic_list_strategy_options section (index: indices). |
| ranking | object | A preset: card (its menu: acubic_list_strategy_templates). The engine: rank_method or rank_blend. |
| regions | array | |
| sectors | array | |
| recipe_id | string | A recipe id (acubic_list_strategy_options, recipes): sets ranking, sectors, allocation and asset count unless given; your filter_rules add to its own. |
| allocation | string | 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. |
| experience | string | Legacy: beginner or intermediate with risk_level selects a preset; prefer template_id. Omit for an engine build. |
| index_card | boolean | Build the level's index card (template level_mix.index_card) instead of ranked stocks; no ranking or allocation. |
| risk_level | string | Preset only (legacy path): largest acceptable drawdown; prefer template_id. |
Deletes a draft or paper-money strategy by archiving it together with its saved backtest; it can be restored within 30 days (acubic_restore_strategy). A strategy with a broker connection is removed on acubic.ai. The person is asked to confirm, or the result gives a confirm_token to pass back once they agree. To stop a running backtest use acubic_cancel_backtest.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| strategy_id* | string | The draft or paper-money strategy to delete. |
| confirm_token | string | For clients without elicitation: the confirm_token from the first call's confirmation_required result, sent once the person agreed. |
{
"type": "object",
"required": [
"strategy_id"
],
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The draft or paper-money strategy to delete."
},
"confirm_token": {
"type": "string",
"maxLength": 200,
"description": "For clients without elicitation: the confirm_token from the first call's confirmation_required result, sent once the person agreed."
}
},
"additionalProperties": false
}Explains one investing term or Acubic setting in plain language (a metric such as P/E or maximum drawdown, a filter, ranking or weighting method, risk level, rebalance or backtest term): its meaning, how Acubic uses it, default, caveats and its page. Use it whenever the user asks what a term means, so the answer matches how Acubic computes it. It does not say what a person should choose. For articles, pricing or the FAQ use acubic_search_knowledge.
| Argument | Type | Description |
|---|---|---|
| kind | string | Limit to one kind of term. |
| topic* | string | A term or option id, e.g. 'P/E ratio', 'pe', 'cap_rank_10', 'walk-forward'. |
| locale | string | The language of this conversation. |
| response_format | string |
{
"type": "object",
"required": [
"topic"
],
"properties": {
"kind": {
"enum": [
"metric",
"filter",
"ranking_method",
"allocation_method",
"experience_level",
"risk_level",
"rebalance_frequency",
"backtest_term",
"other"
],
"type": "string",
"description": "Limit to one kind of term."
},
"topic": {
"type": "string",
"maxLength": 100,
"minLength": 2,
"description": "A term or option id, e.g. 'P/E ratio', 'pe', 'cap_rank_10', 'walk-forward'."
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Returns the signed-in person's plan, allowance used and when it resets, live-portfolio limits, language, experience level, and a plan comparison with an upgrade link. It does not return the email, payment or broker details. For live holdings use acubic_get_portfolio.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
{
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
}
},
"additionalProperties": false
}Returns the latest saved walk-forward backtest of one strategy: assumptions, CAGR, volatility, Sharpe and Sortino, maximum drawdown and total return against the S&P 500 (SPY), yearly returns, drawdown episodes and last holdings; include adds the equity curve. Figures are hypothetical and carry a disclosure. Read it once a run has finished; to follow a run use acubic_get_backtest_status.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| run_id | string | A finished run of acubic_run_backtest to read. |
| include | array | equity_series: curves vs SPY (up to 200 points); performance_summary: report rows. detailed includes both. |
| strategy_id* | string | The strategy whose latest saved backtest to read. |
| response_format | string |
{
"type": "object",
"required": [
"strategy_id"
],
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"run_id": {
"type": "string",
"format": "uuid",
"description": "A finished run of acubic_run_backtest to read."
},
"include": {
"type": "array",
"items": {
"enum": [
"equity_series",
"performance_summary"
],
"type": "string"
},
"description": "equity_series: curves vs SPY (up to 200 points); performance_summary: report rows. detailed includes both.",
"uniqueItems": true
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The strategy whose latest saved backtest to read."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Checks a run of acubic_run_backtest without opening a card: percent done and poll_after_seconds, then the headline figures (hypothetical, with a disclosure). A run that failed or was cancelled is an error and nothing was charged. Use it to wait; read the full result once with acubic_get_backtest.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| run_id* | string | The run_id acubic_run_backtest returned. |
| strategy_id* | string | The strategy the run belongs to. |
{
"type": "object",
"required": [
"strategy_id",
"run_id"
],
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"run_id": {
"type": "string",
"format": "uuid",
"description": "The run_id acubic_run_backtest returned."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The strategy the run belongs to."
}
},
"additionalProperties": false
}Tracks a new draft from acubic_create_strategy by its build_id while it is assembled: progress and poll_after_seconds, then the saved strategy's id to open once. A failed or cancelled build is an error that cost nothing. Backtests have acubic_get_backtest_status.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| build_id* | string | The build_id acubic_create_strategy returned. |
{
"type": "object",
"required": [
"build_id"
],
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"build_id": {
"type": "string",
"format": "uuid",
"description": "The build_id acubic_create_strategy returned."
}
},
"additionalProperties": false
}Returns holdings, value, return since activation and the last rebalance outcome of the person's live or paper-money strategies, from Acubic's latest daily snapshot (as_of); it does not contact the broker and never returns credentials or account numbers. Use it for how a running portfolio is doing; to start automating use acubic_go_live.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size. |
| cursor | string | A previous next_cursor. |
| locale | string | The language of this conversation. |
| strategy_id | string | One strategy; omit for all that have a live or paper book. |
| response_format | string |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Page size."
},
"cursor": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "A previous next_cursor."
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "One strategy; omit for all that have a live or paper book."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Returns one saved strategy: holdings and weights, its settings (experience and risk level, ranking, weighting, asset count, filters, locks), data date, the summary of its latest saved backtest and its broker connection. It also accepts the build_id of a finished build (while it runs use acubic_get_build_status). Figures are hypothetical and carry a disclosure. For the full backtest use acubic_get_backtest.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| build_id | string | A build_id of acubic_create_strategy; resolves to the strategy once saved. |
| strategy_id | string | The strategy to read. |
| holdings_limit | integer | Holdings to return. |
| response_format | string |
{
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"build_id": {
"type": "string",
"format": "uuid",
"description": "A build_id of acubic_create_strategy; resolves to the strategy once saved."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The strategy to read."
},
"holdings_limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "Holdings to return."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Returns the Historical tab of one saved strategy: its saved weights bought and held over 1 month to 5 years, with return, CAGR, volatility, Sharpe and maximum drawdown beside the S&P 500 or a custom benchmark, and the daily series. Hypothetical, with a disclosure. For the walk-forward test use acubic_get_backtest.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| horizon | string | Defaults to 1y, as on acubic.ai. |
| strategy_id* | string | The saved strategy. |
| response_format | string | |
| custom_benchmark | array | Up to 10 instruments with weights. |
{
"type": "object",
"$defs": {
"BenchmarkLeg": {
"type": "object",
"required": [
"symbol",
"weight"
],
"properties": {
"symbol": {
"type": "string",
"pattern": "^[A-Za-z0-9.\\-^=]+$",
"maxLength": 32,
"minLength": 1,
"description": "Ticker from acubic_lookup_instrument."
},
"weight": {
"type": "number",
"maximum": 100,
"description": "Relative weight, normalised to sum to 1.",
"exclusiveMinimum": 0
}
},
"description": "An instrument and its weight.",
"additionalProperties": false
}
},
"required": [
"strategy_id"
],
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"horizon": {
"enum": [
"1m",
"6m",
"1y",
"3y",
"5y"
],
"type": "string",
"description": "Defaults to 1y, as on acubic.ai."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The saved strategy."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
},
"custom_benchmark": {
"type": "array",
"items": {
"$ref": "#/$defs/BenchmarkLeg",
"type": "object"
},
"maxItems": 10,
"minItems": 1,
"description": "Up to 10 instruments with weights."
}
},
"additionalProperties": false
}Returns a signed link, valid 15 minutes, to automate one strategy on acubic.ai with the person's own eToro or Trading 212 account, where they connect the broker and activate it. It also says whether the plan includes live portfolios. Use it whenever the person wants to automate or go live; for a running portfolio use acubic_get_portfolio.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| strategy_id* | string | The strategy to continue on acubic.ai. |
{
"type": "object",
"required": [
"strategy_id"
],
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The strategy to continue on acubic.ai."
}
},
"additionalProperties": false
}Lists the signed-in person's saved strategies, newest first: name, kind (draft, paper or live), holdings count, method, backtest date and link; mode archived shows the archive. It has no performance figures: use acubic_get_strategy for one strategy, acubic_get_backtest for results.
| Argument | Type | Description |
|---|---|---|
| mode | string | Kind of strategy. archived: deleted and still restorable. |
| limit | integer | Page size. |
| cursor | string | A previous next_cursor. |
| locale | string | The language of this conversation. |
| name_contains | string | Case-insensitive part of the name. |
| response_format | string |
{
"type": "object",
"properties": {
"mode": {
"enum": [
"any",
"draft",
"paper",
"live",
"archived"
],
"type": "string",
"default": "any",
"description": "Kind of strategy. archived: deleted and still restorable."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Page size."
},
"cursor": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "A previous next_cursor."
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"name_contains": {
"type": "string",
"maxLength": 100,
"description": "Case-insensitive part of the name."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Lists every choice the strategy builder offers, with ids, trade-offs and defaults: universe, filter metrics, include lists, ranking methods, weighting methods, rebalance, backtest settings and recipes. Optionally one section. It describes options; the choice is the person's. For ready presets use acubic_list_strategy_templates.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| section | string | One section, or all (always concise). |
| experience | string | Keep only the options available at this experience level. |
| response_format | string |
{
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"section": {
"enum": [
"all",
"risk_levels",
"universe",
"filters",
"ranking",
"weighting",
"rebalance",
"backtest_settings",
"recipes",
"countries",
"country_groups",
"industries",
"themes",
"exchanges",
"currencies",
"instrument_types",
"etf_exposures",
"indices"
],
"type": "string",
"default": "all",
"description": "One section, or all (always concise)."
},
"experience": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string",
"description": "Keep only the options available at this experience level."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Lists the ready preset strategies, one per experience level and risk level (largest accepted drawdown), plus Custom (advanced): the full engine. Each preset gives its universe rules, recommended pair and the arguments for acubic_create_strategy. Use it to explore or compare presets before choosing; single settings and their ids are in acubic_list_strategy_options.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| experience | string | Limit to one experience level. |
| risk_level | string | One risk level only (largest accepted drawdown). |
| response_format | string |
{
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"experience": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string",
"description": "Limit to one experience level."
},
"risk_level": {
"enum": [
"low",
"medium",
"high",
"unconstrained"
],
"type": "string",
"description": "One risk level only (largest accepted drawdown)."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Looks up a stock, ETF, crypto asset or currency pair by ticker, ISIN or name: its identity, whether it is in Acubic's tradable universe, whether eToro and Trading 212 list it, and any equivalent product Acubic substitutes (e.g. a UCITS ETF). Identity only: no price, return or rating. To filter many by metrics use acubic_screen_universe.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum matches. |
| query* | string | A ticker (AAPL, BTCUSD), an ISIN (US0378331005) or part of a name. |
| locale | string | The language of this conversation. |
| asset_class | string | Limit to one asset class. |
| response_format | string |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1,
"description": "Maximum matches."
},
"query": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "A ticker (AAPL, BTCUSD), an ISIN (US0378331005) or part of a name."
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"asset_class": {
"enum": [
"equity",
"etf",
"crypto",
"fx"
],
"type": "string",
"description": "Limit to one asset class."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Runs a Monte Carlo of 500 paths over 1, 3, 5 or 10 years for one saved strategy, from its walk-forward backtest (the AI Scenario Simulation of acubic.ai): bear case (5th percentile), median, bull case (95th) and the percentile fan. Hypothetical, with a disclosure. Paid plans only. For past results use acubic_get_backtest.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| horizon | string | How far ahead to simulate. |
| strategy_id* | string | The saved strategy to project. |
| response_format | string |
{
"type": "object",
"required": [
"strategy_id"
],
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"horizon": {
"enum": [
"1y",
"3y",
"5y",
"10y"
],
"type": "string",
"default": "3y",
"description": "How far ahead to simulate."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The saved strategy to project."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Ranks the candidates of a design before anything is saved (Order & Select on acubic.ai): the ranked list, page by page, with score, per-factor values (vs industry: also the peers' median), sector, country and asset class, and the pick the site would make. A fresh ranking uses one portfolio generation. The list is kept 1 hour under candidates_id: paging, previewing a pick or re-ranking it cost nothing more, and acubic_create_strategy saves the pick, once per weighting you want to compare. It saves nothing. To count names that pass filters use acubic_screen_universe.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Rows per page. |
| cursor | string | A previous next_cursor. |
| locale | string | The language of this conversation. |
| include | object | Ids per acubic_list_strategy_options section (index: indices). |
| ranking | object | A preset: card (acubic_list_strategy_templates). The engine: rank_method or rank_blend. With candidates_id: re-rank that pool. |
| regions | array | |
| sectors | array | |
| recipe_id | string | A recipe id (acubic_list_strategy_options, recipes): sets ranking, sectors, allocation and asset count unless given; your filter_rules add to its own. |
Regenerates the suggested portfolio of one saved strategy with its saved settings, like Regenerate on acubic.ai, and returns the holdings and weights; the saved strategy is not changed. It never changes the ranking or the weighting: for another one, build with acubic_create_strategy. It counts against the same ranking and weighting attempt limit as the website.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| strategy_id | string | The saved strategy whose suggested portfolio is regenerated. |
| suggestion_id | string | Read a suggestion still being computed (from a running result). |
| client_request_id | string | Idempotency key. |
{
"type": "object",
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The saved strategy whose suggested portfolio is regenerated."
},
"suggestion_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Read a suggestion still being computed (from a running result)."
},
"client_request_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Idempotency key."
}
},
"additionalProperties": false
}Restores a strategy deleted with acubic_delete_strategy, with its holdings, settings and backtest, within 30 days. acubic_list_strategies with mode archived lists the ones that can be restored.
| Argument | Type | Description |
|---|---|---|
| locale | string | The language of this conversation. |
| strategy_id* | string | A deleted strategy (acubic_list_strategies mode archived). |
{
"type": "object",
"required": [
"strategy_id"
],
"properties": {
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "A deleted strategy (acubic_list_strategies mode archived)."
}
},
"additionalProperties": false
}Runs a walk-forward backtest of one saved strategy and saves it in place of the previous one: at each rebalance the strategy is rebuilt from the data then available, with transaction costs, against the S&P 500 (SPY). 1 to 10 years, monthly, quarterly or annual rebalancing, 0 to 200 bps costs. It uses one backtest from the plan's monthly allowance, returned if the run fails or is cancelled. May return a run_id for acubic_get_backtest_status. One MCP run per person at a time. Results are hypothetical and carry a disclosure. To read a saved backtest use acubic_get_backtest.
| Argument | Type | Description |
|---|---|---|
| years | integer | Length of the test in years. |
| locale | string | The language of this conversation. |
| strategy_id* | string | The saved strategy to backtest. |
| rebalance_freq | string | M monthly, Q quarterly, A annual (needs at least 3 years). |
| response_format | string | |
| client_request_id | string | Idempotency key. |
| transaction_cost_bps | number | Cost of each buy and sell in basis points. |
Applies filter rules (e.g. market cap at least $10 billion, P/E at most 25; AND, up to 20) to the universe eToro and Trading 212 both hold, after optional asset class, region, sector and include narrowing. Returns how many pass, per asset class, with up to 25 example rows, from the latest snapshot (as_of). A stock-only metric passes funds and crypto. To rank names for a strategy use acubic_rank_candidates.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size. |
| order | string | Sort direction. |
| cursor | string | A previous next_cursor. |
| locale | string | The language of this conversation. |
| include | object | Ids per acubic_list_strategy_options section (index: indices). |
| regions | array | Narrow to these regions first. |
| sectors | array | Narrow to these sectors first. |
| order_by | string | Order the example rows by this metric. |
| filter_rules |
Searches what Acubic publishes (blog, guides, methodology, FAQ, pricing) and returns passages with links to cite. Use it for how Acubic builds and backtests strategies, plan limits and the broker connections. It does not look up individual stocks (use acubic_lookup_instrument); for one term use acubic_explain.
| Argument | Type | Description |
|---|---|---|
| kinds | array | Limit to some kinds of content. |
| limit | integer | Page size. |
| query* | string | What to look for, in plain words. |
| cursor | string | A previous next_cursor. |
| locale | string | The language of this conversation. |
| response_format | string |
{
"type": "object",
"required": [
"query"
],
"properties": {
"kinds": {
"type": "array",
"items": {
"enum": [
"article",
"guide",
"methodology",
"faq",
"pricing"
],
"type": "string"
},
"description": "Limit to some kinds of content.",
"uniqueItems": true
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1,
"description": "Page size."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "What to look for, in plain words."
},
"cursor": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "A previous next_cursor."
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}Updates the name, description, filter rules, include lists or Exclude list of one saved strategy, and lists each previous value. Holdings are not recomputed. It cannot change the ranking, weighting, limits or sizes: for that build a new strategy with acubic_create_strategy. A strategy with a broker connection accepts name and description only.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| locale | string | The language of this conversation. |
| include | object | Ids per acubic_list_strategy_options section (index: indices). |
| description | any | null clears it. |
| strategy_id* | string | The strategy to change. |
| filter_rules | array | |
| response_format | string | |
| excluded_symbols | array | The whole Exclude list (replaces the saved one; [] clears it; up to 200 tickers, none locked). Never bought; a held one is sold at the next rebalance. |
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
| asset_count | integer | Number of assets. |
| description | string |
| template_id | string | An id from acubic_list_strategy_templates: a preset, or advanced for the engine. |
| filter_rules | array | Each rule: metric, op, value in the metric's unit (US dollars for market_cap, percent for pct metrics: 40 = 40%). |
| select_count | integer | Top N to select (10, 15, 20, 30 or 50 within the count range; see selection.select_counts). Not with selected_symbols. |
| asset_classes | array |
| candidates_id | string | A ranked list from acubic_rank_candidates (valid 1 hour). |
| custom_symbols | array | Tickers to add to the pool, checked as on acubic.ai. |
| locked_symbols | array | Always held, exempt from every filter. |
| position_sizing | object | Default: the sizes recommended for the number of assets. |
| response_format | string |
| excluded_symbols | array | Names removed from the screened pool (Step 1). |
| selected_symbols | array | Hand-picked names of the candidates_id list (not with allocation or correlation limits). |
| selection_limits | object | Min/max share of the selection per sector, country or asset class. |
| asset_count_range | object | Instead of asset_count (default 15 to 25). |
| client_request_id | string | Idempotency key. |
| correlation_limit | number | Not offered yet: omit it unless acubic_list_strategy_options shows it offered; then 0.50-0.95, step 0.05 (preset: 0.80). |
| class_position_sizing | object | Per-asset-class sizes overriding position_sizing. |
{
"type": "object",
"$defs": {
"McpSizing": {
"type": "object",
"required": [
"min_weight_pct",
"max_weight_pct"
],
"properties": {
"max_weight_pct": {
"type": "number",
"maximum": 100,
"minimum": 1,
"description": "1 to 100, step 1; at most 60 unless the lowest asset count is 1 (then 100)."
},
"min_weight_pct": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "0 to 20, step 0.5 (2.5 is 2.5%)."
}
},
"description": "Weight per asset, percent.",
"additionalProperties": false
},
"FilterRule": {
"type": "object",
"required": [
"metric",
"op",
"value"
],
"properties": {
"op": {
"enum": [
">=",
"<=",
">",
"<"
],
"type": "string"
},
"value": {
"type": "number",
"description": "The metric's unit: US dollars for market_cap, percent for pct metrics (40 = 40%)."
},
"metric": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "A filter metric id (acubic_list_strategy_options, section filters)."
}
},
"description": "One rule: metric op value.",
"additionalProperties": false
},
"McpRanking": {
"type": "object",
"examples": [
{
"card": "momentum"
},
{
"rank_method": "momentum_1y"
}
],
"properties": {
"card": {
"enum": [
"market_cap",
"momentum",
"sortino_momentum",
"market_cap_sortino",
"market_cap_sharpe",
"momentum_market_cap"
],
"type": "string",
"description": "A preset's ranking card, from its menu in acubic_list_strategy_templates (by template_id, or experience and risk_level)."
},
"rank_blend": {
"type": "array",
"items": {
"$ref": "#/$defs/McpBlendEntry",
"type": "object"
},
"maxItems": 20,
"description": "Up to 20 weighted factors."
},
"rank_method": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "A ranking method id."
}
},
"description": "A preset: card. The engine: rank_method or rank_blend.",
"additionalProperties": false
},
"McpBlendEntry": {
"type": "object",
"required": [
"factor",
"weight"
],
"properties": {
"factor": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "A ranking factor id (acubic_list_strategy_options)."
},
"weight": {
"type": "number",
"description": "Relative; normalised to sum to 1.",
"exclusiveMinimum": 0
},
"window_days": {
"enum": [
7,
30,
90,
180,
365,
730,
1095
],
"type": "integer",
"description": "Look-back in days (per factor)."
}
},
"description": "One factor of a blend.",
"additionalProperties": false
},
"McpCountRange": {
"type": "object",
"examples": [
{
"max": 25,
"min": 15
}
],
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "1 to 50."
},
"min": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "1 to 50."
}
},
"description": "Number of assets, min and max.",
"additionalProperties": false
},
"McpDefaultMax": {
"type": "object",
"properties": {
"sectors": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"countries": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"McpGroupBound": {
"type": "object",
"properties": {
"max_pct": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"min_pct": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"description": "Share of the selection by count, percent.",
"additionalProperties": false
},
"McpSelectionLimits": {
"type": "object",
"properties": {
"sectors": {
"type": "object",
"description": "e.g. Technology",
"maxProperties": 40,
"additionalProperties": {
"$ref": "#/$defs/McpGroupBound",
"type": "object"
}
},
"countries": {
"type": "object",
"description": "e.g. United States",
"maxProperties": 80,
"additionalProperties": {
"$ref": "#/$defs/McpGroupBound",
"type": "object"
}
},
"asset_classes": {
"type": "object",
"propertyNames": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
]
},
"additionalProperties": {
"$ref": "#/$defs/McpGroupBound",
"type": "object"
}
},
"default_max_pct": {
"$ref": "#/$defs/McpDefaultMax",
"type": "object",
"description": "Default max percent for every sector or country without its own cap."
}
},
"description": "Group names as acubic_rank_candidates rows show them.",
"additionalProperties": false
}
},
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"include": {
"type": "object",
"properties": {
"index": {
"type": "array"
},
"crypto": {
"type": "array"
},
"themes": {
"type": "array"
},
"countries": {
"type": "array"
},
"exchanges": {
"type": "array"
},
"currencies": {
"type": "array"
},
"industries": {
"type": "array"
},
"symbols_only": {
"type": "array"
},
"etf_exposures": {
"type": "array"
},
"country_groups": {
"type": "array"
},
"instrument_types": {
"type": "array"
},
"exclude_leveraged": {
"type": "boolean"
}
},
"description": "Ids per acubic_list_strategy_options section (index: indices).",
"additionalProperties": false
},
"ranking": {
"$ref": "#/$defs/McpRanking",
"type": "object",
"description": "A preset: card (its menu: acubic_list_strategy_templates). The engine: rank_method or rank_blend."
},
"regions": {
"type": "array",
"items": {
"enum": [
"north_america",
"latin_america",
"europe",
"asia_pacific",
"middle_east_africa"
],
"type": "string"
},
"uniqueItems": true
},
"sectors": {
"type": "array",
"items": {
"enum": [
"technology",
"healthcare",
"financials",
"energy",
"consumer_discretionary",
"consumer_staples",
"industrials",
"materials",
"utilities",
"real_estate",
"communication_services"
],
"type": "string"
},
"uniqueItems": true
},
"recipe_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"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."
},
"allocation": {
"enum": [
"hrp",
"mvo",
"cvar",
"equal",
"rank",
"rank_equal",
"cap_10",
"cap_20",
"cap_rank_10",
"cap_rank_20",
"cap_score_tilt",
"erc"
],
"type": "string",
"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."
},
"experience": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string",
"description": "Legacy: beginner or intermediate with risk_level selects a preset; prefer template_id. Omit for an engine build."
},
"index_card": {
"type": "boolean",
"description": "Build the level's index card (template level_mix.index_card) instead of ranked stocks; no ranking or allocation."
},
"risk_level": {
"enum": [
"low",
"medium",
"high",
"unconstrained"
],
"type": "string",
"description": "Preset only (legacy path): largest acceptable drawdown; prefer template_id."
},
"asset_count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Number of assets."
},
"description": {
"type": "string",
"maxLength": 1000
},
"template_id": {
"type": "string",
"maxLength": 40,
"description": "An id from acubic_list_strategy_templates: a preset, or advanced for the engine."
},
"filter_rules": {
"type": "array",
"items": {
"$ref": "#/$defs/FilterRule",
"type": "object"
},
"maxItems": 20,
"description": "Each rule: metric, op, value in the metric's unit (US dollars for market_cap, percent for pct metrics: 40 = 40%)."
},
"select_count": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Top N to select (10, 15, 20, 30 or 50 within the count range; see selection.select_counts). Not with selected_symbols."
},
"asset_classes": {
"type": "array",
"items": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
],
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"candidates_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "A ranked list from acubic_rank_candidates (valid 1 hour)."
},
"custom_symbols": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"maxItems": 20,
"description": "Tickers to add to the pool, checked as on acubic.ai.",
"uniqueItems": true
},
"locked_symbols": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"maxItems": 20,
"description": "Always held, exempt from every filter."
},
"position_sizing": {
"$ref": "#/$defs/McpSizing",
"type": "object",
"description": "Default: the sizes recommended for the number of assets."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
},
"excluded_symbols": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"maxItems": 50,
"description": "Names removed from the screened pool (Step 1)."
},
"selected_symbols": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"maxItems": 100,
"minItems": 1,
"description": "Hand-picked names of the candidates_id list (not with allocation or correlation limits).",
"uniqueItems": true
},
"selection_limits": {
"$ref": "#/$defs/McpSelectionLimits",
"type": "object",
"description": "Min/max share of the selection per sector, country or asset class."
},
"asset_count_range": {
"$ref": "#/$defs/McpCountRange",
"type": "object",
"description": "Instead of asset_count (default 15 to 25)."
},
"client_request_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Idempotency key."
},
"correlation_limit": {
"type": "number",
"maximum": 0.95,
"minimum": 0.5,
"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)."
},
"class_position_sizing": {
"type": "object",
"description": "Per-asset-class sizes overriding position_sizing.",
"propertyNames": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
]
},
"additionalProperties": {
"$ref": "#/$defs/McpSizing",
"type": "object"
}
}
},
"additionalProperties": false
}| experience | string | Legacy: beginner or intermediate with risk_level selects a preset; prefer template_id. Omit for an engine build. |
| risk_level | string | Preset only (legacy path): largest acceptable drawdown; prefer template_id. |
| asset_count | integer | Number of assets. |
| template_id | string | An id from acubic_list_strategy_templates: a preset, or advanced for the engine. |
| filter_rules | array | Each rule: metric, op, value in the metric's own unit. |
| select_count | integer | Top N to select (10, 15, 20, 30 or 50 within the count range; see selection.select_counts). Not with selected_symbols. |
| asset_classes | array |
| candidates_id | string | A ranked list from acubic_rank_candidates (valid 1 hour). |
| custom_symbols | array | Tickers to add to the pool, checked as on acubic.ai. |
| locked_symbols | array | Always selected, exempt from every filter. |
| position_sizing | object | Default: the sizes recommended for the number of assets. |
| response_format | string |
| excluded_symbols | array | Names removed from the screened pool (Step 1). |
| selected_symbols | array | Preview a hand-picked selection of candidates_id (not with allocation or correlation limits). |
| selection_limits | object | Min/max share of the selection per sector, country or asset class. |
| asset_count_range | object | Instead of asset_count (default 15 to 25). |
| client_request_id | string | Idempotency key. |
| correlation_limit | number | Not offered yet: omit it unless acubic_list_strategy_options shows it offered; then 0.50-0.95, step 0.05 (preset: 0.80). |
| class_position_sizing | object | Per-asset-class sizes overriding position_sizing. |
{
"type": "object",
"$defs": {
"McpSizing": {
"type": "object",
"required": [
"min_weight_pct",
"max_weight_pct"
],
"properties": {
"max_weight_pct": {
"type": "number",
"maximum": 100,
"minimum": 1,
"description": "1 to 100, step 1; at most 60 unless the lowest asset count is 1 (then 100)."
},
"min_weight_pct": {
"type": "number",
"maximum": 20,
"minimum": 0,
"description": "0 to 20, step 0.5 (2.5 is 2.5%)."
}
},
"description": "Weight per asset, percent.",
"additionalProperties": false
},
"FilterRule": {
"type": "object",
"required": [
"metric",
"op",
"value"
],
"properties": {
"op": {
"enum": [
">=",
"<=",
">",
"<"
],
"type": "string"
},
"value": {
"type": "number",
"description": "The metric's unit: US dollars for market_cap, percent for pct metrics (40 = 40%)."
},
"metric": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "A filter metric id (acubic_list_strategy_options, section filters)."
}
},
"description": "One rule: metric op value.",
"additionalProperties": false
},
"McpRanking": {
"type": "object",
"examples": [
{
"card": "momentum"
},
{
"rank_method": "momentum_1y"
}
],
"properties": {
"card": {
"enum": [
"market_cap",
"momentum",
"sortino_momentum",
"market_cap_sortino",
"market_cap_sharpe",
"momentum_market_cap"
],
"type": "string",
"description": "A preset's ranking card, from its menu in acubic_list_strategy_templates (by template_id, or experience and risk_level)."
},
"rank_blend": {
"type": "array",
"items": {
"$ref": "#/$defs/McpBlendEntry",
"type": "object"
},
"maxItems": 20,
"description": "Up to 20 weighted factors."
},
"rank_method": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "A ranking method id."
}
},
"description": "A preset: card. The engine: rank_method or rank_blend.",
"additionalProperties": false
},
"McpBlendEntry": {
"type": "object",
"required": [
"factor",
"weight"
],
"properties": {
"factor": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "A ranking factor id (acubic_list_strategy_options)."
},
"weight": {
"type": "number",
"description": "Relative; normalised to sum to 1.",
"exclusiveMinimum": 0
},
"window_days": {
"enum": [
7,
30,
90,
180,
365,
730,
1095
],
"type": "integer",
"description": "Look-back in days (per factor)."
}
},
"description": "One factor of a blend.",
"additionalProperties": false
},
"McpCountRange": {
"type": "object",
"examples": [
{
"max": 25,
"min": 15
}
],
"required": [
"min",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "1 to 50."
},
"min": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "1 to 50."
}
},
"description": "Number of assets, min and max.",
"additionalProperties": false
},
"McpDefaultMax": {
"type": "object",
"properties": {
"sectors": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"countries": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"McpGroupBound": {
"type": "object",
"properties": {
"max_pct": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"min_pct": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"description": "Share of the selection by count, percent.",
"additionalProperties": false
},
"McpSelectionLimits": {
"type": "object",
"properties": {
"sectors": {
"type": "object",
"description": "e.g. Technology",
"maxProperties": 40,
"additionalProperties": {
"$ref": "#/$defs/McpGroupBound",
"type": "object"
}
},
"countries": {
"type": "object",
"description": "e.g. United States",
"maxProperties": 80,
"additionalProperties": {
"$ref": "#/$defs/McpGroupBound",
"type": "object"
}
},
"asset_classes": {
"type": "object",
"propertyNames": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
]
},
"additionalProperties": {
"$ref": "#/$defs/McpGroupBound",
"type": "object"
}
},
"default_max_pct": {
"$ref": "#/$defs/McpDefaultMax",
"type": "object",
"description": "Default max percent for every sector or country without its own cap."
}
},
"description": "Group names as acubic_rank_candidates rows show them.",
"additionalProperties": false
}
},
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "Rows per page."
},
"cursor": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "A previous next_cursor."
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"include": {
"type": "object",
"properties": {
"index": {
"type": "array"
},
"crypto": {
"type": "array"
},
"themes": {
"type": "array"
},
"countries": {
"type": "array"
},
"exchanges": {
"type": "array"
},
"currencies": {
"type": "array"
},
"industries": {
"type": "array"
},
"symbols_only": {
"type": "array"
},
"etf_exposures": {
"type": "array"
},
"country_groups": {
"type": "array"
},
"instrument_types": {
"type": "array"
},
"exclude_leveraged": {
"type": "boolean"
}
},
"description": "Ids per acubic_list_strategy_options section (index: indices).",
"additionalProperties": false
},
"ranking": {
"$ref": "#/$defs/McpRanking",
"type": "object",
"description": "A preset: card (acubic_list_strategy_templates). The engine: rank_method or rank_blend. With candidates_id: re-rank that pool."
},
"regions": {
"type": "array",
"items": {
"enum": [
"north_america",
"latin_america",
"europe",
"asia_pacific",
"middle_east_africa"
],
"type": "string"
},
"uniqueItems": true
},
"sectors": {
"type": "array",
"items": {
"enum": [
"technology",
"healthcare",
"financials",
"energy",
"consumer_discretionary",
"consumer_staples",
"industrials",
"materials",
"utilities",
"real_estate",
"communication_services"
],
"type": "string"
},
"uniqueItems": true
},
"recipe_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"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."
},
"experience": {
"enum": [
"beginner",
"intermediate",
"advanced"
],
"type": "string",
"description": "Legacy: beginner or intermediate with risk_level selects a preset; prefer template_id. Omit for an engine build."
},
"risk_level": {
"enum": [
"low",
"medium",
"high",
"unconstrained"
],
"type": "string",
"description": "Preset only (legacy path): largest acceptable drawdown; prefer template_id."
},
"asset_count": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Number of assets."
},
"template_id": {
"type": "string",
"maxLength": 40,
"description": "An id from acubic_list_strategy_templates: a preset, or advanced for the engine."
},
"filter_rules": {
"type": "array",
"items": {
"$ref": "#/$defs/FilterRule",
"type": "object"
},
"maxItems": 20,
"description": "Each rule: metric, op, value in the metric's own unit."
},
"select_count": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Top N to select (10, 15, 20, 30 or 50 within the count range; see selection.select_counts). Not with selected_symbols."
},
"asset_classes": {
"type": "array",
"items": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
],
"type": "string"
},
"minItems": 1,
"uniqueItems": true
},
"candidates_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "A ranked list from acubic_rank_candidates (valid 1 hour)."
},
"custom_symbols": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"maxItems": 20,
"description": "Tickers to add to the pool, checked as on acubic.ai.",
"uniqueItems": true
},
"locked_symbols": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"maxItems": 20,
"description": "Always selected, exempt from every filter."
},
"position_sizing": {
"$ref": "#/$defs/McpSizing",
"type": "object",
"description": "Default: the sizes recommended for the number of assets."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
},
"excluded_symbols": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"maxItems": 50,
"description": "Names removed from the screened pool (Step 1)."
},
"selected_symbols": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32
},
"maxItems": 100,
"minItems": 1,
"description": "Preview a hand-picked selection of candidates_id (not with allocation or correlation limits).",
"uniqueItems": true
},
"selection_limits": {
"$ref": "#/$defs/McpSelectionLimits",
"type": "object",
"description": "Min/max share of the selection per sector, country or asset class."
},
"asset_count_range": {
"$ref": "#/$defs/McpCountRange",
"type": "object",
"description": "Instead of asset_count (default 15 to 25)."
},
"client_request_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Idempotency key."
},
"correlation_limit": {
"type": "number",
"maximum": 0.95,
"minimum": 0.5,
"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)."
},
"class_position_sizing": {
"type": "object",
"description": "Per-asset-class sizes overriding position_sizing.",
"propertyNames": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
]
},
"additionalProperties": {
"$ref": "#/$defs/McpSizing",
"type": "object"
}
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"strategy_id"
],
"properties": {
"years": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1,
"description": "Length of the test in years."
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The saved strategy to backtest."
},
"rebalance_freq": {
"enum": [
"M",
"Q",
"A"
],
"type": "string",
"default": "M",
"description": "M monthly, Q quarterly, A annual (needs at least 3 years)."
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
},
"client_request_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Idempotency key."
},
"transaction_cost_bps": {
"type": "number",
"default": 15,
"maximum": 200,
"minimum": 0,
"description": "Cost of each buy and sell in basis points."
}
},
"additionalProperties": false
}| array |
| Rules combined with AND. |
| asset_classes | array | Narrow to these asset classes first. |
| response_format | string |
{
"type": "object",
"$defs": {
"FilterRule": {
"type": "object",
"required": [
"metric",
"op",
"value"
],
"properties": {
"op": {
"enum": [
">=",
"<=",
">",
"<"
],
"type": "string"
},
"value": {
"type": "number",
"description": "The metric's unit: US dollars for market_cap, percent for pct metrics (40 = 40%)."
},
"metric": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "A filter metric id (acubic_list_strategy_options, section filters)."
}
},
"description": "One rule: metric op value.",
"additionalProperties": false
}
},
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Page size."
},
"order": {
"enum": [
"desc",
"asc"
],
"type": "string",
"default": "desc",
"description": "Sort direction."
},
"cursor": {
"type": "string",
"maxLength": 512,
"minLength": 1,
"description": "A previous next_cursor."
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"include": {
"type": "object",
"properties": {
"index": {
"type": "array"
},
"crypto": {
"type": "array"
},
"themes": {
"type": "array"
},
"countries": {
"type": "array"
},
"exchanges": {
"type": "array"
},
"currencies": {
"type": "array"
},
"industries": {
"type": "array"
},
"symbols_only": {
"type": "array"
},
"etf_exposures": {
"type": "array"
},
"country_groups": {
"type": "array"
},
"instrument_types": {
"type": "array"
},
"exclude_leveraged": {
"type": "boolean"
}
},
"description": "Ids per acubic_list_strategy_options section (index: indices).",
"additionalProperties": false
},
"regions": {
"type": "array",
"items": {
"enum": [
"north_america",
"latin_america",
"europe",
"asia_pacific",
"middle_east_africa"
],
"type": "string"
},
"description": "Narrow to these regions first.",
"uniqueItems": true
},
"sectors": {
"type": "array",
"items": {
"enum": [
"technology",
"healthcare",
"financials",
"energy",
"consumer_discretionary",
"consumer_staples",
"industrials",
"materials",
"utilities",
"real_estate",
"communication_services"
],
"type": "string"
},
"description": "Narrow to these sectors first.",
"uniqueItems": true
},
"order_by": {
"type": "string",
"default": "market_cap",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "Order the example rows by this metric."
},
"filter_rules": {
"type": "array",
"items": {
"$ref": "#/$defs/FilterRule",
"type": "object"
},
"default": [],
"maxItems": 20,
"description": "Rules combined with AND."
},
"asset_classes": {
"type": "array",
"items": {
"enum": [
"equities",
"etfs",
"commodities",
"bonds",
"crypto"
],
"type": "string"
},
"description": "Narrow to these asset classes first.",
"uniqueItems": true
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
}
},
"additionalProperties": false
}{
"type": "object",
"$defs": {
"FilterRule": {
"type": "object",
"required": [
"metric",
"op",
"value"
],
"properties": {
"op": {
"enum": [
">=",
"<=",
">",
"<"
],
"type": "string"
},
"value": {
"type": "number",
"description": "The metric's unit: US dollars for market_cap, percent for pct metrics (40 = 40%)."
},
"metric": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,40}$",
"description": "A filter metric id (acubic_list_strategy_options, section filters)."
}
},
"description": "One rule: metric op value.",
"additionalProperties": false
}
},
"required": [
"strategy_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"locale": {
"enum": [
"en",
"de",
"it",
"fr",
"es",
"pt-PT"
],
"type": "string",
"description": "The language of this conversation."
},
"include": {
"type": "object",
"properties": {
"index": {
"type": "array"
},
"crypto": {
"type": "array"
},
"themes": {
"type": "array"
},
"countries": {
"type": "array"
},
"exchanges": {
"type": "array"
},
"currencies": {
"type": "array"
},
"industries": {
"type": "array"
},
"symbols_only": {
"type": "array"
},
"etf_exposures": {
"type": "array"
},
"country_groups": {
"type": "array"
},
"instrument_types": {
"type": "array"
},
"exclude_leveraged": {
"type": "boolean"
}
},
"description": "Ids per acubic_list_strategy_options section (index: indices).",
"additionalProperties": false
},
"description": {
"anyOf": [
{
"type": "string",
"maxLength": 1000
},
{
"type": "null"
}
],
"description": "null clears it."
},
"strategy_id": {
"type": "string",
"format": "uuid",
"description": "The strategy to change."
},
"filter_rules": {
"type": "array",
"items": {
"$ref": "#/$defs/FilterRule",
"type": "object"
},
"maxItems": 20,
"minItems": 1
},
"response_format": {
"enum": [
"concise",
"detailed"
],
"type": "string",
"default": "concise"
},
"excluded_symbols": {
"type": "array",
"items": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"maxItems": 1000,
"description": "The whole Exclude list (replaces the saved one; [] clears it; up to 200 tickers, none locked). Never bought; a held one is sold at the next rebalance."
}
},
"additionalProperties": false
}