Skip to main content
Glama

Juicyway by Nova (CIVAI)

Server Details

Manage your Juicyway business account from chat: check balances and movements, send bank payouts, v…

Ownership verified
Status
Healthy
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL

TDQS

C2.1/5.0

Scored across 21 tools

Disambiguation2/5

Several tools overlap heavily: bank_transfer and create_payout both cover payouts/transfers; list_deposit_accounts and view_deposit_accounts appear to do the same thing; view_money_movements and list_ngn_money_movements_and_overdraft_data are hard to distinguish; and multiple referral/balance tools overlap. Most descriptions are generic 'Run the X pipeline' text, so they do not resolve the ambiguity.

Naming Consistency3/5

All names use snake_case, but verb conventions are mixed: create_/fetch_/get_/list_/view_ plus noun-only names like bank_transfer and session_status. The pattern is readable but not predictable enough for a clean verb_noun convention.

Tool Count3/5

21 tools is on the heavy side for this domain, and several appear redundant (list vs view deposit accounts, multiple referral/balance tools). The breadth is plausible for a fintech platform, but the set feels bloated rather than tightly scoped.

Completeness3/5

The surface covers auth, KYC, profile, banks, beneficiaries, payouts, deposits, exchange, referrals, and money movements. However, lifecycle gaps are notable: there is no clear payout status/cancel/list tool, no beneficiary creation, and no exchange order creation despite listing exchange orders.

Available Tools

21 tools
bank_transferDInspect

Bank transfer / payout flow for Juicyway.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.7/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden. For a tool that appears to move money, it says nothing about auth requirements, irreversibility, whether funds actually transfer, or what the 'flow' entails — leaving the agent unable to judge the risk of invoking it.

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

Conciseness2/5

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

It is short, but that brevity is under-specification rather than economy — five words convey almost no actionable content for a money-movement tool.

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

Completeness1/5

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

A payout/transfer tool with no annotations, no output schema, no parameter commentary, and no usage guidance is far too thin; an agent cannot safely or correctly invoke it from this definition.

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

Parameters3/5

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

Schema coverage is 100% and the single parameter's fallback-message purpose is fully documented in the schema. The description adds nothing, but the schema baseline justifies a 3.

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

Purpose2/5

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

The description 'Bank transfer / payout flow for Juicyway' names a domain but no concrete action — it is unclear whether it initiates a transfer, returns instructions, or is a multi-step entrypoint. It also does not distinguish itself from the sibling create_payout, which clearly names a payout operation.

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

Usage Guidelines1/5

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

There is no guidance on when to call this versus create_payout or list_bank_beneficiaries, no prerequisites, and no exclusions. An agent has no basis to route between this tool and its near-identical siblings.

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

create_payoutBInspect

Create a bank payout/transfer. Prefill beneficiary from session when possible. Always emit_display preview before running.

NameRequiredDescriptionDefault
step_40_body_pinNoTransaction PIN
step_40_body_amountYesPayout amount in smallest currency unit (e.g. kobo)
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.
step_40_body_descriptionNoTransfer narration/description
step_32_body_data_48_account_numberNoDestination bank account number

TDQS

B3.3/5.0
Behavior3/5

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

With no annotations, the description carries the full burden, and it does add one non-obvious safety behavior: a required preview step via emit_display before execution. It fails to state whether the call itself moves money irreversibly, whether a PIN is required at execution, or what error/rollback behavior looks like for a high-stakes financial mutation.

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?

Three short sentences, front-loaded with the purpose, then prefill guidance, then the mandatory preview constraint. Nothing is padded, though "when possible" is slightly vague about the fallback path.

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?

This is a money-movement tool with no annotations and no output schema, so the description must do more. It references `emit_display`, which does not appear in the sibling tool list and is never explained (is it a separate tool? a flag?), and omits required prerequisites, PIN timing, and confirmation of what a successful call returns.

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

Parameters3/5

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

Schema description coverage is 100%, so the schema already documents all five parameters including amount units and PIN. The only added meaning is that the beneficiary account number can be prefilled from session, which is marginal beyond the schema baseline.

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?

