Skip to main content
Glama

Oxyforge WordPress

Back up a site now

backup_site

Take a backup of one of the account's sites now, before a risky change (account agent key that may make changes; one every few minutes per site).

Input Schema

NameRequiredDescriptionDefault
siteYesthe site name, from create_site or list_sites
tokenNothe token create_site returned (oxa_...); leave out when Oxyforge is connected with an account agent key

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/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 disclosure burden. It usefully adds a rate limit ('one every few minutes per site') and a synchronous-sounding 'now', but says nothing about what is captured (files, database, config), where it is stored, whether it is retained or restorable, or what it costs. The auth nuance is delegated entirely to the schema.

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

Conciseness3/5

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

A single sentence is appropriately short and front-loads the verb. However the parenthesis 'account agent key that may make changes' is grammatically tangled and forces the reader to reparse it rather than reading cleanly as a rationale plus a rate limit.

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

Completeness3/5

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

There is no output schema and no annotations, so the description should say something about the result of the backup (an identifier, a timestamp, a completion state) and about prerequisites. It covers the when and the throttling but leaves the return value and restore path unaddressed.

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 both the site name and token parameters are already documented, including the oxa_ prefix and the fallback to an account agent key. The description adds only the vague parenthetical about the agent key and no format or sourcing detail beyond the schema.

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?

States a specific verb and resource: 'Take a backup of one of the account's sites now'. The action is unmistakable and clearly distinct from siblings like delete_site or create_site. The trailing parenthetical is muddled and slightly muddies an otherwise crisp statement.

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?

'before a risky change' gives a concrete trigger condition, and 'one every few minutes per site' gives an operational constraint that shapes how an agent should schedule calls. It doesn't name when not to use it or any alternative, but no sibling offers an equivalent capability.

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.

Resources