Tools reference

The MCP server has 7 tools. Every tool returns its result as one JSON text. When a tool fails, the result is marked as an error and holds an error code or a list of messages. No tool returns source code or compiled files.

The input tables below are generated from the server’s own definitions in worker/api/mcp.ts. A check in the build fails if this page drifts from them.

list_node_vocabulary

Lists the block types the Strategy Builder supports: indicators, conditions, orders, filters, exits and others. Each entry has the type name, category, label, description, input and output port counts, the settings (key, label, type, options, minimum, maximum and default), and whether the block can be used only once in a flow. Labels are in English.

The result also holds the list of categories, the count of blocks, the flow shape the other tools expect, and a note on ports: connect output_N of one block to input_N of the next, Start has no input, and every block must be reachable from Start.

list_templates

Lists the ready-made strategies of the Strategy Builder. Each entry has an id, a name, a description, and portfolio, which is true when the template holds several flows. Pro-only recipes are not listed and cannot be fetched through MCP. Names and descriptions are in English, the same as on the Builder screen in English.

This tool takes no input.

get_template

Returns one template as a flow, in the exact shape that validate_flow and create_builder_link accept. Use it as a model or a starting point. The result has id, name, description and flow (with name, settings and flows).

Errors: not_found when the ID is unknown, and rate_limited when the template limit is exceeded. This tool has its own limit of 10 calls per 60 seconds per IP address.

validate_flow

Checks a flow with the same engine the Strategy Builder uses. The result has valid (true when there are no errors), errors (must fix) and warnings (review). Each item has code, type, severity, nodeId, name, message and flow (the index of the flow it belongs to).

Error codes, as they appear in code:

If the flow is not in a readable shape at all (for example an unknown block type), the result is an error with valid: false and input_errors, a list of messages. A flow may hold at most 8 flows with at most 60 blocks each, and at most 256 KB in total.

create_builder_link

Validates the flow. If it has no errors, the tool saves it and returns a Strategy Builder link that opens it on the canvas. The result has saved: true, url, warnings and next_steps.

If the flow has errors, nothing is saved. The result is an error with errors (same list as validate_flow) or input_errors. When the daily limit is reached, the error is daily_limit. Links last 90 days. See Limits and safety.

open_strategy_miner

Returns a link that opens the Strategy Miner with settings already filled in. It does not run the generator and does not export anything. You press Generate in the browser. The full generator is part of Pro. Without Pro, the link opens the demo.

The result has:

• url: the link.
• applied: the settings that went into the link.
• dropped: settings that were left out, each with the field, the value and the reason. A value outside its range, a wrong type, an unknown part name and a contradictory pair (for example period_min above period_max) are dropped. They are not rounded or repaired.
• notices: remarks about the choices that were kept, for example that an add-on symbol needs a one-time price-data download.
• next_steps: what to tell the user.

Rules for the settings:

• All fields are optional. A link with no field opens the Miner with its defaults.
• Realistic cost settings (spread_pips to friday_close_hour) apply for that visit only. They are shown on screen, never overwrite your saved account settings, and take effect only with Pro. The demo ignores them.
• Advanced settings (parts_only to filters) are filled into the Advanced section for that visit only and never overwrite your saved advanced settings. Ranges that need two ends (conds_min and conds_max, sl_min_pips and sl_max_pips, tp_min_pips and tp_max_pips) are dropped if only one end is given.
• The ranges of some fields differ by symbol. Gold (XAUUSD) allows a wider spread. Gold, US Tech 100, US30, DE40, JP225 and the two oil symbols also allow wider stop-loss and take-profit ranges. A value outside the range for the symbol is dropped, and the reason names that range.
• trials in the link accepts 1000, 2000, 5000, 10000 or 20000, the same values as the Trial limit list on the Miner screen.
• target only records the intended export format. You choose the target again in the Builder after you open a candidate.

get_miner_results

Reads a result summary that a Pro user handed over with the Hand to AI button on the Strategy Miner results screen. You copy the result ID from that screen and give it to your AI. The button is Pro only. The demo has no Hand to AI button, so without Pro there is no ID to give.

The result holds the settings used, the realistic-cost settings if they were on, the totals, a table of how many candidates each check removed and why, the robustness tests, and the metrics of each candidate: search period, later period, other symbols, robustness, drawdown, and bars where the stop and the target were both reached. It holds no strategy design, no conditions and no code.

Errors: not_found when the ID is unknown, expired or deleted, and rate_limited when the limit of 20 calls per 60 seconds per IP address is exceeded. An ID expires 30 days after it is created, and you can delete it earlier on the results screen.