Specific verb+resource ("Create a bank payout/transfer") tells an agent this moves money to a bank account. However, the phrase "payout/transfer" overlaps with the sibling tool `bank_transfer`, and the description never distinguishes the two, leaving the agent to guess which one to call.

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

Usage Guidelines3/5

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

"Always emit_display preview before running" gives a real procedural precondition, and prefill guidance is stated. But there is no when-to-use vs `bank_transfer`, no mention of prerequisites (KYC status, resolved beneficiary via `resolve_bank_account`), and no exclusions.

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

fetch_kyc_statusDInspect

Run the fetch_kyc_status pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.7/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden of disclosure, yet it says nothing about whether this is a read or write operation, what permissions/auth are required, whether it has side effects, or what it returns. For a KYC pipeline tool with zero annotation coverage, this is a total gap.

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

Conciseness2/5

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

The single sentence is short but under-specified rather than concise — it contains no substance to front-load. Size is proportionally far too small for the behavioral and semantic gaps it leaves.

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

Completeness1/5

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

With no annotations, no output schema, and a description that explains nothing, an agent cannot know what the tool returns, whether it is safe to call, or what result to expect. For a KYC status pipeline this is completely inadequate.

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

Parameters3/5

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

Schema coverage is 100%, and the single parameter (notification_message) is fully documented in the schema, including its 'plain text only' constraint. The description adds nothing about the parameter, but the baseline of 3 applies when the schema already does the heavy lifting.

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

Purpose2/5

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

The description restates the tool name (fetch_kyc_status) in pipeline form, adding no information about what KYC status means, whose status is fetched, or what the pipeline does. It is essentially a tautology of the name, though its verb+resource pairing inherits some minimal clarity from the name itself.

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

Usage Guidelines1/5

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

There is no indication of when this tool should be used, what prerequisites exist, or how it relates to any of the 20 sibling tools (e.g., fetch_user_profile, session_status). An agent has no basis for choosing this over alternatives.

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

fetch_payout_charge_infoDInspect

Run the fetch_payout_charge_info pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.8/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden, yet it discloses nothing: not whether the call is read-only, what "pipeline" entails, whether it has side effects, what permissions are needed, or what it returns. The only hint of read semantics comes from the word "fetch" in the name, not the description.

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

Conciseness2/5

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

One short sentence, so it is not bloated, but conciseness only helps when the content is substantive. Here the brevity is a symptom of under-specification rather than efficiency.

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?

With no annotations, no output schema, and no explanation of the "pipeline" concept, the definition leaves an agent unable to confidently invoke the tool or anticipate results. A single-parameter tool still needs at least a statement of what is fetched.

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

Parameters3/5

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

Schema description coverage is 100% for the single optional notification_message parameter, so the schema already explains its purpose and constraints. The description adds nothing about parameters, which is acceptable given full schema coverage, but it also fails to explain why a notification message accompanies a fetch operation.

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

Purpose2/5

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

"Run the fetch_payout_charge_info pipeline" restates the tool name without saying what the tool actually retrieves or does. It adds no verb or resource detail beyond the name itself, so an agent learns nothing it could not infer from the identifier.

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

Usage Guidelines1/5

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

No indication of when to use this tool, when not to, or which sibling (e.g. list_ngn_money_movements_and_overdraft_data, view_money_movements) covers adjacent needs. The agent must guess the selection criteria entirely.

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

fetch_user_profileDInspect

Run the fetch_user_profile pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.9/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full behavioral burden, yet it discloses nothing: not whether it is a read or a mutation, not permissions or auth prerequisites, not side effects, not what the "pipeline" does internally. The word "pipeline" actively obscures rather than clarifies.

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

Conciseness2/5

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

One short sentence with zero waste, but that is under-specification masquerading as conciseness — nothing is front-loaded because there is nothing to front-load. Brevity here costs the agent all actionable information.

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

Completeness1/5

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

With no annotations and no output schema, the description is the only source of behavioral and return-value context, and it provides none. For a tool whose name implies retrieving user profile data, failing to say what data comes back leaves the definition unusable for correct invocation.

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?

