MCP tools

The complete tool surface an authorized MCP client can call. Thirteen tools in three groups. Every write tool requires an idempotencyKey; there is no HTTP write route.

Product tools

Products and their weekly evidence.

create_productwriteAdds a product to the organization.
update_productwriteChanges a product record.
archive_productwriteRetires a product from the active portfolio. Evidence and decisions are kept.
upsert_weekly_snapshotwriteRecords or updates the snapshot for one product and one week, with its area signals.
list_portfolioreadReads every product in the organization against the latest week.
get_productreadReads one product and its current state.
list_product_snapshotsreadReads the weekly snapshot history for one product.

Decision tools

The decision ledger. Decisions are immutable; there is no update or delete tool.

record_decisionwriteRecords a typed focus, budget, or metric decision and applies its effect in the same action.
supersede_decisionwriteRecords a new decision that replaces an earlier one, linked by supersedes_decision_id.
list_decisionsreadReads the decision log. Default page size 20, maximum 100.
get_decisionreadReads one decision by id.

Meta tools

Progressive disclosure helpers used by clients to discover what is available.

describe_capabilitiesreadDescribes the tool surface to the client.
use_capabilityreadInvokes a named skill. No skills are registered today, so any name returns a not-found result. The tool is present but exposes nothing to call.

Idempotency

How retries are made safe on the write tools.

idempotencyKeyrequiredEvery write tool takes one. Receipts are unique per organization, tool name, and key, so a retried call does not write twice.