Skip to main content
Glama

Lovie Company Formation

Get Summary

transaction_get_summary
Read-only

Aggregate transactions into P&L groups (income/expenses) by a given dimension

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": {
      "filter": "<filter>"
    },
    "name": "transaction_get_summary"
  }
}

Input Schema

NameRequiredDescriptionDefault
scopeNo
filterYes
groupByNo
timeBucketNo

Output Schema

NameRequiredDescriptionDefault
netPlNo
groupsNo
totalIncomeNo
totalExpensesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / groupBy / enum
      Previous value: -[
      -  "PL_GROUP_BY_UNSPECIFIED",
      -  "PL_GROUP_BY_TYPE",
      -  "PL_GROUP_BY_COUNTERPARTY"
      -]New value: +[
      +  "PL_GROUP_BY_UNSPECIFIED",
      +  "PL_GROUP_BY_TYPE",
      +  "PL_GROUP_BY_COUNTERPARTY",
      +  "PL_GROUP_BY_CATEGORY",
      +  "PL_GROUP_BY_ACCOUNT",
      +  "PL_GROUP_BY_METHOD",
      +  "PL_GROUP_BY_SUBTYPE"
      +]
    • changedInput schema / properties / scope / enum
      Previous value: -[
      -  "SUMMARY_SCOPE_UNSPECIFIED",
      -  "SUMMARY_SCOPE_OPERATING",
      -  "SUMMARY_SCOPE_COMPANY_CASH"
      -]New value: +[
      +  "SUMMARY_SCOPE_UNSPECIFIED",
      +  "SUMMARY_SCOPE_OPERATING",
      +  "SUMMARY_SCOPE_COMPANY_CASH",
      +  "SUMMARY_SCOPE_ALL"
      +]
  2. Changed17 schema fields changed
    • removedInput schema / properties / fieldId
      Removed value: -{
      -  "description": "UUID value wrapper.",
      -  "properties": {
      -    "value": {
      -      "format": "uuid",
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
    • addedInput schema / properties / filter / properties / categories
      Added value: +{
      +  "items": {
      +    "properties": {
      +      "key": {
      +        "description": "Lowercase kebab-case code identifier.",
      +        "properties": {
      +          "value": {
      +            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "ownerKey": {
      +        "maxLength": 100,
      +        "pattern": "^[a-z0-9_-]*$",
      +        "type": "string"
      +      },
      +      "ownerType": {
      +        "enum": [
      +          "OWNER_TYPE_SYSTEM",
      +          "OWNER_TYPE_COMPANY",
      +          "OWNER_TYPE_INTEGRATION"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "key"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 500,
      +  "type": "array"
      +}
    • removedInput schema / properties / filter / properties / fieldFilters / items / properties / dateCondition
      Removed value: -{
      -  "properties": {
      -    "gte": {
      -      "maxLength": 10,
      -      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      -      "type": "string"
      -    },
      -    "lte": {
      -      "maxLength": 10,
      -      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
    • addedInput schema / properties / filter / properties / fieldFilters / items / properties / field
      Added value: +{
      +  "properties": {
      +    "coreColumn": {
      +      "maxLength": 100,
      +      "minLength": 1,
      +      "pattern": "^[A-Za-z][A-Za-z0-9_.-]*$",
      +      "type": "string"
      +    },
      +    "field": {
      +      "properties": {
      +        "key": {
      +          "description": "Lowercase kebab-case code identifier.",
      +          "properties": {
      +            "value": {
      +              "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "ownerKey": {
      +          "maxLength": 100,
      +          "pattern": "^[a-z0-9_-]*$",
      +          "type": "string"
      +        },
      +        "ownerType": {
      +          "enum": [
      +            "OWNER_TYPE_SYSTEM",
      +            "OWNER_TYPE_COMPANY",
      +            "OWNER_TYPE_INTEGRATION"
      +          ],
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "key"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
    • removedInput schema / properties / filter / properties / fieldFilters / items / properties / fieldId
      Removed value: -{
      -  "description": "UUID value wrapper.",
      -  "properties": {
      -    "value": {
      -      "format": "uuid",
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
    • removedInput schema / properties / filter / properties / fieldFilters / items / properties / numberCondition
      Removed value: -{
      -  "properties": {
      -    "gte": {
      -      "maxLength": 30,
      -      "pattern": "^-?[0-9]+(\\.[0-9]{1,4})?$",
      -      "type": "string"
      -    },
      -    "lte": {
      -      "maxLength": 30,
      -      "pattern": "^-?[0-9]+(\\.[0-9]{1,4})?$",
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
    • addedInput schema / properties / filter / properties / fieldFilters / items / properties / operator
      Added value: +{
      +  "enum": [
      +    "VIEW_FILTER_OPERATOR_EQUALS",
      +    "VIEW_FILTER_OPERATOR_NOT_EQUALS",
      +    "VIEW_FILTER_OPERATOR_CONTAINS",
      +    "VIEW_FILTER_OPERATOR_ANY_OF",
      +    "VIEW_FILTER_OPERATOR_NONE_OF",
      +    "VIEW_FILTER_OPERATOR_GREATER_OR_EQUAL",
      +    "VIEW_FILTER_OPERATOR_LESS_OR_EQUAL",
      +    "VIEW_FILTER_OPERATOR_IS_EMPTY",
      +    "VIEW_FILTER_OPERATOR_IS_NOT_EMPTY"
      +  ],
      +  "type": "string"
      +}
    • removedInput schema / properties / filter / properties / fieldFilters / items / properties / presenceCondition
      Removed value: -{
      -  "properties": {
      -    "hasValue": {
      -      "type": "boolean"
      -    }
      -  },
      -  "type": "object"
      -}
    • removedInput schema / properties / filter / properties / fieldFilters / items / properties / selectCondition
      Removed value: -{
      -  "properties": {
      -    "optionId": {
      -      "description": "UUID value wrapper.",
      -      "properties": {
      -        "value": {
      -          "format": "uuid",
      -          "type": "string"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "optionIds": {
      -      "items": {
      -        "description": "UUID value wrapper.",
      -        "properties": {
      -          "value": {
      -            "format": "uuid",
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "maxItems": 100,
      -      "type": "array"
      -    },
      -    "pathPrefix": {
      -      "maxLength": 1000,
      -      "pattern": "^([a-z0-9]+(-[a-z0-9]+)*(/[a-z0-9]+(-[a-z0-9]+)*)*)?$",
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
    • removedInput schema / properties / filter / properties / fieldFilters / items / properties / stringCondition
      Removed value: -{
      -  "properties": {
      -    "contains": {
      -      "maxLength": 1000,
      -      "pattern": "^[\\w\\s&,./():'\\-]*$",
      -      "type": "string"
      -    },
      -    "eq": {
      -      "maxLength": 1000,
      -      "pattern": "^[\\w\\s&,./():'\\-]*$",
      -      "type": "string"
      -    }
      -  },
      -  "type": "object"
      -}
    • addedInput schema / properties / filter / properties / fieldFilters / items / properties / values
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 100,
      +  "type": "array"
      +}
    • changedInput schema / properties / filter / properties / fieldFilters / items / required
      Previous value: -[
      -  "fieldId"
      -]New value: +[
      +  "field"
      +]
    • changedInput schema / properties / filter / properties / fieldFilters / maxItems
      Previous value: -10New value: +20
    • removedInput schema / properties / filter / properties / relatedFieldFilters
      Removed value: -{
      -  "items": {
      -    "properties": {
      -      "datatableCode": {
      -        "description": "Lowercase kebab-case code identifier.",
      -        "properties": {
      -          "value": {
      -            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "fieldId": {
      -        "description": "UUID value wrapper.",
      -        "properties": {
      -          "value": {
      -            "format": "uuid",
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "optionId": {
      -        "description": "UUID value wrapper.",
      -        "properties": {
      -          "value": {
      -            "format": "uuid",
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      },
      -      "stringCondition": {
      -        "properties": {
      -          "contains": {
      -            "maxLength": 1000,
      -            "pattern": "^[\\w\\s&,./():'\\-]*$",
      -            "type": "string"
      -          },
      -          "eq": {
      -            "maxLength": 1000,
      -            "pattern": "^[\\w\\s&,./():'\\-]*$",
      -            "type": "string"
      -          }
      -        },
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "datatableCode",
      -      "fieldId"
      -    ],
      -    "type": "object"
      -  },
      -  "maxItems": 5,
      -  "type": "array"
      -}
    • changedInput schema / properties / filter / properties / statuses / items / enum
      Previous value: -[
      -  "TRANSACTION_STATUS_UNSPECIFIED",
      -  "TRANSACTION_STATUS_PENDING",
      -  "TRANSACTION_STATUS_POSTED",
      -  "TRANSACTION_STATUS_CANCELLED",
      -  "TRANSACTION_STATUS_FAILED",
      -  "TRANSACTION_STATUS_REVERSED",
      -  "TRANSACTION_STATUS_REMOVED",
      -  "TRANSACTION_STATUS_DECLINED"
      -]New value: +[
      +  "TRANSACTION_STATUS_UNSPECIFIED",
      +  "TRANSACTION_STATUS_PENDING",
      +  "TRANSACTION_STATUS_POSTED",
      +  "TRANSACTION_STATUS_CANCELLED",
      +  "TRANSACTION_STATUS_FAILED",
      +  "TRANSACTION_STATUS_REVERSED",
      +  "TRANSACTION_STATUS_REMOVED",
      +  "TRANSACTION_STATUS_DECLINED",
      +  "TRANSACTION_STATUS_RETURNED",
      +  "TRANSACTION_STATUS_REJECTED"
      +]
    • changedInput schema / properties / groupBy / enum
      Previous value: -[
      -  "PL_GROUP_BY_UNSPECIFIED",
      -  "PL_GROUP_BY_TYPE",
      -  "PL_GROUP_BY_COUNTERPARTY",
      -  "PL_GROUP_BY_FIELD"
      -]New value: +[
      +  "PL_GROUP_BY_UNSPECIFIED",
      +  "PL_GROUP_BY_TYPE",
      +  "PL_GROUP_BY_COUNTERPARTY"
      +]
    • changedInput schema / properties / timeBucket / enum
      Previous value: -[
      -  "TIME_BUCKET_UNSPECIFIED",
      -  "TIME_BUCKET_MONTH"
      -]New value: +[
      +  "TIME_BUCKET_UNSPECIFIED",
      +  "TIME_BUCKET_MONTH",
      +  "TIME_BUCKET_DAY"
      +]
  3. Changed2 schema fields changed
    • addedInput schema / properties / filter / properties / includeCheckoutPlaceholders
      Added value: +{
      +  "type": "boolean"
      +}
    • changedInput schema / properties / filter / properties / providers / items / enum
      Previous value: -[
      -  "TRANSACTION_PROVIDER_UNSPECIFIED",
      -  "TRANSACTION_PROVIDER_PLAID",
      -  "TRANSACTION_PROVIDER_MX",
      -  "TRANSACTION_PROVIDER_YODLEE",
      -  "TRANSACTION_PROVIDER_TELLER",
      -  "TRANSACTION_PROVIDER_MANUAL",
      -  "TRANSACTION_PROVIDER_OTHER",
      -  "TRANSACTION_PROVIDER_INCREASE"
      -]New value: +[
      +  "TRANSACTION_PROVIDER_UNSPECIFIED",
      +  "TRANSACTION_PROVIDER_PLAID",
      +  "TRANSACTION_PROVIDER_MX",
      +  "TRANSACTION_PROVIDER_YODLEE",
      +  "TRANSACTION_PROVIDER_TELLER",
      +  "TRANSACTION_PROVIDER_MANUAL",
      +  "TRANSACTION_PROVIDER_OTHER",
      +  "TRANSACTION_PROVIDER_INCREASE",
      +  "TRANSACTION_PROVIDER_EXTENSION"
      +]
  4. Changed1 schema field changed
    • changedInput schema / properties / filter / properties / transactionSubtypes / items / enum
      Previous value: -[
      -  "TRANSACTION_SUBTYPE_UNSPECIFIED",
      -  "TRANSACTION_SUBTYPE_EXTERNAL",
      -  "TRANSACTION_SUBTYPE_INTERNAL",
      -  "TRANSACTION_SUBTYPE_TREASURY",
      -  "TRANSACTION_SUBTYPE_EXPENSE_REIMBURSEMENT",
      -  "TRANSACTION_SUBTYPE_ACH",
      -  "TRANSACTION_SUBTYPE_CREDIT_CARD",
      -  "TRANSACTION_SUBTYPE_DEBIT_CARD",
      -  "TRANSACTION_SUBTYPE_DOMESTIC",
      -  "TRANSACTION_SUBTYPE_INTERNATIONAL",
      -  "TRANSACTION_SUBTYPE_WIRE_FEE",
      -  "TRANSACTION_SUBTYPE_SUBSCRIPTION_FEE",
      -  "TRANSACTION_SUBTYPE_INTL_TRANSACTION_FEE",
      -  "TRANSACTION_SUBTYPE_CREDIT_CARD_CREDIT",
      -  "TRANSACTION_SUBTYPE_DEBIT_CARD_CREDIT",
      -  "TRANSACTION_SUBTYPE_FEE_REBATE",
      -  "TRANSACTION_SUBTYPE_FEE_REVERSAL",
      -  "TRANSACTION_SUBTYPE_RTP",
      -  "TRANSACTION_SUBTYPE_FEDNOW",
      -  "TRANSACTION_SUBTYPE_BOOK"
      -]New value: +[
      +  "TRANSACTION_SUBTYPE_UNSPECIFIED",
      +  "TRANSACTION_SUBTYPE_EXTERNAL",
      +  "TRANSACTION_SUBTYPE_INTERNAL",
      +  "TRANSACTION_SUBTYPE_TREASURY",
      +  "TRANSACTION_SUBTYPE_EXPENSE_REIMBURSEMENT",
      +  "TRANSACTION_SUBTYPE_ACH",
      +  "TRANSACTION_SUBTYPE_CREDIT_CARD",
      +  "TRANSACTION_SUBTYPE_DEBIT_CARD",
      +  "TRANSACTION_SUBTYPE_DOMESTIC",
      +  "TRANSACTION_SUBTYPE_INTERNATIONAL",
      +  "TRANSACTION_SUBTYPE_WIRE_FEE",
      +  "TRANSACTION_SUBTYPE_SUBSCRIPTION_FEE",
      +  "TRANSACTION_SUBTYPE_INTL_TRANSACTION_FEE",
      +  "TRANSACTION_SUBTYPE_CREDIT_CARD_CREDIT",
      +  "TRANSACTION_SUBTYPE_DEBIT_CARD_CREDIT",
      +  "TRANSACTION_SUBTYPE_FEE_REBATE",
      +  "TRANSACTION_SUBTYPE_FEE_REVERSAL",
      +  "TRANSACTION_SUBTYPE_RTP",
      +  "TRANSACTION_SUBTYPE_FEDNOW",
      +  "TRANSACTION_SUBTYPE_BOOK",
      +  "TRANSACTION_SUBTYPE_ACH_SAME_DAY"
      +]
  5. Changed1 schema field changed
    • addedInput schema / properties / filter / properties / excludeOwnAccountTransfers
      Added value: +{
      +  "type": "boolean"
      +}
  6. Changed10 schema fields changed
    • addedInput schema / properties / filter / properties / counterpartyNameContainsAny
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 10,
      +  "type": "array"
      +}
    • addedInput schema / properties / filter / properties / fieldFilters / items / properties / presenceCondition
      Added value: +{
      +  "properties": {
      +    "hasValue": {
      +      "type": "boolean"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / filter / properties / needsReview
      Added value: +{
      +  "type": "boolean"
      +}
    • changedInput schema / properties / filter / properties / statuses / items / enum
      Previous value: -[
      -  "TRANSACTION_STATUS_UNSPECIFIED",
      -  "TRANSACTION_STATUS_PENDING",
      -  "TRANSACTION_STATUS_POSTED",
      -  "TRANSACTION_STATUS_CANCELLED",
      -  "TRANSACTION_STATUS_FAILED",
      -  "TRANSACTION_STATUS_REVERSED",
      -  "TRANSACTION_STATUS_REMOVED"
      -]New value: +[
      +  "TRANSACTION_STATUS_UNSPECIFIED",
      +  "TRANSACTION_STATUS_PENDING",
      +  "TRANSACTION_STATUS_POSTED",
      +  "TRANSACTION_STATUS_CANCELLED",
      +  "TRANSACTION_STATUS_FAILED",
      +  "TRANSACTION_STATUS_REVERSED",
      +  "TRANSACTION_STATUS_REMOVED",
      +  "TRANSACTION_STATUS_DECLINED"
      +]
    • changedInput schema / properties / filter / properties / transactionSubtypes / items / enum
      Previous value: -[
      -  "TRANSACTION_SUBTYPE_UNSPECIFIED",
      -  "TRANSACTION_SUBTYPE_EXTERNAL",
      -  "TRANSACTION_SUBTYPE_INTERNAL",
      -  "TRANSACTION_SUBTYPE_TREASURY",
      -  "TRANSACTION_SUBTYPE_EXPENSE_REIMBURSEMENT",
      -  "TRANSACTION_SUBTYPE_ACH",
      -  "TRANSACTION_SUBTYPE_CREDIT_CARD",
      -  "TRANSACTION_SUBTYPE_DEBIT_CARD",
      -  "TRANSACTION_SUBTYPE_DOMESTIC",
      -  "TRANSACTION_SUBTYPE_INTERNATIONAL",
      -  "TRANSACTION_SUBTYPE_WIRE_FEE",
      -  "TRANSACTION_SUBTYPE_SUBSCRIPTION_FEE",
      -  "TRANSACTION_SUBTYPE_INTL_TRANSACTION_FEE",
      -  "TRANSACTION_SUBTYPE_CREDIT_CARD_CREDIT",
      -  "TRANSACTION_SUBTYPE_DEBIT_CARD_CREDIT",
      -  "TRANSACTION_SUBTYPE_FEE_REBATE",
      -  "TRANSACTION_SUBTYPE_FEE_REVERSAL"
      -]New value: +[
      +  "TRANSACTION_SUBTYPE_UNSPECIFIED",
      +  "TRANSACTION_SUBTYPE_EXTERNAL",
      +  "TRANSACTION_SUBTYPE_INTERNAL",
      +  "TRANSACTION_SUBTYPE_TREASURY",
      +  "TRANSACTION_SUBTYPE_EXPENSE_REIMBURSEMENT",
      +  "TRANSACTION_SUBTYPE_ACH",
      +  "TRANSACTION_SUBTYPE_CREDIT_CARD",
      +  "TRANSACTION_SUBTYPE_DEBIT_CARD",
      +  "TRANSACTION_SUBTYPE_DOMESTIC",
      +  "TRANSACTION_SUBTYPE_INTERNATIONAL",
      +  "TRANSACTION_SUBTYPE_WIRE_FEE",
      +  "TRANSACTION_SUBTYPE_SUBSCRIPTION_FEE",
      +  "TRANSACTION_SUBTYPE_INTL_TRANSACTION_FEE",
      +  "TRANSACTION_SUBTYPE_CREDIT_CARD_CREDIT",
      +  "TRANSACTION_SUBTYPE_DEBIT_CARD_CREDIT",
      +  "TRANSACTION_SUBTYPE_FEE_REBATE",
      +  "TRANSACTION_SUBTYPE_FEE_REVERSAL",
      +  "TRANSACTION_SUBTYPE_RTP",
      +  "TRANSACTION_SUBTYPE_FEDNOW",
      +  "TRANSACTION_SUBTYPE_BOOK"
      +]
    • changedInput schema / properties / filter / properties / transactionTypes / items / enum
      Previous value: -[
      -  "TRANSACTION_TYPE_UNSPECIFIED",
      -  "TRANSACTION_TYPE_TRANSFER",
      -  "TRANSACTION_TYPE_PAYMENT",
      -  "TRANSACTION_TYPE_CARD",
      -  "TRANSACTION_TYPE_WIRE",
      -  "TRANSACTION_TYPE_CHECK",
      -  "TRANSACTION_TYPE_FEE",
      -  "TRANSACTION_TYPE_REFUND",
      -  "TRANSACTION_TYPE_INTEREST",
      -  "TRANSACTION_TYPE_ATM",
      -  "TRANSACTION_TYPE_OTHER"
      -]New value: +[
      +  "TRANSACTION_TYPE_UNSPECIFIED",
      +  "TRANSACTION_TYPE_TRANSFER",
      +  "TRANSACTION_TYPE_PAYMENT",
      +  "TRANSACTION_TYPE_CARD",
      +  "TRANSACTION_TYPE_WIRE",
      +  "TRANSACTION_TYPE_FEE",
      +  "TRANSACTION_TYPE_REFUND",
      +  "TRANSACTION_TYPE_INTEREST",
      +  "TRANSACTION_TYPE_ATM",
      +  "TRANSACTION_TYPE_OTHER"
      +]
    • addedInput schema / properties / filter / properties / transferIds
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "maxItems": 100,
      +  "type": "array"
      +}
    • addedInput schema / properties / scope
      Added value: +{
      +  "enum": [
      +    "SUMMARY_SCOPE_UNSPECIFIED",
      +    "SUMMARY_SCOPE_OPERATING",
      +    "SUMMARY_SCOPE_COMPANY_CASH"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / timeBucket
      Added value: +{
      +  "enum": [
      +    "TIME_BUCKET_UNSPECIFIED",
      +    "TIME_BUCKET_MONTH"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / groups / items / properties / period
      Added value: +{
      +  "type": "string"
      +}
  7. First observed

TDQS

C2.7/5.0
Behavior2/5

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

Annotations already declare readOnlyHint, destructiveHint=false and openWorldHint=false, so safety is covered. Beyond that the description says nothing about how aggregation behaves: whether results are bucketed only when timeBucket is set, whether unfiltered aggregation is expensive, or how scope changes which accounts are counted.

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?

One front-loaded sentence with no filler and no repetition of the title. Brevity here works against it only in that nothing is left to spare for the parameters.

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

Completeness2/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 described. But for a tool with four parameters, three enums and a 30-plus-field nested filter, the description leaves the agent without the semantics of scope, groupBy and timeBucket, which directly determine the result.

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

Parameters2/5

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

Schema description coverage is 0% across a deeply nested filter plus three enums (scope, groupBy, timeBucket), so the description carried the full burden. 'By a given dimension' vaguely gestures at groupBy but never explains any enum value, the scope semantics, or the filter's date/amount bounds. It does not compensate for the coverage gap.

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?

States a specific verb (aggregate), the resource (transactions), the output shape (P&L groups split into income/expenses) and the grouping dimension. That is enough to distinguish it from transaction_get_transaction and the list_* siblings. It stops short of naming any sibling explicitly, so not a 5.

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

Usage Guidelines2/5

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

No statement of when to use this over listing transactions and summing client-side, no mention of the three scope modes, and no indication of when timeBucket bucketing matters. The agent must infer usage entirely from the name.

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.