The single parameter has 100% schema description coverage, so the baseline is 3 per the rubric. The description adds nothing about notification_message, but the schema already explains it fully as a fallback user-facing sentence.

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

Purpose2/5

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

"Run the fetch_user_profile pipeline" restates the tool name without adding a verb/resource distinction an agent could act on — it says nothing about whose profile is fetched, what it returns, or how it differs from siblings like fetch_kyc_status or session_status. Tautological rather than clarifying.

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 when-to-use guidance, no exclusions, and no reference to any of the 19 sibling tools that plausibly overlap (fetch_kyc_status, session_status, get_additional_referrals_and_balances). An agent has no basis for choosing this tool over alternatives.

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

get_additional_referrals_and_balancesDInspect

Run the get_additional_referrals_and_balances pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.7/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure, yet it discloses nothing: not whether the call is read-only or mutating, whether it requires auth, what side effects or costs it incurs, or what the pipeline returns. An agent cannot predict the outcome of calling it.

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

Conciseness2/5

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

The single sentence is short but that brevity comes from under-specification rather than efficiency; there is no front-loaded statement of what the tool returns or when to invoke it. Every useful detail is absent.

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

Completeness1/5

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

With no annotations, no output schema, and a description that only names the pipeline, an agent has no information needed to invoke this correctly or interpret its result. Given the density of overlapping referral/balance siblings, this is materially inadequate.

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?

There is a single optional parameter, notification_message, and the schema documents it at 100% coverage, including its fallback-purpose and plain-text constraint. The description adds nothing about the parameter, but the baseline is 3 when the schema already does the explanatory work.

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

Purpose2/5

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

The description restates the tool name with the generic verb 'Run' and adds no information about what the pipeline does, what data it touches, or what kind of result it returns. It is a tautology rather than a statement of purpose, and it gives no basis to distinguish it from siblings such as get_referrals_and_overdrafts_balance or view_referrals.

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

Usage Guidelines1/5

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

There is no indication of when to use this tool, when not to, or which sibling to prefer. The sibling list contains at least three closely related referral/balance tools, and the description offers nothing to route an agent between them.

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

get_exchange_quote_adaDInspect

Run the get_exchange_quote_ada pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.7/5.0
Behavior1/5

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

No annotations are provided and the description carries the full burden of disclosure, but it says nothing about side effects, authentication, rate limits, or what the pipeline does. "Run the pipeline" leaves the agent completely blind to behavior.

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

Conciseness2/5

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

The single sentence has no waste but is severely under-specified rather than concise. There is no useful information front-loaded for the agent to act on.

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

Completeness1/5

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

With no annotations, no output schema, and a description that only repeats the tool name, an agent has essentially no basis for correct invocation. The only documented aspect is the notification_message parameter, which the schema already covers.

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?

The single parameter has 100% schema description coverage, including a clear explanation of the notification_message fallback semantics. The description adds nothing beyond the schema, so baseline 3 applies.

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

Purpose2/5

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

The description restates the tool name as a "pipeline", which is essentially tautology. It conveys no verb+resource specificity and gives no hint of what an ADA exchange quote actually is or how it differs from siblings like view_exchange_market_usd_ngn.

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

Usage Guidelines1/5

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

There is no when-to-use guidance, no prerequisites, and no mention of any alternative. An agent cannot infer from this sentence when it should pick this tool over view_exchange_market_usd_ngn or list_exchange_orders.

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

get_referrals_and_overdrafts_balanceDInspect

Run the get_referrals_and_overdrafts_balance pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.7/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden, and it discloses nothing: not whether this is a read or a write, whether calling it has side effects ("run a pipeline" could imply processing work), nor whether it requires auth. For a tool whose name suggests fetching a balance, the absence of any indication of cost or consequences is a serious gap.

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

Conciseness2/5

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

It is one short sentence, but it is under-specified rather than concise: it is front-loaded with a restatement of the name and carries no information an agent could act on. Brevity here stems from omission, not economy.

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

Completeness1/5

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

There are no annotations and no output schema, so the description must supply safety profile, expected return, and usage context — it supplies none of these. An agent cannot tell whether this is a safe read or a state-changing operation, nor what it gets back.

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

