Skip to main content
Glama

Tokenbooks - crypto and fiat accounting and payments

Import Adjustment Journals

import_adjustment_journals

Preview or post a complete CSV or XLSX file of balanced manual adjustment journals for one portfolio. Preview first; post only after reviewing every blocking issue, then resend the unchanged source with its preview token and any resolutions.

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": {
      "workspaceRef": "<workspaceRef>",
      "portfolioRef": "<portfolioRef>",
      "action": "<action>",
      "contentBase64": "<contentBase64>",
      "fileName": "<fileName>"
    },
    "name": "import_adjustment_journals"
  }
}

Input Schema

NameRequiredDescriptionDefault
actionYespreview: Parse the file and report what it would import, writing nothing. Always preview before posting. post: Commit the import that a preview of the same file produced.
fileNameYesOriginal CSV or XLSX source filename.
resolutionsNoOnly for action post; required for each.
portfolioRefYesPortfolio name or slug inside that workspace. Call list_portfolios to resolve it.
previewTokenNoToken returned by the matching preview, proving the file has not changed since. Only for action post; required for each.
workspaceRefYesWorkspace name or slug. Call list_workspaces to resolve it.
contentBase64YesCSV or XLSX source file content as base64-encoded bytes (max 5 MiB).

Output Schema

NameRequiredDescriptionDefault
actionYes
issuesNo
summaryNo
journalsYes
importRefNo
readyToPostNo
previewTokenNo
createdJournalCountNo
omittedJournalCountYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / resolutions / items / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "accountNumber": {
      -        "description": "Ledger account to use for that row, from list_journal_line_assignment_options (type: ledger_account).",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Kind of reference this row fixes.",
      -        "enum": [
      -          "account"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "description": "1-based line number in the CSV file.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "description": "1-based row number within the sheet.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "description": "Worksheet the row belongs to.",
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "accountNumber",
      -      "kind",
      -      "locator"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "externalId": {
      -        "description": "Counterparty's external identifier, as recorded on the counterparty.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Kind of reference this row fixes.",
      -        "enum": [
      -          "counterparty"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "description": "1-based line number in the CSV file.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "description": "1-based row number within the sheet.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "description": "Worksheet the row belongs to.",
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "externalId",
      -      "kind",
      -      "locator"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "description": "Kind of reference this row fixes.",
      -        "enum": [
      -          "counterparty"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "description": "1-based line number in the CSV file.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "description": "1-based row number within the sheet.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "description": "Worksheet the row belongs to.",
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      },
      -      "name": {
      -        "description": "Counterparty name to use for that row, from list_journal_line_assignment_options (type: counterparty).",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "locator",
      -      "name"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "centerName": {
      -        "description": "Responsibility center to use for that row, from list_journal_line_assignment_options (type: responsibility_center).",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Kind of reference this row fixes.",
      -        "enum": [
      -          "responsibilityCenter"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "description": "1-based line number in the CSV file.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "description": "1-based row number within the sheet.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "description": "Worksheet the row belongs to.",
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      },
      -      "typeKey": {
      -        "description": "Responsibility center type the name belongs to, such as costCenter.",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "centerName",
      -      "kind",
      -      "locator",
      -      "typeKey"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "accountNumber": {
      +        "description": "Ledger account to use for that row, from list_journal_line_assignment_options (type: ledger_account).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "kind": {
      +        "const": "account",
      +        "description": "Kind of reference this row fixes.",
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "const": "csv",
      +                "description": "Source file format.",
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "const": "xlsx",
      +                "description": "Source file format.",
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "accountNumber",
      +      "kind",
      +      "locator"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "externalId": {
      +        "description": "Counterparty's external identifier, as recorded on the counterparty.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "kind": {
      +        "const": "counterparty",
      +        "description": "Kind of reference this row fixes.",
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "const": "csv",
      +                "description": "Source file format.",
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "const": "xlsx",
      +                "description": "Source file format.",
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "externalId",
      +      "kind",
      +      "locator"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "const": "counterparty",
      +        "description": "Kind of reference this row fixes.",
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "const": "csv",
      +                "description": "Source file format.",
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "const": "xlsx",
      +                "description": "Source file format.",
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "name": {
      +        "description": "Counterparty name to use for that row, from list_journal_line_assignment_options (type: counterparty).",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "locator",
      +      "name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "centerName": {
      +        "description": "Responsibility center to use for that row, from list_journal_line_assignment_options (type: responsibility_center).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "kind": {
      +        "const": "responsibilityCenter",
      +        "description": "Kind of reference this row fixes.",
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "const": "csv",
      +                "description": "Source file format.",
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "const": "xlsx",
      +                "description": "Source file format.",
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "typeKey": {
      +        "description": "Responsibility center type the name belongs to, such as costCenter.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "centerName",
      +      "kind",
      +      "locator",
      +      "typeKey"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed4 schema fields changed
    • removedInput schema / oneOf
      Removed value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "action": {
      -        "description": "Parse the file and report what it would import, writing nothing. Always preview before posting.",
      -        "enum": [
      -          "preview"
      -        ],
      -        "type": "string"
      -      },
      -      "contentBase64": {
      -        "$ref": "#/properties/contentBase64"
      -      },
      -      "fileName": {
      -        "$ref": "#/properties/fileName"
      -      },
      -      "portfolioRef": {
      -        "$ref": "#/properties/portfolioRef"
      -      },
      -      "workspaceRef": {
      -        "$ref": "#/properties/workspaceRef"
      -      }
      -    },
      -    "required": [
      -      "workspaceRef",
      -      "portfolioRef",
      -      "action",
      -      "contentBase64",
      -      "fileName"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "action": {
      -        "description": "Commit the import that a preview of the same file produced.",
      -        "enum": [
      -          "post"
      -        ],
      -        "type": "string"
      -      },
      -      "contentBase64": {
      -        "$ref": "#/properties/contentBase64"
      -      },
      -      "fileName": {
      -        "$ref": "#/properties/fileName"
      -      },
      -      "portfolioRef": {
      -        "$ref": "#/properties/portfolioRef"
      -      },
      -      "previewToken": {
      -        "$ref": "#/properties/previewToken"
      -      },
      -      "resolutions": {
      -        "$ref": "#/properties/resolutions"
      -      },
      -      "workspaceRef": {
      -        "$ref": "#/properties/workspaceRef"
      -      }
      -    },
      -    "required": [
      -      "workspaceRef",
      -      "portfolioRef",
      -      "action",
      -      "contentBase64",
      -      "fileName",
      -      "previewToken",
      -      "resolutions"
      -    ],
      -    "type": "object"
      -  }
      -]
    • changedInput schema / properties / action / description
      Previous value: -"Parse the file and report what it would import, writing nothing. Always preview before posting."New value: +"preview: Parse the file and report what it would import, writing nothing. Always preview before posting. post: Commit the import that a preview of the same file produced."
    • changedInput schema / properties / previewToken / description
      Previous value: -"Token returned by the matching preview, proving the file has not changed since."New value: +"Token returned by the matching preview, proving the file has not changed since. Only for action post; required for each."
    • addedInput schema / properties / resolutions / description
      Added value: +"Only for action post; required for each."
  3. Changed3 schema fields changed
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "action": {
      -        "const": "preview",
      -        "type": "string"
      -      },
      -      "issues": {
      -        "oneOf": [
      -          {
      -            "$ref": "#/$defs/AjFullIssues"
      -          },
      -          {
      -            "$ref": "#/$defs/AjIssueSummary"
      -          }
      -        ]
      -      },
      -      "journals": {
      -        "items": {
      -          "$ref": "#/$defs/AjPreviewJournal"
      -        },
      -        "maxItems": 3,
      -        "type": "array"
      -      },
      -      "omittedJournalCount": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "previewToken": {
      -        "pattern": "^[0-9a-f]{64}$",
      -        "type": "string"
      -      },
      -      "readyToPost": {
      -        "type": "boolean"
      -      },
      -      "summary": {
      -        "$ref": "#/$defs/AjPreviewSummary"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "previewToken",
      -      "readyToPost",
      -      "summary",
      -      "journals",
      -      "omittedJournalCount",
      -      "issues"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "action": {
      -        "const": "post",
      -        "type": "string"
      -      },
      -      "createdJournalCount": {
      -        "exclusiveMinimum": 0,
      -        "maximum": 9007199254740991,
      -        "type": "integer"
      -      },
      -      "importRef": {
      -        "maxLength": 128,
      -        "minLength": 1,
      -        "pattern": "^adjustment-journal-import-[a-z0-9-]+$",
      -        "type": "string"
      -      },
      -      "journals": {
      -        "items": {
      -          "$ref": "#/$defs/AjPostJournal"
      -        },
      -        "maxItems": 3,
      -        "type": "array"
      -      },
      -      "omittedJournalCount": {
      -        "maximum": 9007199254740991,
      -        "minimum": 0,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "action",
      -      "importRef",
      -      "createdJournalCount",
      -      "journals",
      -      "omittedJournalCount"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "action": {
      +        "const": "preview",
      +        "type": "string"
      +      },
      +      "issues": {
      +        "oneOf": [
      +          {
      +            "$ref": "#/$defs/AjFullIssues"
      +          },
      +          {
      +            "$ref": "#/$defs/AjIssueSummary"
      +          }
      +        ]
      +      },
      +      "journals": {
      +        "items": {
      +          "$ref": "#/$defs/AjPreviewJournal"
      +        },
      +        "maxItems": 3,
      +        "type": "array"
      +      },
      +      "omittedJournalCount": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "previewToken": {
      +        "pattern": "^[0-9a-f]{64}$",
      +        "type": "string"
      +      },
      +      "readyToPost": {
      +        "type": "boolean"
      +      },
      +      "summary": {
      +        "$ref": "#/$defs/AjPreviewSummary"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "previewToken",
      +      "readyToPost",
      +      "summary",
      +      "journals",
      +      "omittedJournalCount",
      +      "issues"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "action": {
      +        "const": "post",
      +        "type": "string"
      +      },
      +      "createdJournalCount": {
      +        "maximum": 9007199254740991,
      +        "minimum": 1,
      +        "type": "integer"
      +      },
      +      "importRef": {
      +        "maxLength": 128,
      +        "minLength": 1,
      +        "pattern": "^adjustment-journal-import-[a-z0-9-]+$",
      +        "type": "string"
      +      },
      +      "journals": {
      +        "items": {
      +          "$ref": "#/$defs/AjPostJournal"
      +        },
      +        "maxItems": 3,
      +        "type": "array"
      +      },
      +      "omittedJournalCount": {
      +        "maximum": 9007199254740991,
      +        "minimum": 0,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "action",
      +      "importRef",
      +      "createdJournalCount",
      +      "journals",
      +      "omittedJournalCount"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties / createdJournalCount / exclusiveMinimum
      Removed value: -0
    • addedOutput schema / properties / createdJournalCount / minimum
      Added value: +1
  4. Changed3 schema fields changed
    • changedInput schema / properties / portfolioRef / description
      Previous value: -"Portfolio name or slug inside that workspace. Call list_portfolios, or find_portfolios when the user named one, to resolve it."New value: +"Portfolio name or slug inside that workspace. Call list_portfolios to resolve it."
    • changedInput schema / properties / resolutions / items / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "accountNumber": {
      -        "description": "Ledger account to use for that row, from list_ledger_accounts.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Kind of reference this row fixes.",
      -        "enum": [
      -          "account"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "description": "1-based line number in the CSV file.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "description": "1-based row number within the sheet.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "description": "Worksheet the row belongs to.",
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "accountNumber",
      -      "kind",
      -      "locator"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "externalId": {
      -        "description": "Counterparty's external identifier, as recorded on the counterparty.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Kind of reference this row fixes.",
      -        "enum": [
      -          "counterparty"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "description": "1-based line number in the CSV file.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "description": "1-based row number within the sheet.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "description": "Worksheet the row belongs to.",
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "externalId",
      -      "kind",
      -      "locator"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "description": "Kind of reference this row fixes.",
      -        "enum": [
      -          "counterparty"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "description": "1-based line number in the CSV file.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "description": "1-based row number within the sheet.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "description": "Worksheet the row belongs to.",
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      },
      -      "name": {
      -        "description": "Counterparty name to use for that row, from list_counterparties.",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "locator",
      -      "name"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "centerName": {
      -        "description": "Responsibility center to use for that row, from list_responsibility_centers.",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "kind": {
      -        "description": "Kind of reference this row fixes.",
      -        "enum": [
      -          "responsibilityCenter"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "description": "1-based line number in the CSV file.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "description": "Source file format.",
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "description": "1-based row number within the sheet.",
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "description": "Worksheet the row belongs to.",
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      },
      -      "typeKey": {
      -        "description": "Responsibility center type the name belongs to, such as costCenter.",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "centerName",
      -      "kind",
      -      "locator",
      -      "typeKey"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "accountNumber": {
      +        "description": "Ledger account to use for that row, from list_journal_line_assignment_options (type: ledger_account).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Kind of reference this row fixes.",
      +        "enum": [
      +          "account"
      +        ],
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "csv"
      +                ],
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "xlsx"
      +                ],
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "accountNumber",
      +      "kind",
      +      "locator"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "externalId": {
      +        "description": "Counterparty's external identifier, as recorded on the counterparty.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Kind of reference this row fixes.",
      +        "enum": [
      +          "counterparty"
      +        ],
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "csv"
      +                ],
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "xlsx"
      +                ],
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "externalId",
      +      "kind",
      +      "locator"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "description": "Kind of reference this row fixes.",
      +        "enum": [
      +          "counterparty"
      +        ],
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "csv"
      +                ],
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "xlsx"
      +                ],
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "name": {
      +        "description": "Counterparty name to use for that row, from list_journal_line_assignment_options (type: counterparty).",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "locator",
      +      "name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "centerName": {
      +        "description": "Responsibility center to use for that row, from list_journal_line_assignment_options (type: responsibility_center).",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Kind of reference this row fixes.",
      +        "enum": [
      +          "responsibilityCenter"
      +        ],
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "csv"
      +                ],
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "xlsx"
      +                ],
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "typeKey": {
      +        "description": "Responsibility center type the name belongs to, such as costCenter.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "centerName",
      +      "kind",
      +      "locator",
      +      "typeKey"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / workspaceRef / description
      Previous value: -"Workspace name or slug. Call list_workspaces, or find_workspaces when the user named one, to resolve it."New value: +"Workspace name or slug. Call list_workspaces to resolve it."
  5. Changed6 schema fields changed
    • changedInput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "action": {
      -        "enum": [
      -          "preview"
      -        ],
      -        "type": "string"
      -      },
      -      "contentBase64": {
      -        "$ref": "#/properties/contentBase64"
      -      },
      -      "fileName": {
      -        "$ref": "#/properties/fileName"
      -      },
      -      "portfolioRef": {
      -        "$ref": "#/properties/portfolioRef"
      -      },
      -      "workspaceRef": {
      -        "$ref": "#/properties/workspaceRef"
      -      }
      -    },
      -    "required": [
      -      "workspaceRef",
      -      "portfolioRef",
      -      "action",
      -      "contentBase64",
      -      "fileName"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "action": {
      -        "enum": [
      -          "post"
      -        ],
      -        "type": "string"
      -      },
      -      "contentBase64": {
      -        "$ref": "#/properties/contentBase64"
      -      },
      -      "fileName": {
      -        "$ref": "#/properties/fileName"
      -      },
      -      "portfolioRef": {
      -        "$ref": "#/properties/portfolioRef"
      -      },
      -      "previewToken": {
      -        "$ref": "#/properties/previewToken"
      -      },
      -      "resolutions": {
      -        "$ref": "#/properties/resolutions"
      -      },
      -      "workspaceRef": {
      -        "$ref": "#/properties/workspaceRef"
      -      }
      -    },
      -    "required": [
      -      "workspaceRef",
      -      "portfolioRef",
      -      "action",
      -      "contentBase64",
      -      "fileName",
      -      "previewToken",
      -      "resolutions"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "action": {
      +        "description": "Parse the file and report what it would import, writing nothing. Always preview before posting.",
      +        "enum": [
      +          "preview"
      +        ],
      +        "type": "string"
      +      },
      +      "contentBase64": {
      +        "$ref": "#/properties/contentBase64"
      +      },
      +      "fileName": {
      +        "$ref": "#/properties/fileName"
      +      },
      +      "portfolioRef": {
      +        "$ref": "#/properties/portfolioRef"
      +      },
      +      "workspaceRef": {
      +        "$ref": "#/properties/workspaceRef"
      +      }
      +    },
      +    "required": [
      +      "workspaceRef",
      +      "portfolioRef",
      +      "action",
      +      "contentBase64",
      +      "fileName"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "action": {
      +        "description": "Commit the import that a preview of the same file produced.",
      +        "enum": [
      +          "post"
      +        ],
      +        "type": "string"
      +      },
      +      "contentBase64": {
      +        "$ref": "#/properties/contentBase64"
      +      },
      +      "fileName": {
      +        "$ref": "#/properties/fileName"
      +      },
      +      "portfolioRef": {
      +        "$ref": "#/properties/portfolioRef"
      +      },
      +      "previewToken": {
      +        "$ref": "#/properties/previewToken"
      +      },
      +      "resolutions": {
      +        "$ref": "#/properties/resolutions"
      +      },
      +      "workspaceRef": {
      +        "$ref": "#/properties/workspaceRef"
      +      }
      +    },
      +    "required": [
      +      "workspaceRef",
      +      "portfolioRef",
      +      "action",
      +      "contentBase64",
      +      "fileName",
      +      "previewToken",
      +      "resolutions"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / action / description
      Added value: +"Parse the file and report what it would import, writing nothing. Always preview before posting."
    • addedInput schema / properties / portfolioRef / description
      Added value: +"Portfolio name or slug inside that workspace. Call list_portfolios, or find_portfolios when the user named one, to resolve it."
    • addedInput schema / properties / previewToken / description
      Added value: +"Token returned by the matching preview, proving the file has not changed since."
    • changedInput schema / properties / resolutions / items / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "accountNumber": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "kind": {
      -        "enum": [
      -          "account"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "accountNumber",
      -      "kind",
      -      "locator"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "externalId": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "kind": {
      -        "enum": [
      -          "counterparty"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "externalId",
      -      "kind",
      -      "locator"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "kind": {
      -        "enum": [
      -          "counterparty"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      },
      -      "name": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "kind",
      -      "locator",
      -      "name"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "centerName": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "kind": {
      -        "enum": [
      -          "responsibilityCenter"
      -        ],
      -        "type": "string"
      -      },
      -      "locator": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "enum": [
      -                  "csv"
      -                ],
      -                "type": "string"
      -              },
      -              "lineNumber": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "lineNumber"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "format": {
      -                "enum": [
      -                  "xlsx"
      -                ],
      -                "type": "string"
      -              },
      -              "rowNumber": {
      -                "maximum": 9007199254740991,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "sheetName": {
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "format",
      -              "rowNumber",
      -              "sheetName"
      -            ],
      -            "type": "object"
      -          }
      -        ]
      -      },
      -      "typeKey": {
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "centerName",
      -      "kind",
      -      "locator",
      -      "typeKey"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "accountNumber": {
      +        "description": "Ledger account to use for that row, from list_ledger_accounts.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Kind of reference this row fixes.",
      +        "enum": [
      +          "account"
      +        ],
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "csv"
      +                ],
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "xlsx"
      +                ],
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "accountNumber",
      +      "kind",
      +      "locator"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "externalId": {
      +        "description": "Counterparty's external identifier, as recorded on the counterparty.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Kind of reference this row fixes.",
      +        "enum": [
      +          "counterparty"
      +        ],
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "csv"
      +                ],
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "xlsx"
      +                ],
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "externalId",
      +      "kind",
      +      "locator"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "kind": {
      +        "description": "Kind of reference this row fixes.",
      +        "enum": [
      +          "counterparty"
      +        ],
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "csv"
      +                ],
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "xlsx"
      +                ],
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "name": {
      +        "description": "Counterparty name to use for that row, from list_counterparties.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "kind",
      +      "locator",
      +      "name"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "centerName": {
      +        "description": "Responsibility center to use for that row, from list_responsibility_centers.",
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "kind": {
      +        "description": "Kind of reference this row fixes.",
      +        "enum": [
      +          "responsibilityCenter"
      +        ],
      +        "type": "string"
      +      },
      +      "locator": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "csv"
      +                ],
      +                "type": "string"
      +              },
      +              "lineNumber": {
      +                "description": "1-based line number in the CSV file.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "lineNumber"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "format": {
      +                "description": "Source file format.",
      +                "enum": [
      +                  "xlsx"
      +                ],
      +                "type": "string"
      +              },
      +              "rowNumber": {
      +                "description": "1-based row number within the sheet.",
      +                "maximum": 9007199254740991,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "sheetName": {
      +                "description": "Worksheet the row belongs to.",
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "format",
      +              "rowNumber",
      +              "sheetName"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "typeKey": {
      +        "description": "Responsibility center type the name belongs to, such as costCenter.",
      +        "minLength": 1,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "centerName",
      +      "kind",
      +      "locator",
      +      "typeKey"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / workspaceRef / description
      Added value: +"Workspace name or slug. Call list_workspaces, or find_workspaces when the user named one, to resolve it."
  6. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=false, destructiveHint=false, and idempotentHint=false, so the description adds real value by clarifying the preview/post split and the token-based guarantee that the file is unchanged. It does not say whether a post is all-or-nothing or discuss partial success, permissions, or rate limits, so it stops short of full behavioral disclosure.

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

Conciseness5/5

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

Two sentences, no filler, with the preview-first constraint front-loaded before the post instructions. Every clause carries operational weight.

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?

An output schema exists, so return values need not be explained, and annotations cover the mutability profile. The description covers the essential preview/post loop, but leaves 'blocking issue' and post atomicity undefined, which for a multi-megabyte file import is a modest gap.

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?

With 100% schema description coverage, the schema already documents action, previewToken, resolutions, and the rest in detail. The description reinforces the workflow linking contentBase64 + previewToken + resolutions for post, but adds little syntax or meaning beyond what the schema states, so baseline 3 applies.

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

Purpose5/5

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

States a specific verb pair (preview/post = import) and a precise resource: a complete CSV or XLSX file of balanced manual adjustment journals for one portfolio. Scope and format are explicit, so an agent knows this is the file-based bulk import rather than any single-transaction mutation among the siblings.

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

Usage Guidelines5/5

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

Explicit sequencing: preview first, post only after reviewing every blocking issue, and post must resend the unchanged source with its preview token and resolutions. This is effectively a when/when-not rule with the prerequisites for the mutating step spelled out.

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.

Resources