Skip to main content
Glama

Request a capability (free)

request_capability

Free. If none of these tools does what you need — a file type we reject, an output we do not produce, a missing operation — describe the task, the formats involved, and the most you would pay per call. The operator reads these to decide what to build next. Do not include personal or confidential data.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "request": "<request>"
    },
    "name": "request_capability"
  }
}

Input Schema

NameRequiredDescriptionDefault
requestYes

Output Schema

NameRequiredDescriptionDefault
idYes
messageNoThank you. The operator reads these to decide what to build next.
receivedNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already declare a non-destructive, closed-world, non-idempotent write, so the safety profile is covered. The description adds genuinely useful context beyond that: the request is free, it is read by a human operator to prioritize future development, and personal or confidential data must be excluded — a real constraint on submission content. It does not say whether the agent receives any confirmation or timeline.

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?

Three sentences, front-loaded with the important qualifier "Free." and then the trigger condition before the content requirements. Every sentence carries distinct information — cost, trigger with examples, audience, privacy constraint — with no repetition.

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?

An output schema exists, so return values need no explanation, and the description covers cost, trigger, content requirements, and privacy. For a single-request submission tool that is close to complete; only the lack of any stated follow-up or confirmation behavior leaves a small gap.

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 description coverage is reported as 0% at the top level, so the description has to carry meaning, and it does name three of the nested fields it wants: the task, the formats involved, and the maximum price per call. It leaves desired_output, calls_per_month, and agent to the schema, where those fields are in fact documented, so the guidance aligns with the intended payload rather than merely restating it.

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?

The description states a specific action (submit a description of a task you cannot accomplish) and makes its role as the fallback for unmet needs explicit with "If none of these tools does what you need." It names concrete gap categories — rejected file type, missing output, missing operation — which lets an agent distinguish this from the convert/query/inspect siblings, though it never states outright that a request is filed with the operator until the second sentence.

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?

It gives a clear trigger condition (none of the existing tools fits) and illustrative exclusion cases (unsupported file types, missing operations, unproducible outputs). It does not say when NOT to file a request — e.g. that you should not use it for tasks an existing tool already covers — but the trigger phrase implies that boundary adequately.

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.