Parameters3/5

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

Schema description coverage is 100% — the single optional notification_message parameter is fully documented in the schema. The description adds nothing about the parameter, but per the baseline rule for high coverage, 3 is the correct score.

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

Purpose2/5

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

"Run the get_referrals_and_overdrafts_balance pipeline" only restates the tool name in other words; the verb "run" and noun "pipeline" add no resource or outcome information. There is no differentiation from siblings like view_referrals, get_additional_referrals_and_balances, or list_ngn_money_movements_and_overdraft_data, which plausibly overlap in scope.

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

Usage Guidelines1/5

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

No when-to-use, when-not-to-use, or prerequisite information is given. An agent facing view_referrals, get_additional_referrals_and_balances, and this tool has no basis in the description for choosing among them.

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

get_supported_banksCInspect

Run the get_supported_banks pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

C2/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full behavioral burden, and it discloses nothing: not whether the call is a safe read, not what the response contains, not whether the optional notification_message triggers a fallback message on failure. The only hint about that fallback lives in the schema, not the description.

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

Conciseness2/5

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

One sentence with no waste, but it is under-specified rather than concise — the brevity comes from saying nothing, not from tight editing.

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?

The tool has zero required parameters and no output schema, so the description would need to explain what the bank list looks like and its role in the payout/bank-transfer family. It supplies none of that, leaving an agent with a name and no contract.

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?

The single parameter has full schema description coverage (100%) explaining its plain-text, no-template-syntax constraint, so the schema does the work. The description adds no meaning about when the follow-up reply would fail or how the message surfaces, which is the baseline-3 outcome for high-coverage schemas.

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

Purpose2/5

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

"Run the get_supported_banks pipeline" restates the tool name and adds the word "pipeline" instead of describing an outcome. It never says what a supported bank is, what is returned, or how it differs from siblings like list_bank_beneficiaries or resolve_bank_account.

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 when-to-use, when-not-to-use, or alternative is named. An agent cannot tell whether this is a prerequisite for bank_transfer/create_payout or a standalone lookup, and no prerequisites or ordering are given.

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

list_bank_beneficiariesDInspect

Run the list_bank_beneficiaries pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.9/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full behavioral burden, yet it discloses nothing about whether the call is a read, whether it requires auth, whether results are paginated, or what the response contains. The single sentence 'Run the ... pipeline' communicates no behavioral traits at all.

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

Conciseness2/5

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

The sentence is short but that brevity reflects under-specification rather than economy; there is no front-loaded statement of purpose or outcome. Nothing in it earns its place beyond the tool name.

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

Completeness1/5

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

With no annotations, no output schema, and no information about the return payload, ordering, or scope, the description is completely inadequate for an agent to call this tool confidently. It leaves the agent unable to predict what comes back.

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

Parameters3/5

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

Schema description coverage is 100%, so the single parameter notification_message is already documented in the schema, including its plain-text constraint. The description adds nothing about it, but per the high-coverage baseline a 3 is appropriate.

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

Purpose2/5

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

The description restates the tool name as a 'pipeline' without saying what the tool actually returns or what a 'bank beneficiary' is. It is essentially a tautology, adding no verb+resource specificity beyond what the name already conveys.

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?

There is no statement of when to use this tool, when not to, or how it relates to siblings like resolve_bank_account or bank_transfer. The agent must infer from the name alone that this is the listing counterpart to those tools.

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

list_deposit_accountsDInspect

Run the list_deposit_accounts pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.8/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden and delivers nothing: it does not say whether this is a read or a write, whether it is idempotent, what happens on failure, or what the "pipeline" involves. The word "pipeline" actively obscures the operation rather than describing it.

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

Conciseness2/5

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

One short sentence is concise in raw length, but it is under-specification rather than conciseness: the only content is a restatement of the name, so no information is front-loaded because there is no information.

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?

With no annotations, no output schema, and a vague description, an agent cannot tell what the call returns or when it should be preferred over view_deposit_accounts. There is no output schema to compensate, so the description needed to do more and does not.

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

Parameters3/5

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

