Skip to main content
Glama

Prepare a portfolio import

prepare_portfolio_import
Idempotent

Prepare a portfolio import for investor review. Supply currency, valuation date and costs. Limits: 200 holdings and 200 transactions. Transaction-only histories need ISINs for trades, transfers and splits. For ticker-only history, request a holdings snapshot. Use supplied values only. Share review_url for confirmation in Investboard. Retry with the same request_id and payload. Requires portfolio:import.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "request_id": "<request_id>",
      "portfolio_name": "<portfolio_name>",
      "as_of": "<as_of>",
      "base_currency": "<base_currency>",
      "holdings": "<holdings>",
      "transactions": "<transactions>"
    },
    "name": "prepare_portfolio_import"
  }
}

Input Schema

NameRequiredDescriptionDefault
as_ofYesSource valuation timestamp with timezone; not upload time.
holdingsYesSupplied holdings snapshot; empty for a transaction-only import.
request_idYesStable request UUID; reuse with the identical payload on retries.
transactionsYesSupplied transaction history; empty for a holdings-only import.
base_currencyYesPortfolio reporting currency.
portfolio_nameYesInvestor's name for the portfolio to import.

Output Schema

NameRequiredDescriptionDefault
statusYes
receiptYes
draft_idYes
expires_atYes
review_urlYes
import_run_idYes
holdings_countYes
portfolio_nameYes
transactions_countYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed31 schema fields changed
    • addedInput schema / properties / as_of / description
      Added value: +"Source valuation timestamp with timezone; not upload time."
    • addedInput schema / properties / base_currency / description
      Added value: +"Portfolio reporting currency."
    • addedInput schema / properties / holdings / description
      Added value: +"Supplied holdings snapshot; empty for a transaction-only import."
    • addedInput schema / properties / holdings / items / properties / assetClass / description
      Added value: +"Investor-supplied asset classification."
    • addedInput schema / properties / holdings / items / properties / costBasisPerUnit / description
      Added value: +"Acquisition cost per unit in currency; never guess missing costs."
    • addedInput schema / properties / holdings / items / properties / currency / description
      Added value: +"Currency of the holding's per-unit amounts."
    • addedInput schema / properties / holdings / items / properties / currentPrice / description
      Added value: +"Source price per unit in currency, or null if unknown."
    • addedInput schema / properties / holdings / items / properties / exchange / description
      Added value: +"Listing venue, or null if unknown."
    • addedInput schema / properties / holdings / items / properties / isin / description
      Added value: +"Investor-supplied ISIN, or null when only a symbol is known."
    • addedInput schema / properties / holdings / items / properties / name / description
      Added value: +"Security label supplied by the investor."
    • addedInput schema / properties / holdings / items / properties / quantity / description
      Added value: +"Units held, not market value."
    • addedInput schema / properties / holdings / items / properties / symbol / description
      Added value: +"Investor-supplied ticker, or null when only an ISIN is known."
    • addedInput schema / properties / portfolio_name / description
      Added value: +"Investor's name for the portfolio to import."
    • addedInput schema / properties / request_id / description
      Added value: +"Stable request UUID; reuse with the identical payload on retries."
    • addedInput schema / properties / transactions / description
      Added value: +"Supplied transaction history; empty for a holdings-only import."
    • addedInput schema / properties / transactions / items / properties / accruedInterest / description
      Added value: +"Signed accrued interest in currency, when supplied."
    • addedInput schema / properties / transactions / items / properties / currency / description
      Added value: +"Currency of this transaction's monetary amounts."
    • addedInput schema / properties / transactions / items / properties / date / description
      Added value: +"Source transaction date, YYYY-MM-DD."
    • addedInput schema / properties / transactions / items / properties / externalInvestmentId / description
      Added value: +"Source investment reference, if supplied; not a match assertion."
    • addedInput schema / properties / transactions / items / properties / fees / description
      Added value: +"Total transaction fees in currency."
    • addedInput schema / properties / transactions / items / properties / grossDividend / description
      Added value: +"Gross dividend amount in currency, when supplied."
    • addedInput schema / properties / transactions / items / properties / isin / description
      Added value: +"Investor-supplied ISIN, or null; required for position changes in transaction-only imports."
    • addedInput schema / properties / transactions / items / properties / name / description
      Added value: +"Security label stated in the source, if available."
    • addedInput schema / properties / transactions / items / properties / netDividend / description
      Added value: +"Net dividend amount in currency, when supplied."
    • addedInput schema / properties / transactions / items / properties / price / description
      Added value: +"Source price per unit in currency."
    • addedInput schema / properties / transactions / items / properties / quantity / description
      Added value: +"Units affected by this transaction."
    • addedInput schema / properties / transactions / items / properties / splitRatio / description
      Added value: +"New units per old unit for a split."
    • addedInput schema / properties / transactions / items / properties / symbol / description
      Added value: +"Investor-supplied ticker, or null."
    • addedInput schema / properties / transactions / items / properties / taxes / description
      Added value: +"Total transaction taxes in currency."
    • addedInput schema / properties / transactions / items / properties / type / description
      Added value: +"Transaction kind stated in the source."
    • addedInput schema / properties / transactions / items / properties / withholdingTax / description
      Added value: +"Dividend withholding tax in currency, when supplied."
  2. Changed6 schema fields changed
    • removedInput schema / properties / as_of / pattern
      Removed value: -"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
    • removedInput schema / properties / request_id / pattern
      Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    • removedInput schema / properties / transactions / items / properties / date / pattern
      Removed value: -"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    • removedOutput schema / properties / draft_id / pattern
      Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    • removedOutput schema / properties / import_run_id / pattern
      Removed value: -"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    • changedOutput schema / properties / receipt / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "confirmedAt": {
      -        "type": "string"
      -      },
      -      "duplicateRows": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "holdingsClosed": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "holdingsCreated": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "holdingsUpdated": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "importRunId": {
      -        "format": "uuid",
      -        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -        "type": "string"
      -      },
      -      "portfolioId": {
      -        "format": "uuid",
      -        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -        "type": "string"
      -      },
      -      "portfolioOutcome": {
      -        "enum": [
      -          "created",
      -          "updated",
      -          "reactivated"
      -        ],
      -        "type": "string"
      -      },
      -      "rejectedRows": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "skippedRows": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "targetLinkedAccountId": {
      -        "format": "uuid",
      -        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -        "type": "string"
      -      },
      -      "transactionsCreated": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "transactionsSkipped": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "valuationCoverage": {
      -        "enum": [
      -          "complete",
      -          "partial",
      -          "none"
      -        ],
      -        "type": "string"
      -      },
      -      "warnings": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "code": {
      -              "enum": [
      -                "arbiter_collapse",
      -                "identity_replaced",
      -                "isin_contradiction",
      -                "costs_exceed_gross",
      -                "instrument_unresolved",
      -                "instrument_reference_retained",
      -                "instrument_currency_mismatch",
      -                "instrument_unverified_figi",
      -                "instrument_unverified_td",
      -                "instrument_symbol_unknown",
      -                "instrument_symbol_ambiguous",
      -                "csv_headers_unrecognized",
      -                "date_order_required",
      -                "as_of_date_order_unclear",
      -                "csv_format_collision",
      -                "mapping_inferred",
      -                "generic_parser_fallback",
      -                "pp_cash_export",
      -                "no_position_rows",
      -                "no_derivable_positions",
      -                "unrecognized_sections",
      -                "profile_cash_section",
      -                "cash_refusal_ing",
      -                "cash_refusal_dkb",
      -                "cash_refusal_dkb_legacy",
      -                "cash_refusal_comdirect_giro",
      -                "cash_refusal_comdirect_visa",
      -                "cash_refusal_sparkasse_camt",
      -                "cash_refusal_flatex_konto",
      -                "cash_refusal_degiro_account",
      -                "cash_refusal_ubs_account",
      -                "refuse_all_comdirect_depot",
      -                "post_parse_flatex_fees",
      -                "post_parse_degiro_dividends",
      -                "post_parse_comdirect_fees",
      -                "degiro_fees_not_read",
      -                "post_parse_ibkr_trades_only",
      -                "ibkr_positions_before_period",
      -                "ibkr_no_open_positions",
      -                "ibkr_categories_not_read",
      -                "ibkr_dividend_entries_unmatched",
      -                "ibkr_corporate_actions_not_read",
      -                "ibkr_positions_reduced_outside_trades",
      -                "ibkr_other_listing_trades",
      -                "stated_positions_snapshot",
      -                "xtb_listing_unclear",
      -                "xtb_foreign_currency_trades",
      -                "xtb_dividends_unbooked",
      -                "xtb_account_currency_unknown",
      -                "history_sold_before_file",
      -                "history_transfer_without_cost",
      -                "rows_rejected",
      -                "rows_duplicate",
      -                "rows_skipped_unparseable",
      -                "rows_skipped_status",
      -                "rows_cash_cost",
      -                "row_price_missing",
      -                "row_market_value_mismatch",
      -                "csv_cell_parse_error",
      -                "row_refused_number_unreadable_dot",
      -                "row_refused_number_unreadable_comma",
      -                "row_refused_date_unreadable",
      -                "row_refused_field_required",
      -                "row_refused_field_positive",
      -                "row_refused_field_min",
      -                "row_refused_currency_code",
      -                "row_refused_type_unsupported",
      -                "asset_class_empty",
      -                "asset_class_no_distinct_class",
      -                "asset_class_unrecognized",
      -                "asset_class_unmapped",
      -                "asset_class_unidentified",
      -                "portfolio_currency_conflict",
      -                "mixed_position_currencies",
      -                "mixed_currency_totals",
      -                "foreign_gross_rows",
      -                "foreign_price_rows",
      -                "currency_mismatch_rows",
      -                "rows_without_instrument_identity",
      -                "deferred_price_fx",
      -                "live_holdings_unvalidated",
      -                "live_transactions_unvalidated",
      -                "positions_skipped",
      -                "transactions_skipped",
      -                "dividends_incoherent",
      -                "pdf_positions_skipped",
      -                "pdf_activities_skipped",
      -                "pdf_no_activities",
      -                "unsupported_positions_skipped",
      -                "unsupported_transactions_skipped",
      -                "cash_balance_not_imported",
      -                "transaction_history_pending"
      -              ],
      -              "type": "string"
      -            },
      -            "line": {
      -              "type": "number"
      -            },
      -            "message": {
      -              "type": "string"
      -            },
      -            "params": {
      -              "additionalProperties": {
      -                "type": "string"
      -              },
      -              "propertyNames": {
      -                "type": "string"
      -              },
      -              "type": "object"
      -            },
      -            "stage": {
      -              "enum": [
      -                "parse",
      -                "confirm"
      -              ],
      -              "type": "string"
      -            },
      -            "type": {
      -              "enum": [
      -                "unknown_security",
      -                "ambiguous_match",
      -                "missing_field",
      -                "data_quality"
      -              ],
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "type",
      -            "message"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "warningsCount": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "importRunId",
      -      "portfolioId",
      -      "holdingsCreated",
      -      "transactionsCreated",
      -      "warningsCount",
      -      "skippedRows",
      -      "rejectedRows",
      -      "duplicateRows",
      -      "confirmedAt"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "confirmedAt": {
      +        "type": "string"
      +      },
      +      "duplicateRows": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "holdingsClosed": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "holdingsCreated": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "holdingsUpdated": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "importRunId": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "portfolioId": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "portfolioOutcome": {
      +        "enum": [
      +          "created",
      +          "updated",
      +          "reactivated"
      +        ],
      +        "type": "string"
      +      },
      +      "rejectedRows": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "skippedRows": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "targetLinkedAccountId": {
      +        "format": "uuid",
      +        "type": "string"
      +      },
      +      "transactionsCreated": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "transactionsSkipped": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "valuationCoverage": {
      +        "enum": [
      +          "complete",
      +          "partial",
      +          "none"
      +        ],
      +        "type": "string"
      +      },
      +      "warnings": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "code": {
      +              "enum": [
      +                "arbiter_collapse",
      +                "identity_replaced",
      +                "isin_contradiction",
      +                "costs_exceed_gross",
      +                "instrument_unresolved",
      +                "instrument_reference_retained",
      +                "instrument_currency_mismatch",
      +                "instrument_unverified_figi",
      +                "instrument_unverified_td",
      +                "instrument_symbol_unknown",
      +                "instrument_symbol_ambiguous",
      +                "csv_headers_unrecognized",
      +                "date_order_required",
      +                "as_of_date_order_unclear",
      +                "csv_format_collision",
      +                "mapping_inferred",
      +                "generic_parser_fallback",
      +                "pp_cash_export",
      +                "no_position_rows",
      +                "no_derivable_positions",
      +                "unrecognized_sections",
      +                "profile_cash_section",
      +                "cash_refusal_ing",
      +                "cash_refusal_dkb",
      +                "cash_refusal_dkb_legacy",
      +                "cash_refusal_comdirect_giro",
      +                "cash_refusal_comdirect_visa",
      +                "cash_refusal_sparkasse_camt",
      +                "cash_refusal_flatex_konto",
      +                "cash_refusal_degiro_account",
      +                "cash_refusal_ubs_account",
      +                "refuse_all_comdirect_depot",
      +                "post_parse_flatex_fees",
      +                "post_parse_degiro_dividends",
      +                "post_parse_comdirect_fees",
      +                "degiro_fees_not_read",
      +                "post_parse_ibkr_trades_only",
      +                "ibkr_positions_before_period",
      +                "ibkr_no_open_positions",
      +                "ibkr_categories_not_read",
      +                "ibkr_dividend_entries_unmatched",
      +                "ibkr_corporate_actions_not_read",
      +                "ibkr_positions_reduced_outside_trades",
      +                "ibkr_other_listing_trades",
      +                "stated_positions_snapshot",
      +                "xtb_listing_unclear",
      +                "xtb_foreign_currency_trades",
      +                "xtb_dividends_unbooked",
      +                "xtb_account_currency_unknown",
      +                "history_sold_before_file",
      +                "history_transfer_without_cost",
      +                "rows_rejected",
      +                "rows_duplicate",
      +                "rows_skipped_unparseable",
      +                "rows_skipped_status",
      +                "rows_cash_cost",
      +                "row_price_missing",
      +                "row_market_value_mismatch",
      +                "csv_cell_parse_error",
      +                "row_refused_number_unreadable_dot",
      +                "row_refused_number_unreadable_comma",
      +                "row_refused_date_unreadable",
      +                "row_refused_field_required",
      +                "row_refused_field_positive",
      +                "row_refused_field_min",
      +                "row_refused_currency_code",
      +                "row_refused_type_unsupported",
      +                "asset_class_empty",
      +                "asset_class_no_distinct_class",
      +                "asset_class_unrecognized",
      +                "asset_class_unmapped",
      +                "asset_class_unidentified",
      +                "portfolio_currency_conflict",
      +                "mixed_position_currencies",
      +                "mixed_currency_totals",
      +                "foreign_gross_rows",
      +                "foreign_price_rows",
      +                "currency_mismatch_rows",
      +                "rows_without_instrument_identity",
      +                "deferred_price_fx",
      +                "live_holdings_unvalidated",
      +                "live_transactions_unvalidated",
      +                "positions_skipped",
      +                "transactions_skipped",
      +                "dividends_incoherent",
      +                "pdf_positions_skipped",
      +                "pdf_activities_skipped",
      +                "pdf_no_activities",
      +                "unsupported_positions_skipped",
      +                "unsupported_transactions_skipped",
      +                "cash_balance_not_imported",
      +                "transaction_history_pending"
      +              ],
      +              "type": "string"
      +            },
      +            "line": {
      +              "type": "number"
      +            },
      +            "message": {
      +              "type": "string"
      +            },
      +            "params": {
      +              "additionalProperties": {
      +                "type": "string"
      +              },
      +              "propertyNames": {
      +                "type": "string"
      +              },
      +              "type": "object"
      +            },
      +            "stage": {
      +              "enum": [
      +                "parse",
      +                "confirm"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "enum": [
      +                "unknown_security",
      +                "ambiguous_match",
      +                "missing_field",
      +                "data_quality"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "type",
      +            "message"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "warningsCount": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "importRunId",
      +      "portfolioId",
      +      "holdingsCreated",
      +      "transactionsCreated",
      +      "warningsCount",
      +      "skippedRows",
      +      "rejectedRows",
      +      "duplicateRows",
      +      "confirmedAt"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. Changed1 schema field changed
    • addedInput schema / properties / transactions / items / properties / name
      Added value: +{
      +  "maxLength": 200,
      +  "type": "string"
      +}
  4. Changed2 schema fields changed
    • addedInput schema / properties / transactions / items / properties / externalInvestmentId
      Added value: +{
      +  "maxLength": 256,
      +  "minLength": 1,
      +  "pattern": "^[\\x21-\\x7E]+$",
      +  "type": "string"
      +}
    • changedOutput schema / properties / receipt / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "confirmedAt": {
      -        "type": "string"
      -      },
      -      "duplicateRows": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "holdingsClosed": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "holdingsCreated": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "holdingsUpdated": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "importRunId": {
      -        "format": "uuid",
      -        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -        "type": "string"
      -      },
      -      "portfolioId": {
      -        "format": "uuid",
      -        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -        "type": "string"
      -      },
      -      "portfolioOutcome": {
      -        "enum": [
      -          "created",
      -          "updated",
      -          "reactivated"
      -        ],
      -        "type": "string"
      -      },
      -      "rejectedRows": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "skippedRows": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "targetLinkedAccountId": {
      -        "format": "uuid",
      -        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      -        "type": "string"
      -      },
      -      "transactionsCreated": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "transactionsSkipped": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "valuationCoverage": {
      -        "enum": [
      -          "complete",
      -          "partial",
      -          "none"
      -        ],
      -        "type": "string"
      -      },
      -      "warnings": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "code": {
      -              "enum": [
      -                "arbiter_collapse",
      -                "identity_replaced",
      -                "isin_contradiction",
      -                "costs_exceed_gross",
      -                "instrument_unresolved",
      -                "instrument_reference_retained",
      -                "instrument_currency_mismatch",
      -                "instrument_unverified_figi",
      -                "instrument_unverified_td",
      -                "instrument_symbol_unknown",
      -                "instrument_symbol_ambiguous",
      -                "csv_headers_unrecognized",
      -                "date_order_required",
      -                "as_of_date_order_unclear",
      -                "csv_format_collision",
      -                "mapping_inferred",
      -                "generic_parser_fallback",
      -                "pp_cash_export",
      -                "no_position_rows",
      -                "no_derivable_positions",
      -                "unrecognized_sections",
      -                "profile_cash_section",
      -                "cash_refusal_ing",
      -                "cash_refusal_dkb",
      -                "cash_refusal_dkb_legacy",
      -                "cash_refusal_comdirect_giro",
      -                "cash_refusal_comdirect_visa",
      -                "cash_refusal_sparkasse_camt",
      -                "cash_refusal_flatex_konto",
      -                "cash_refusal_degiro_account",
      -                "cash_refusal_ubs_account",
      -                "refuse_all_comdirect_depot",
      -                "post_parse_flatex_fees",
      -                "post_parse_degiro_dividends",
      -                "post_parse_comdirect_fees",
      -                "degiro_fees_not_read",
      -                "post_parse_ibkr_trades_only",
      -                "ibkr_positions_before_period",
      -                "ibkr_no_open_positions",
      -                "ibkr_categories_not_read",
      -                "ibkr_dividend_entries_unmatched",
      -                "ibkr_corporate_actions_not_read",
      -                "ibkr_positions_reduced_outside_trades",
      -                "ibkr_other_listing_trades",
      -                "stated_positions_snapshot",
      -                "xtb_listing_unclear",
      -                "xtb_foreign_currency_trades",
      -                "xtb_dividends_unbooked",
      -                "xtb_account_currency_unknown",
      -                "history_sold_before_file",
      -                "history_transfer_without_cost",
      -                "rows_rejected",
      -                "rows_duplicate",
      -                "rows_skipped_unparseable",
      -                "rows_skipped_status",
      -                "rows_cash_cost",
      -                "row_price_missing",
      -                "row_market_value_mismatch",
      -                "csv_cell_parse_error",
      -                "row_refused_number_unreadable_dot",
      -                "row_refused_number_unreadable_comma",
      -                "row_refused_date_unreadable",
      -                "row_refused_field_required",
      -                "row_refused_field_positive",
      -                "row_refused_field_min",
      -                "row_refused_currency_code",
      -                "row_refused_type_unsupported",
      -                "asset_class_empty",
      -                "asset_class_no_distinct_class",
      -                "asset_class_unrecognized",
      -                "asset_class_unmapped",
      -                "asset_class_unidentified",
      -                "portfolio_currency_conflict",
      -                "mixed_position_currencies",
      -                "mixed_currency_totals",
      -                "foreign_gross_rows",
      -                "foreign_price_rows",
      -                "currency_mismatch_rows",
      -                "rows_without_instrument_identity",
      -                "deferred_price_fx",
      -                "live_holdings_unvalidated",
      -                "live_transactions_unvalidated",
      -                "positions_skipped",
      -                "transactions_skipped",
      -                "dividends_incoherent",
      -                "pdf_positions_skipped",
      -                "pdf_activities_skipped",
      -                "pdf_no_activities"
      -              ],
      -              "type": "string"
      -            },
      -            "line": {
      -              "type": "number"
      -            },
      -            "message": {
      -              "type": "string"
      -            },
      -            "params": {
      -              "additionalProperties": {
      -                "type": "string"
      -              },
      -              "propertyNames": {
      -                "type": "string"
      -              },
      -              "type": "object"
      -            },
      -            "stage": {
      -              "enum": [
      -                "parse",
      -                "confirm"
      -              ],
      -              "type": "string"
      -            },
      -            "type": {
      -              "enum": [
      -                "unknown_security",
      -                "ambiguous_match",
      -                "missing_field",
      -                "data_quality"
      -              ],
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "type",
      -            "message"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "warningsCount": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "importRunId",
      -      "portfolioId",
      -      "holdingsCreated",
      -      "transactionsCreated",
      -      "warningsCount",
      -      "skippedRows",
      -      "rejectedRows",
      -      "duplicateRows",
      -      "confirmedAt"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "confirmedAt": {
      +        "type": "string"
      +      },
      +      "duplicateRows": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "holdingsClosed": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "holdingsCreated": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "holdingsUpdated": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "importRunId": {
      +        "format": "uuid",
      +        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      +        "type": "string"
      +      },
      +      "portfolioId": {
      +        "format": "uuid",
      +        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      +        "type": "string"
      +      },
      +      "portfolioOutcome": {
      +        "enum": [
      +          "created",
      +          "updated",
      +          "reactivated"
      +        ],
      +        "type": "string"
      +      },
      +      "rejectedRows": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "skippedRows": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "targetLinkedAccountId": {
      +        "format": "uuid",
      +        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      +        "type": "string"
      +      },
      +      "transactionsCreated": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "transactionsSkipped": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "valuationCoverage": {
      +        "enum": [
      +          "complete",
      +          "partial",
      +          "none"
      +        ],
      +        "type": "string"
      +      },
      +      "warnings": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "code": {
      +              "enum": [
      +                "arbiter_collapse",
      +                "identity_replaced",
      +                "isin_contradiction",
      +                "costs_exceed_gross",
      +                "instrument_unresolved",
      +                "instrument_reference_retained",
      +                "instrument_currency_mismatch",
      +                "instrument_unverified_figi",
      +                "instrument_unverified_td",
      +                "instrument_symbol_unknown",
      +                "instrument_symbol_ambiguous",
      +                "csv_headers_unrecognized",
      +                "date_order_required",
      +                "as_of_date_order_unclear",
      +                "csv_format_collision",
      +                "mapping_inferred",
      +                "generic_parser_fallback",
      +                "pp_cash_export",
      +                "no_position_rows",
      +                "no_derivable_positions",
      +                "unrecognized_sections",
      +                "profile_cash_section",
      +                "cash_refusal_ing",
      +                "cash_refusal_dkb",
      +                "cash_refusal_dkb_legacy",
      +                "cash_refusal_comdirect_giro",
      +                "cash_refusal_comdirect_visa",
      +                "cash_refusal_sparkasse_camt",
      +                "cash_refusal_flatex_konto",
      +                "cash_refusal_degiro_account",
      +                "cash_refusal_ubs_account",
      +                "refuse_all_comdirect_depot",
      +                "post_parse_flatex_fees",
      +                "post_parse_degiro_dividends",
      +                "post_parse_comdirect_fees",
      +                "degiro_fees_not_read",
      +                "post_parse_ibkr_trades_only",
      +                "ibkr_positions_before_period",
      +                "ibkr_no_open_positions",
      +                "ibkr_categories_not_read",
      +                "ibkr_dividend_entries_unmatched",
      +                "ibkr_corporate_actions_not_read",
      +                "ibkr_positions_reduced_outside_trades",
      +                "ibkr_other_listing_trades",
      +                "stated_positions_snapshot",
      +                "xtb_listing_unclear",
      +                "xtb_foreign_currency_trades",
      +                "xtb_dividends_unbooked",
      +                "xtb_account_currency_unknown",
      +                "history_sold_before_file",
      +                "history_transfer_without_cost",
      +                "rows_rejected",
      +                "rows_duplicate",
      +                "rows_skipped_unparseable",
      +                "rows_skipped_status",
      +                "rows_cash_cost",
      +                "row_price_missing",
      +                "row_market_value_mismatch",
      +                "csv_cell_parse_error",
      +                "row_refused_number_unreadable_dot",
      +                "row_refused_number_unreadable_comma",
      +                "row_refused_date_unreadable",
      +                "row_refused_field_required",
      +                "row_refused_field_positive",
      +                "row_refused_field_min",
      +                "row_refused_currency_code",
      +                "row_refused_type_unsupported",
      +                "asset_class_empty",
      +                "asset_class_no_distinct_class",
      +                "asset_class_unrecognized",
      +                "asset_class_unmapped",
      +                "asset_class_unidentified",
      +                "portfolio_currency_conflict",
      +                "mixed_position_currencies",
      +                "mixed_currency_totals",
      +                "foreign_gross_rows",
      +                "foreign_price_rows",
      +                "currency_mismatch_rows",
      +                "rows_without_instrument_identity",
      +                "deferred_price_fx",
      +                "live_holdings_unvalidated",
      +                "live_transactions_unvalidated",
      +                "positions_skipped",
      +                "transactions_skipped",
      +                "dividends_incoherent",
      +                "pdf_positions_skipped",
      +                "pdf_activities_skipped",
      +                "pdf_no_activities",
      +                "unsupported_positions_skipped",
      +                "unsupported_transactions_skipped",
      +                "cash_balance_not_imported",
      +                "transaction_history_pending"
      +              ],
      +              "type": "string"
      +            },
      +            "line": {
      +              "type": "number"
      +            },
      +            "message": {
      +              "type": "string"
      +            },
      +            "params": {
      +              "additionalProperties": {
      +                "type": "string"
      +              },
      +              "propertyNames": {
      +                "type": "string"
      +              },
      +              "type": "object"
      +            },
      +            "stage": {
      +              "enum": [
      +                "parse",
      +                "confirm"
      +              ],
      +              "type": "string"
      +            },
      +            "type": {
      +              "enum": [
      +                "unknown_security",
      +                "ambiguous_match",
      +                "missing_field",
      +                "data_quality"
      +              ],
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "type",
      +            "message"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "warningsCount": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "importRunId",
      +      "portfolioId",
      +      "holdingsCreated",
      +      "transactionsCreated",
      +      "warningsCount",
      +      "skippedRows",
      +      "rejectedRows",
      +      "duplicateRows",
      +      "confirmedAt"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  5. Added

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare idempotent=true and destructive=false, and the description reinforces this with a concrete retry contract (same request_id and payload) and the confirmation workflow via review_url. It also states the permission requirement and the 'use supplied values only' constraint. The 200/200 limits largely restate schema maxItems, which slightly limits added value.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the purpose, then the rules in short, scannable sentences with nothing decorative. The telegraphic fragments ("Use supplied values only.") trade grammar for density, which is acceptable but slightly reduces clarity about what each rule applies to.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 6-parameter mutation with an output schema, the description covers the essentials: prerequisites, limits, mode-specific ISIN rules, confirmation flow and retry semantics. Minor gaps remain around what the prepared review actually contains, but the output schema and sibling get_portfolio_import cover that.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already carries parameter meaning, and the ISIN requirement the description cites is also present in the isin field description. "Supply currency, valuation date and costs" maps loosely to base_currency, as_of and the cost/fee fields without adding precision beyond the schema. This is a baseline 3 case.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

"Prepare a portfolio import for investor review" names a specific verb and resource, and the mention of a review_url makes the output of the preparation step clear. It does not explicitly contrast with get_portfolio_import or prepare_review, so sibling differentiation is left implicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives real conditional guidance: transaction-only histories need ISINs for trades, transfers and splits, and ticker-only histories should instead request a holdings snapshot. Retry behaviour and the portfolio:import scope are stated. It stops short of naming sibling tools to use instead, so it is clear context rather than a full routing rule.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.