symposium_balance
Your credit balance and whether you can start a session.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | No | Your sk-symp-… key from symposium_register (or send it as an Authorization: Bearer header). |
Your credit balance and whether you can start a session.
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | No | Your sk-symp-… key from symposium_register (or send it as an Authorization: Bearer header). |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are supplied, so the description carries the full behavioral burden and it does not meet it. 'Balance' weakly implies a read-only query, but nothing states that it is non-mutating, whether it consumes credits, rate limits, or what authentication failure looks like; the only auth detail 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single short sentence with no filler, and the primary purpose (balance) is front-loaded ahead of the secondary check. It is efficient, though being a sentence fragment it is slightly under-specified rather than optimally 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?
With no output schema and no annotations, the description must carry the whole burden, and it does not explain what 'balance' contains (credits, sessions, renewals?), what fields are returned, or what threshold determines 'whether you can start a session'. An agent can call it but cannot interpret the result.
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?
There is a single optional api_key parameter with 100% schema description coverage, which already explains both the sk-symp- prefix and the Authorization: Bearer alternative. Per the high-coverage baseline, 3 is correct since the description adds no parameter meaning beyond the schema.
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?
The description names the resource clearly ('credit balance') and adds a second concrete purpose ('whether you can start a session'), so an agent knows what it gets back. It is a verb-less noun phrase rather than an explicit 'retrieve X', and it never contrasts itself with the eight abstract sibling names (act, enter, ghost, sense, etc.), so sibling differentiation is left to inference.
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?
Usage is only implied: by stating the tool answers 'whether you can start a session', it hints that this is a pre-session check, but it gives no explicit when-to-use, no prerequisites, and never names an alternative sibling such as symposium_enter or symposium_register. It is a minimal implied-usage signal, not guidance.
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.