Schema coverage is 100% and the single param notification_message is well documented in the schema, including the fallback-reply context. Baseline 3 applies since the description adds nothing, but the schema itself leaves little ambiguity.

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

Purpose2/5

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

"Run the list_deposit_accounts pipeline" restates the tool name with the opaque word "pipeline" and never says what the tool actually does or returns (a list of deposit accounts, presumably). It gives no signal distinguishing it from the sibling view_deposit_accounts, which an agent would reasonably read as the same capability.

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

Usage Guidelines1/5

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

There is no when-to-use guidance, no exclusions, and no acknowledgment that view_deposit_accounts exists as an apparent alternative. The agent is left to guess between two similarly named siblings with no basis for choosing.

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

list_exchange_ordersCInspect

Run the list_exchange_orders pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

C2.2/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden, yet it discloses nothing: no auth prerequisites, no read-only confirmation (only weakly implied by "list"), no pagination or result-volume behavior, no failure modes. "Pipeline" hints at orchestration without explaining what the pipeline does or returns.

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

Conciseness2/5

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

It is short, but the brevity comes from under-specification rather than efficiency — the single sentence conveys no information beyond the tool name. There is nothing front-loaded because there is nothing to load.

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?

With one optional parameter the tool is structurally simple, but the description supplies none of the context an agent needs: what an exchange order is, what a result set looks like, or the role of the notification_message fallback. No output schema exists, so the description should at least indicate the return content.

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

Parameters3/5

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

Schema description coverage is 100% and the single parameter (notification_message) is fully documented in the schema, so the baseline of 3 applies even though the description adds nothing. The description does not explain why a listing tool needs a fallback user-facing message, which would have been the one place to add value.

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

Purpose2/5

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

"Run the list_exchange_orders pipeline" essentially restates the tool name and adds the undefined term "pipeline" rather than a verb+resource statement. It does not say what an exchange order is, whose orders are returned, or what scope/filtering applies, so it cannot be distinguished meaningfully from siblings like view_money_movements or list_ngn_money_movements_and_overdraft_data.

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?

There is no when-to-use, when-not-to-use, or alternative-tool guidance at all. An agent cannot tell from this text whether to call it before or after view_exchange_market_usd_ngn, or in place of the other list_* tools.

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

list_ngn_money_movements_and_overdraft_dataDInspect

Run the list_ngn_money_movements_and_overdraft_data pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.4/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full behavioral burden, but it discloses nothing about permissions, side effects, data returned, or whether the operation is read-only or destructive.

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

Conciseness2/5

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

The single sentence is technically short, but it is under-specified rather than concise. It provides no front-loaded explanation of the tool's behavior.

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

Completeness1/5

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

For a tool with no annotations and no output schema, the description is completely inadequate. It does not explain the pipeline, expected behavior, or how the optional notification message is used.

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

Parameters3/5

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

Schema description coverage is 100%, so the single optional notification_message parameter is documented in the schema. The description adds no parameter meaning beyond that, which meets the baseline for fully covered schemas.

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

Purpose1/5

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

The description only says to run a pipeline named after the tool, which restates the tool name without explaining what the operation actually does. It does not identify the resource, scope, or distinction from siblings such as view_money_movements.

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

Usage Guidelines1/5

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

There is no guidance on when to use this tool, when not to use it, or which sibling tool to choose instead. The description gives the agent no routing criteria.

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

resolve_bank_accountDInspect

Run the resolve_bank_account pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.9/5.0
Behavior1/5

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

With no annotations, the description carries the full disclosure burden and discharges none of it: it does not say whether this is a read or a mutation, whether it moves money, what external bank API it hits, whether it is idempotent, or what happens on failure. "Pipeline" is a label, not a 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.

Conciseness2/5

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

It is one short sentence, but brevity here is under-specification rather than conciseness: the sentence consumes the entire definition without conveying actionable information. Nothing is front-loaded because nothing substantive is present.

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

Completeness1/5

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

No annotations, no output schema, and a single opaque parameter mean the description must explain what the tool does and returns, and it does neither. An agent cannot safely decide to call a bank-account resolution operation on this basis.

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

Parameters3/5

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

