Skip to main content
Glama

get_balance

Check remaining SMS credit balance in MAD and account status.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

TDQS

A4.3/5.0
Behavior3/5

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

With no annotations provided, the description carries the full burden. The word 'Check' implies a read-only operation, and the description adds useful detail (currency and account status), but it does not explicitly state that no credit is consumed or that the call has no side effects.

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?

The description is a single front-loaded sentence with no filler words. Every part adds information: the action, the resource, the currency, and the additional status check.

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

Completeness5/5

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

For a zero-parameter getter with no output schema, the description covers the essential returned information (balance and account status) and leaves no major ambiguity about what the tool does. No additional caveats or preconditions are needed for a simple read-only balance check.

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?

The tool takes zero parameters, which is the baseline 4 case. The description correctly avoids inventing parameters and simply states what the tool looks up.

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 uses a specific verb ('Check') and names the exact resource ('remaining SMS credit balance in MAD') plus the secondary result ('account status'). This clearly differentiates it from siblings like send_sms, get_analytics, or create_topup.

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

Usage Guidelines4/5

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

Although it does not explicitly mention alternatives or exclusion conditions, the intended context is obvious: call this tool whenever the remaining SMS credit or account status is needed. There is no competing sibling that does the same thing, so no stronger routing is necessary.

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.

TDQS

A3.7/5.0
Disambiguation4/5

Tools split into clear clusters: customer-facing send/verify/get tools and admin ops tools. The three ops_* tools could initially seem similar, but their descriptions distinguish operational alerts, business health, and route quality. Minor overlap exists between ops_monitoring and ops_pulse, but overall boundaries are clear.

Naming Consistency4/5

The set uses consistent prefixes: get_, send_, verify_, and ops_. This creates a predictable pattern for agents. Minor deviation is that ops_pulse and ops_route_quality are noun-style rather than verb-noun, and 'pulse' is less descriptive than the others.

Tool Count5/5

Eight tools is well-scoped for an SMS/OTP server, covering customer actions, pricing/balance, and admin oversight without bloat. Each tool has a clear role and the count feels appropriate for the domain.

Completeness4/5

Core flows are covered: balance lookup, pricing, sending SMS, OTP lifecycle, and admin monitoring. A notable gap is lack of per-message delivery status or send history, but agents can still complete the primary send-and-verify workflows. Minor gaps exist but are workable.

Resources