List Audit Logs
list_audit_logsRead organization audit history without credentials.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| action | No | ||
| entity | No | ||
| offset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
list_audit_logsRead organization audit history without credentials.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| action | No | ||
| entity | No | ||
| offset | No |
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description's one addition, 'without credentials', is a genuine behavioral claim beyond the annotations but is ambiguous — it could mean no auth is required, or that credential values are excluded from the output — and it says nothing about pagination caps (limit max 100, offset max 10000) that a caller should know about.
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?
It is a single front-loaded sentence with no padding, which satisfies the conciseness requirement. However, the one clause it does contain ('without credentials') is the least informative part of the sentence, so the terseness reads as under-specification rather than discipline.
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?
An output schema exists, so return values need no explanation, and annotations cover safety. What remains missing for a four-parameter, filterable list tool is how filtering and paging behave — the agent gets no help choosing action/entity values or understanding offset semantics, leaving it to guess from bare property names.
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?
All four parameters (limit, offset, action, entity) have 0% schema description coverage, so the description carries the full burden — and it mentions none of them. The names are largely self-explanatory and the schema supplies types, defaults and bounds, but there is no description of what values 'action' and 'entity' accept or how they filter, which is exactly the gap the description should fill.
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?
Names a verb ('Read') and resource ('organization audit history'), so the general intent is graspable, but the scope is vague — no indication of what an audit log entry is, what the tool returns, or that the history can be narrowed by action/entity. The trailing 'without credentials' is cryptic rather than clarifying and leaves the purpose fuzzier than a plain 'List audit log entries for the organization' would.
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?
There is no statement of when to call this versus anything else, no prerequisites, and no exclusions. Because no sibling in the list covers audit logs, the risk is low, but the description still gives the agent zero routing guidance — notably it never says this is the tool to reach for when investigating who changed what.
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.