Schema coverage is 100% and the single optional notification_message parameter is fully documented in the schema, so the baseline of 3 applies. The description adds nothing beyond it, and notably the only parameter is a fallback message string, which gives no clue about the account data the tool presumably operates on.

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

Purpose2/5

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

"Run the resolve_bank_account pipeline" restates the tool name as a pipeline and never says what resolving a bank account actually does (validate an account number? match a beneficiary? clear a pending transfer?). No sibling is differentiated, even though siblings like list_bank_beneficiaries and bank_transfer occupy adjacent territory.

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?

There is no indication of when to call this versus bank_transfer, list_bank_beneficiaries, or fetch_kyc_status, nor any stated preconditions. The description offers no guidance at all, leaving routing entirely to guesswork from the name.

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

session_statusAInspect

Check whether you are signed in to Juicyway (loads your profile via GET /me). Call before other tools; if this fails, use start_browser_auth.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

A4.4/5.0
Behavior4/5

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

With no annotations provided, the description carries the behavioral burden and does disclose the key traits: it is a sign-in status check, it loads the profile via GET /me, and it should be run before other tools with start_browser_auth as fallback. It does not describe response contents or rate-limit behavior, but it provides strong invocation context for a simple read-oriented check.

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 compact sentences with zero filler. The precondition is front-loaded and the fallback is stated immediately after, so the agent can act without scanning further.

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?

The description is complete for invocation: it covers purpose, sequencing, endpoint behavior, and failure fallback. Because no output schema exists, it could say more about what the sign-in/profile response contains, but for a simple status check the omission is minor.

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

Parameters3/5

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

Schema description coverage is 100%, so the only parameter, notification_message, is already fully documented in the schema. The description adds no parameter-specific guidance beyond the schema, which is acceptable but not enhancing.

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?

The description states a specific verb and resource: check whether the user is signed in to Juicyway. It also explains that this loads the profile via GET /me, making the underlying action concrete and distinguishable from siblings such as start_browser_auth and fetch_user_profile.

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?

It explicitly says to call this before other tools and names start_browser_auth as the fallback if the check fails. This gives clear when-to-use and failure-routing guidance rather than leaving sequencing to inference.

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

start_browser_authAInspect

Open App Store Connect sign-in only when needed. If the saved session is still valid, this tool returns success immediately and does not open the viewer. Call session_status first. Use force_reconnect only when the user explicitly wants to wipe the saved cookie and sign in again (destructive).

NameRequiredDescriptionDefault
force_reconnectNoDESTRUCTIVE: delete the saved session cookie for this tenant, then open the viewer for a fresh sign-in. Do not set true unless the user explicitly asks to sign out / reconnect / clear session.

TDQS

A4.6/5.0
Behavior4/5

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

With no annotations, the description carries the full burden and does well: it discloses the no-op/idempotent short-circuit when a saved session is valid, that the viewer is not opened in that case, and that force_reconnect destroys the saved cookie. It does not say whether the call blocks while the user signs in or what a failure result looks like.

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?

Four short sentences, front-loaded with the default safe behavior, then the prerequisite, then the opt-in destructive path. Nothing extraneous; the repeated 'destructive' emphasis is proportionate to the risk.

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?

Covers the branching behavior, prerequisite, and risk for a one-parameter tool with no output schema. The only gap is what the tool returns or how long it blocks during interactive sign-in.

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

Parameters4/5

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

Schema coverage is 100% and the single parameter is already well documented, so baseline is 3; the description adds a usage-level condition (only on explicit user request to sign out/reconnect/clear session) that reinforces the destructive semantics beyond the schema wording.

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 and resource ('Open App Store Connect sign-in') plus the scope constraint ('only when needed'), and names the sibling that should gate it (session_status). An agent can distinguish it from login and session_status without further reading.

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 ordering ('Call session_status first') and an explicit exclusion for the destructive path ('Use force_reconnect only when the user explicitly wants to wipe the saved cookie'). Both when-to-use and when-not-to-use are stated.

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

view_additional_market_dataDInspect

Run the view_additional_market_data pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.9/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden of disclosure, yet it says nothing about permissions, side effects, data freshness, or return shape. The word 'pipeline' implies multi-step execution but no behavior is explained.

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

