MCP YNAB Server
by klauern
_find_transaction_by_id
Find a transaction by its ID and ID type.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id_type | Yes | ||
| transaction_id | Yes | ||
| transactions | Yes |
Input Schema (JSON Schema)
{
"$defs": {
"SubTransaction": {
"description": "SubTransaction",
"properties": {
"amount": {
"description": "The subtransaction amount in milliunits format",
"title": "Amount",
"type": "integer"
},
"category_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category Id"
},
"category_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category Name"
},
"deleted": {
"description": "Whether or not the subtransaction has been deleted. Deleted subtransactions will only be included in delta requests.",
"title": "Deleted",
"type": "boolean"
},
"id": {
"title": "Id",
"type": "string"
},
"memo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Memo"
},
"payee_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payee Id"
},
"payee_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payee Name"
},
"transaction_id": {
"title": "Transaction Id",
"type": "string"
},
"transfer_account_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If a transfer, the account_id which the subtransaction transfers to",
"title": "Transfer Account Id"
},
"transfer_transaction_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If a transfer, the id of transaction on the other side of the transfer",
"title": "Transfer Transaction Id"
}
},
"required": [
"id",
"transaction_id",
"amount",
"deleted"
],
"title": "SubTransaction",
"type": "object"
},
"TransactionClearedStatus": {
"description": "The cleared status of the transaction",
"enum": [
"cleared",
"uncleared",
"reconciled"
],
"title": "TransactionClearedStatus",
"type": "string"
},
"TransactionDetail": {
"description": "TransactionDetail",
"properties": {
"account_id": {
"title": "Account Id",
"type": "string"
},
"account_name": {
"title": "Account Name",
"type": "string"
},
"amount": {
"description": "The transaction amount in milliunits format",
"title": "Amount",
"type": "integer"
},
"approved": {
"description": "Whether or not the transaction is approved",
"title": "Approved",
"type": "boolean"
},
"category_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Category Id"
},
"category_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The name of the category. If a split transaction, this will be 'Split'.",
"title": "Category Name"
},
"cleared": {
"$ref": "#/$defs/TransactionClearedStatus"
},
"date": {
"description": "The transaction date in ISO format (e.g. 2016-12-01)",
"format": "date",
"title": "Date",
"type": "string"
},
"debt_transaction_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If the transaction is a debt/loan account transaction, the type of transaction",
"title": "Debt Transaction Type"
},
"deleted": {
"description": "Whether or not the transaction has been deleted. Deleted transactions will only be included in delta requests.",
"title": "Deleted",
"type": "boolean"
},
"flag_color": {
"anyOf": [
{
"$ref": "#/$defs/TransactionFlagColor"
},
{
"type": "null"
}
],
"default": null
},
"flag_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The customized name of a transaction flag",
"title": "Flag Name"
},
"id": {
"title": "Id",
"type": "string"
},
"import_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If the transaction was imported, this field is a unique (by account) import identifier. If this transaction was imported through File Based Import or Direct Import and not through the API, the import_id will have the format: 'YNAB:[milliunit_amount]:[iso_date]:[occurrence]'. For example, a transaction dated 2015-12-30 in the amount of -$294.23 USD would have an import_id of 'YNAB:-294230:2015-12-30:1'. If a second transaction on the same account was imported and had the same date and same amount, its import_id would be 'YNAB:-294230:2015-12-30:2'.",
"title": "Import Id"
},
"import_payee_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If the transaction was imported, the payee name that was used when importing and before applying any payee rename rules",
"title": "Import Payee Name"
},
"import_payee_name_original": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If the transaction was imported, the original payee name as it appeared on the statement",
"title": "Import Payee Name Original"
},
"matched_transaction_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If transaction is matched, the id of the matched transaction",
"title": "Matched Transaction Id"
},
"memo": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Memo"
},
"payee_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payee Id"
},
"payee_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payee Name"
},
"subtransactions": {
"description": "If a split transaction, the subtransactions.",
"items": {
"$ref": "#/$defs/SubTransaction"
},
"title": "Subtransactions",
"type": "array"
},
"transfer_account_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If a transfer transaction, the account to which it transfers",
"title": "Transfer Account Id"
},
"transfer_transaction_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If a transfer transaction, the id of transaction on the other side of the transfer",
"title": "Transfer Transaction Id"
}
},
"required": [
"id",
"date",
"amount",
"cleared",
"approved",
"account_id",
"deleted",
"account_name",
"subtransactions"
],
"title": "TransactionDetail",
"type": "object"
},
"TransactionFlagColor": {
"description": "The transaction flag",
"enum": [
"red",
"orange",
"yellow",
"green",
"blue",
"purple"
],
"title": "TransactionFlagColor",
"type": "string"
}
},
"properties": {
"id_type": {
"title": "Id Type",
"type": "string"
},
"transaction_id": {
"title": "Transaction Id",
"type": "string"
},
"transactions": {
"items": {
"$ref": "#/$defs/TransactionDetail"
},
"title": "Transactions",
"type": "array"
}
},
"required": [
"transactions",
"transaction_id",
"id_type"
],
"title": "_find_transaction_by_idArguments",
"type": "object"
}