Kova

Read strategy questions and history, newest first, 25 per page. Pass next_cursor as before.

kova_list_strategy_advisories

List the version history for a strategy. Each entry captures the content before it was overwritten. Returns version numbers, names, previews, and timestamps. Use this before editing a strategy to understand what has changed over time.

kova_list_strategy_versions

Record a deposit or withdrawal on a strategy's portfolio. Cash flows adjust performance calculations — deposits don't count as gains, withdrawals don't count as losses. Use this to track contributions, distributions, or transfers that affect the portfolio's value but aren't investment returns.

kova_record_cash_flow

Remove a non-ticker asset from a strategy. The asset UUID is returned by kova_create_asset or by kova_show_portfolio for existing manual assets.

kova_remove_asset

Remove a cash flow record from a strategy's portfolio. Use kova_list_cash_flows to find the cash_flow_id.

kova_remove_cash_flow

Remove a liability from a strategy. The liability UUID is returned by kova_create_liability or by kova_show_portfolio for existing liabilities.

kova_remove_liability

Save a user-provided explanation or question action. Relay the user's words; never invent motives or answers. Read the revision first. Supply a unique request_id and reuse it only for an exact retry. Replies and corrections require text and queue interpretation. Strategy content and briefs are unchanged.

kova_respond_to_strategy_advisory

Restore a strategy to a previous version. The current content is automatically saved as a new version before the restore, so nothing is permanently lost.

kova_restore_strategy_version

Update an existing strategy's name, content, or both. Provide at least one of name or content.

kova_save_strategy

Read a brief by ID. Returns status ('processing' or 'completed') and, when completed, the alignment score, label, markdown analysis, summary, and timestamps. Use 'latest' as brief_id to get the most recent brief. When status is 'processing', the response includes elapsed_seconds, expected_duration_seconds (~90s), retry_after_seconds, and a human-readable message — briefs typically complete in 60–120 seconds, so wait retry_after_seconds before calling again.

kova_show_brief

Read the current portfolio on file for a strategy — the most recent holdings (stocks, options, cash, assets, and liabilities) with performance metrics. Persisted manual assets and liabilities include uuid values so agents can update or remove existing records without creating duplicates.

kova_show_portfolio

Read a simulation result by ID. Returns status ('processing' or 'completed') and, when completed, the alignment score, analysis, and summary. Simulations expire after 1 hour. When status is 'processing', the response includes elapsed_seconds, expected_duration_seconds (~120s), retry_after_seconds, and a human-readable message — simulations typically complete in 80–160 seconds, so wait retry_after_seconds before calling again.

kova_show_simulation

Read a strategy's full content and metadata including alignment score and performance metrics.

kova_show_strategy

Read a question, its dated evidence, and up to 50 saved responses. Pass next_response_cursor as response_cursor for older responses.

kova_show_strategy_advisory

Privately inspect Strategy Intelligence assessment data. Restricted to the allowed account and its own strategies. Read-only; never starts checks. Exact call content expires after one year; missing history is explicitly unavailable.

kova_show_strategy_assessment

Privately inspect Strategy Intelligence call data. Restricted to the allowed account and its own strategies. Read-only; never starts checks. Exact call content expires after one year; missing history is explicitly unavailable.

kova_show_strategy_assessment_call

Read strategy understanding, processing state, and the primary question. Read-only; never starts work.

kova_show_strategy_intelligence

Privately inspect Strategy Intelligence show data. Restricted to the allowed account and its own strategies. Read-only; never starts checks. Exact call content expires after one year; missing history is explicitly unavailable.

kova_show_strategy_intelligence_explorer

Privately inspect Strategy Intelligence memory data. Restricted to the allowed account and its own strategies. Read-only; never starts checks. Exact call content expires after one year; missing history is explicitly unavailable.

kova_show_strategy_intelligence_memory

Read the full content of a specific strategy version snapshot.

kova_show_strategy_version

Run an ephemeral what-if simulation — evaluates a portfolio against a strategy without saving any records. Use this to check a specific trade idea ('should I sell puts on MARA at 15?'), test a hypothetical portfolio composition, or compare scenarios before committing. Results are temporary (expire after 1 hour) and never appear in brief history. For research-heavy scenarios, enrich with market data (earnings, price action, analyst sentiment) before calling this tool and pass it via context. Optionally override the strategy text to test 'what if my strategy said X?' without modifying the stored strategy. Returns a simulation_id with status 'processing' — call kova_show_simulation with that simulation_id until status is 'completed'. Simulation typically takes 60–120 seconds.

kova_simulate_portfolio

Update a non-ticker asset on a strategy. Merge semantics — only supplied fields change. Provide at least one field to update.

kova_update_asset

Update a liability on a strategy. Merge semantics — only supplied fields change. Provide at least one field to update.

kova_update_liability