Conciseness2/5

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

It is one short sentence with no bloat, but that brevity comes from omission rather than discipline — the single sentence conveys no information an agent can act on.

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

Completeness1/5

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

With no annotations, no output schema, and a vacuous description, there is nothing telling an agent what this tool returns or when invoking it is correct. For an opaque domain tool in a crowded sibling set, this is wholly inadequate.

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?

There is a single optional parameter and schema description coverage is 100%, with a clear description of the notification_message fallback purpose. The tool description adds nothing about parameters, but the schema already does the work, so baseline 3 applies.

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

Purpose2/5

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

The description restates the tool name as 'Run the view_additional_market_data pipeline,' which is tautological — it adds no verb or resource detail beyond the identifier itself. It gives an agent no way to tell what data is viewed or how this differs from siblings like view_exchange_market_usd_ngn or view_money_movements.

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?

There is no guidance on when to use this tool, when not to, or which sibling to prefer instead. An agent facing 20 sibling tools, several of which also 'view' market/balance data, has nothing to route on.

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

view_deposit_accountsDInspect

Run the view_deposit_accounts pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.7/5.0
Behavior1/5

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

With no annotations, the description carries the full burden of behavioral disclosure and provides none: it doesn't say whether this is a read-only or mutating operation, what authentication or account scope is required, or what the invocation produces. "Run the pipeline" discloses nothing about behavior.

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

Conciseness2/5

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

It is one short sentence, but brevity here comes from under-specification rather than efficiency — there is no front-loaded statement of purpose, scope, or effect. Every word present is wasted on restating the name.

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

Completeness1/5

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

For a tool with no annotations and no output schema, the description must explain what the call does and returns; it explains neither. An agent cannot determine from this definition whether the tool is safe to call, what it costs, or how it differs from list_deposit_accounts.

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?

The single optional parameter has 100% schema description coverage, including the unusual instruction that notification_message is a plain-text fallback message for a failed follow-up reply. The description adds nothing beyond the schema, so the baseline of 3 applies.

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

Purpose2/5

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

"Run the view_deposit_accounts pipeline" restates the tool name with the vague filler word "pipeline" instead of naming a resource or operation. It gives no clue whether this views a single account, all accounts, or a summary, and does not distinguish it from the sibling list_deposit_accounts.

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

Usage Guidelines1/5

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

There is no when-to-use guidance, no prerequisites, and no mention of alternatives — notably the near-identical sibling list_deposit_accounts, which an agent would have no basis to choose between. The agent is left to guess entirely.

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

view_exchange_market_usd_ngnCInspect

Run the view_exchange_market_usd_ngn pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

C2/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure, and it discloses nothing — no read-only nature, no data freshness, no failure behavior, no return characteristics. Calling it 'a pipeline' actively obscures whether it is a read or a mutation.

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?

One short sentence with no padding and no wasted clauses. It is concise to a fault — brevity here reflects under-specification rather than tight writing, but it earns full marks on the conciseness dimension itself.

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

Completeness1/5

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

With no annotations, no output schema, and a vague one-liner, the definition is completely inadequate for an agent to know what the tool returns or how it differs from the many view_* and fetch_* siblings.

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?

The single parameter, notification_message, is fully documented in the schema (100% coverage), so the description need not repeat it. Baseline 3 applies since the schema does the work, though the description adds no context about when that message is surfaced.

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

Purpose2/5

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

The description is a near-tautology: 'Run the view_exchange_market_usd_ngn pipeline' merely restates the tool name and adds no verb+resource clarification. It never states that this retrieves USD/NGN exchange market data, nor distinguishes it from siblings like view_additional_market_data or get_exchange_quote_ada.

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

Usage Guidelines1/5

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

There is no indication of when to call this tool, when not to, or which sibling to prefer for exchange-rate or market-data needs. The agent is left to infer everything from the name alone.

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

view_money_movementsDInspect

Run the view_money_movements pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.7/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden. It discloses nothing about whether the operation reads or mutates data, what side effects a "pipeline" run has, whether it requires auth, or what happens on failure.

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

