Troubleshooting
The problems people meet most often with the Acubic MCP server, and how to fix each one.
Updated Reviewed by Acubic Research
Connection and sign-in
Why do no Acubic tools appear?
Check the server URL first. It must be exactly https://mcp.acubic.ai/mcp, with the /mcp path and no slash at the end. Then make sure the connector is switched on for the chat you are in, and start a new chat after adding it.
Why does sign-in keep starting again?
Approve the sign-in in the same browser where it started, within 10 minutes. Each consent link works once, so an old or reused link is refused. If it still loops, remove the connector, add it again and sign in once more.
What does a 401 error mean?
The request had no valid sign-in. Either the assistant has not signed in yet or its access token has expired or been revoked. Most clients renew the token by themselves; if yours does not, sign in again from its MCP or connector settings.
What does a 403 or insufficient scope error mean?
You signed in but did not grant the permission this action needs, for example running backtests. Reconnect and keep that scope ticked on the consent screen. Sign-in and scopes lists what each scope allows.
Why does the consent page say the app is unverified?
Acubic has not verified that client. That is normal for many custom setups. Continue only if you started the connection yourself and recognise the address shown on the page.
Building and backtesting
Why was my argument refused?
The answer names the argument and the reason. Ids for rankings, factors, weightings and filter metrics must come from the strategy options list; ask the assistant to list them and try again. A setting the builder does not offer is refused as an unsupported option.
What does it mean when too few instruments pass my filters?
Your filter rules are stricter than the universe allows, so there is nothing to build from. Nothing was charged. Loosen a rule, such as a valuation limit, or widen the region or sector.
Why is my backtest taking a long time?
A walk-forward backtest over many years does real work. After about a minute the assistant receives a run id and checks progress, no more often than Acubic suggests. Only one MCP backtest per person runs at a time; a second one waits for the first.
What happens when my allowance is used up?
The call starts nothing and is not charged. The answer names the limit and when it resets. Ask the assistant "What plan am I on?" to see your usage, or compare plans on the pricing page.
Why can I not change this strategy from the chat?
The strategy is live, so it can only be changed on acubic.ai. This keeps a live portfolio from being edited by an assistant. You can still read it and its history from the chat.
What should I do when the servers are busy?
Wait the time the message suggests and try again. A busy answer means nothing was started and nothing was charged.
Error codes
Tool errors carry one of these codes and a plain-English message. Codes marked retryable can be tried again after a short wait.
| Code | Meaning | Retryable |
|---|---|---|
invalid_argument | An argument is not valid; the message names it. | No |
not_found | The item does not exist or is not yours. | No |
account_unavailable | This account is not available; contact Acubic support. | No |
insufficient_scope | The connection lacks the permission this action needs. | No |
upgrade_required | This needs a higher plan. | No |
quota_exhausted | The allowance for this action is used up for now. | No |
rate_limited | Too many requests; try again shortly. | Yes |
run_in_progress | A run is already in progress. | Yes |
service_busy | The servers are busy; nothing was charged. | Yes |
data_unavailable | Market data could not answer right now. | Yes |
not_tradable_at_brokers | The instrument is not available at the supported brokers. | No |
unsupported_option | That option is not offered. | No |
filters_too_narrow | Too few instruments pass these filters; nothing was charged. | No |
strategy_is_live | A live strategy cannot be changed from the chat. | No |
confirmation_required | The action needs your explicit confirmation. | No |
run_failed | The run did not finish; nothing was charged. | No |
internal_error | Something went wrong on Acubic's side. | No |
Still stuck? Write to [email protected] with the time, your client and the error message. If the message includes a trace id, send it too.
Backtest results are hypothetical, from a historical simulation; past performance does not guarantee future results. Acubic provides software and information for educational purposes; it is not investment advice. Backtests follow the published methodology.