Lists loan contracts per bank connection (GET /loans). Pass items as an array of connection selectors (item_id uuid, connector_id, or connector_name) — one entry per connection to fetch; multiple connections are queried sequentially with rate-limit spacing. OMIT items to list loans across ALL linked banks. Returns { results, errors } per connection.
| Name | Required | Description | Default |
|---|---|---|---|
| items | No |
Changes observed during successful MCP inspections. Dates show when Glama detected each change.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, non-destructive. Description adds sequential querying with rate limiting and response format {results, errors}, which are behavioral traits beyond annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, no wasted words. Front-loaded with purpose, then explains parameter and behavior. Efficient and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema, the description still explains the return shape. Covers input modes and behavior. Sufficient for tool selection among similar siblings.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema has 0% description coverage, but the description thoroughly explains the 'items' parameter: its type (array of connection selectors), valid values (uuid, connector_id, connector_name), and behavior when omitted. Fully compensates for missing schema descriptions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Explicitly states 'Lists loan contracts per bank connection (GET /loans)', clearly identifying the resource and verb. Distinguishes between two usage modes (with items array or without), making it distinct from siblings like get_loan_detail.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides clear guidance on when to use each mode: pass items for specific connections, omit for all. Mentions rate-limit spacing for multiple connections. Could explicitly mention alternatives for single loan details, but still strong.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
Most openfinance_* tools map cleanly to distinct resources and actions, and the list/get split is readable. The main risk is openfinance_list_transactions vs openfinance_list_transactions_by_item, which both return transactions and could be confused; openfinance_get_item_status vs openfinance_provider_status also sound similar, though descriptions clarify them.
The openfinance_* family follows a consistent openfinance_<verb>_<noun> pattern, and platform tools mostly use simple verb_noun names. Deviations include openfinance_list_transactions_by_item, which breaks the noun pattern, and the non-prefixed platform tools (authenticate, connect, marketplace) mixing in a second naming category.
At 25 tools, this is at the high end of reasonable scope. The open finance data surface is genuinely broad, so most tools earn their place, but the marketplace/platform tools effectively add a second unrelated domain and push the set toward heavy.
The open finance lifecycle is well covered: connection search, sync, status, disconnect, accounts, balances, transactions, credit card bills, loans, investments, and category correction. Minor gaps exist (no single-transaction fetch, no connection update beyond force_sync), but core agent workflows do not hit dead ends.