Conciseness2/5

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

The single sentence is short but is under-specification rather than conciseness — it wastes its only sentence on restating the name instead of conveying purpose or behavior.

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

Completeness1/5

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

With no annotations, no output schema, and a description that says nothing, an agent has essentially no information to decide whether or how to call this tool. The definition is inadequate for even a one-parameter tool.

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?

The single parameter has 100% schema description coverage, so the schema already explains notification_message fully. The description adds no additional meaning, but with full coverage the baseline of 3 applies.

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

Purpose2/5

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

"Run the view_money_movements pipeline" is a tautology: it restates the tool name without saying what the tool actually does, what data it views, or what a "pipeline" is here. There is no distinction drawn from the many sibling tools, notably list_ngn_money_movements_and_overdraft_data.

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

Usage Guidelines1/5

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

There is no guidance on when to use this tool, when not to, or which sibling to prefer. With several money-movement-related siblings (list_ngn_money_movements_and_overdraft_data, bank_transfer, create_payout), the absence of any routing guidance is a serious gap.

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

view_referralsDInspect

Run the view_referrals pipeline.

NameRequiredDescriptionDefault
notification_messageNoShort user-facing sentence for this action if the follow-up reply fails. Plain text only; do not mention template syntax or variable names.

TDQS

D1.9/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure. It says nothing about whether this is a read-only or mutating operation, what side effects may occur, what permissions are needed, or what the "follow-up reply" referenced by the parameter implies — leaving the agent without essential behavioral context.

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

Conciseness2/5

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

The single sentence is structurally compact and front-loaded, but its brevity reflects under-specification rather than concise communication. It does not earn its place because it conveys almost no actionable information beyond the tool name.

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

Completeness1/5

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

Given the absence of annotations, an output schema, and any meaningful behavioral or usage context, the description is not complete enough for an agent to invoke the tool correctly. It does not explain what the pipeline does, when to use it, or what to expect.

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

Parameters3/5

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

Schema description coverage is 100%, so the single optional notification_message parameter is already fully documented in the schema. The description adds no additional meaning, but the high schema coverage supports a baseline score of 3.

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

Purpose2/5

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

The description only says "Run the view_referrals pipeline," which largely restates the tool name without explaining what viewing referrals entails. It does not distinguish the tool from siblings like get_referrals_and_overdrafts_balance or get_additional_referrals_and_balances, nor clarify whether it retrieves, displays, or processes referral data.

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?

There is no guidance about when to use view_referrals versus the multiple referral-related sibling tools. The description provides no context, prerequisites, or exclusions to help an agent choose this tool.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 21 tool updates
    • First observedbank_transfer
    • First observedcreate_payout
    • First observedfetch_kyc_status
    • First observedfetch_payout_charge_info
    • First observedfetch_user_profile
    • First observedget_additional_referrals_and_balances
    • First observedget_exchange_quote_ada
    • First observedget_referrals_and_overdrafts_balance
    • First observedget_supported_banks
    • First observedlist_bank_beneficiaries
    • First observedlist_deposit_accounts
    • First observedlist_exchange_orders
    • First observedlist_ngn_money_movements_and_overdraft_data
    • First observedresolve_bank_account
    • First observedsession_status
    • First observedstart_browser_auth
    • First observedview_additional_market_data
    • First observedview_deposit_accounts
    • First observedview_exchange_market_usd_ngn
    • First observedview_money_movements
    • First observedview_referrals

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Banking infrastructure for AI agents: open accounts, issue cards, send SEPA/SWIFT payments, run mass payouts, and pay invoices via natural language.
    2
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Bridges AI assistants with the Revolut Business API to enable banking operations such as listing accounts, checking balances, viewing transactions, managing counterparties, and initiating transfers through natural language.
    107 npm
    35
    MIT
  • A
    license
    Not graded
    quality
    F
    maintenance
    Enables AI assistants to interact with Banco Inter business accounts, including balance inquiries, statement downloads, and full boleto management via natural language.
    19 npm
    5
    ISC
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to operate Xental merchant accounts via natural language, provisioning virtual accounts, monitoring transactions, and executing payouts.
    13
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources