Skip to main content
Glama
EugenEistrach

mcp-loader

MCP Loader

Drop .ts or .js files in a folder. They become MCP tools. That's it.

Quick Start

// .claude/tool/math.ts
import { tool } from "mcp-loader";

export const add = tool({
  description: "Add two numbers",
  args: {
    a: tool.schema.number(),
    b: tool.schema.number(),
  },
  execute: ({ a, b }) => a + b,
});

Add to .mcp.json:

{
  "mcpServers": {
    "tools": {
      "command": "npx",
      "args": ["mcp-loader", ".claude/tool"]
    }
  }
}

Done. Tools work in Claude.

Related MCP server: dynamic-mcp

Install

Global install:

npm install -g mcp-loader

Or as a dev dependency:

npm install --save-dev mcp-loader

Or just use npx (no install):

npx mcp-loader .claude/tool

Features

  • Hot reload - Save file, tool updates (disable with MCP_NO_HOT_RELOAD=true)

  • Multiple tools per file - Use named exports

  • MCP context - Second param in execute has request info

  • TypeScript - Full type safety

Note

After changing tools, refresh with /mcp in Claude Code or restart Claude Desktop.

License

MIT

Available Tools

16 tools
context-test_contextInfoB

Get detailed information about the MCP context

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

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

The verb 'Get' implies a read-only operation, but the description provides no details about what 'detailed information' means, what the response contains, or whether there are any side effects. With no annotations available, the description carries the full burden and largely fails to disclose behavioral specifics.

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 or redundant information. Every word contributes to explaining the tool's basic purpose.

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?

For a zero-parameter read tool, little is needed, but the absence of an output schema and the vague phrase 'detailed information' leave the agent uncertain about what will actually be returned. The description is adequate for invoking the tool but not fully complete for choosing it confidently among siblings.

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 has zero parameters, so there are no parameter semantics to document. This matches the baseline of 4 for a no-parameter tool.

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 uses a clear verb ('Get') and identifies a resource ('detailed information about the MCP context'), so an agent can broadly understand the tool's purpose. However, it does not distinguish this from closely related siblings such as 'context-test_trackUsage' or 'session_info', and the term 'MCP context' remains somewhat vague.

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

Usage Guidelines2/5

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

No guidance is given about when to use this tool versus related tools like 'context-test_trackUsage' or 'session_info'. The description only states what it does, not when it should be preferred or avoided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

context-test_trackUsageC

Track tool usage with context information

ParametersJSON Schema
NameRequiredDescriptionDefault
actionYesWhat action was performed

TDQS

C2.5/5.0
Behavior2/5

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

No annotations are present, so the description is the sole source of behavioral disclosure. 'Track' hints at an action but does not explain side effects, whether data is persisted, what the response looks like, or whether any circumstances make the call unsafe. This is a significant gap for a tool with no annotation coverage.

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?

The description is a brief six-word sentence with no filler, so it is concise in length. However, it is under-specified to the point of omitting helpful details, making it not appropriately sized for the guidance an agent needs.

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

Completeness2/5

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

With no annotations and no output schema, the description carries the full burden of explaining the tool. It fails to state what the tool returns, what 'context information' means, or what effects invoking it has. The single parameter is covered by the schema, but the overall usage context remains unclear.

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?

The input schema already documents the only required parameter, 'action', with 100% coverage, so the baseline is 3. The description adds no additional meaning about the parameter, such as expected format, examples, or how 'context information' relates to it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a verb, 'track', and a resource, 'tool usage', which gives a basic sense of the tool's function. However, 'with context information' is vague and doesn't clarify what tracking entails, nor does it distinguish this tool from siblings like context-test_contextInfo. It is more than a tautology but lacks precision.

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

Usage Guidelines2/5

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

No guidance is given about when to use this tool versus any of the 14 sibling tools. There are no exclusions, prerequisites, or alternative recommendations, so an agent cannot determine the appropriate context for invoking this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

context-test_withTimeoutC

Execute something with timeout using AbortSignal from context

ParametersJSON Schema
NameRequiredDescriptionDefault
delayMsYesHow long to wait in milliseconds

TDQS

C2.3/5.0
Behavior2/5

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

With no annotations, the description must carry the behavioral burden, but it only hints at 'using AbortSignal from context'. It does not explain what the tool waits for, what result it returns, whether it aborts or errors, or how delayMs interacts with the timeout behavior.

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?

The description is short and front-loaded, but it uses vague language like 'something' and lacks essential operational detail. It is concise in length but not in clarity, so it falls at the minimum viable level.

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

Completeness2/5

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

Even though the tool is simple with a single parameter, the description is not complete enough for an agent to use it confidently. There is no output schema and no annotations, and the description leaves critical behavioral questions unanswered.

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?

The input schema fully covers delayMs with the description 'How long to wait in milliseconds', so the schema does the heavy lifting. The tool description adds no additional meaning to this parameter, matching the baseline 3 for full schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description says 'Execute something with timeout' but never identifies what "something" is or what operation this tool actually performs. It is close to a tautology of the name 'withTimeout' and does not distinguish this from sibling context-test_* tools.

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

Usage Guidelines2/5

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

The description provides no guidance about when to use this tool versus alternatives such as context-test_contextInfo or context-test_trackUsage. There are no context conditions, prerequisites, or exclusions mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

demoD

Demo tool with enum and default value

ParametersJSON Schema
NameRequiredDescriptionDefault
styleNoText stylelowercase
prefixNoMessage prefix typeinfo
messageYesMessage to format

TDQS

D1.9/5.0
Behavior1/5

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

With no annotations provided, the description carries the full burden of explaining behavior. It does not disclose whether this tool has side effects, what it returns, how it processes the message, or whether the style/prefix defaults affect output. An agent has no behavioral expectations beyond the raw schema.

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

Conciseness2/5

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

The description is short, but under-specification is not effective conciseness. Neither 'Demo tool' nor 'with enum and default value' earns its place; both restate information already available from the tool name and schema. The structure is clear but does not deliver functional value.

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

Completeness1/5

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

For a tool with 3 parameters, 2 enums, no annotations, and no output schema, the description is severely incomplete. It fails to explain what the tool does, how the three parameters combine, or what an agent should expect after invocation. This is far below the minimum viable level for safe and correct use.

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 the schema already documents all three parameters. The description's mention of 'enum and default value' merely echoes schema metadata without adding any meaning about how the parameters interact or what format values should take. Baseline 3 applies because the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description says 'Demo tool with enum and default value,' which essentially restates the name 'demo' and points to schema features rather than stating what the tool actually does. There is no verb describing an operation or outcome, so an agent cannot tell whether this formats a message, echoes input, or performs some other demo action.

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

Usage Guidelines2/5

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

No guidance is given for when to use this tool versus its many siblings like test_echo, test_liveTest, or context-test_withTimeout. The word 'demo' implies a testing/demonstration purpose, but nothing explicitly states when this tool is preferred or what distinguishes it from the alternative test/demo tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

math_addA

Add two numbers

ParametersJSON Schema
NameRequiredDescriptionDefault
aYes
bYes

TDQS

A3.6/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 of behavioral disclosure. It states the fundamental operation but does not explicitly describe the return value or mention edge cases such as type handling beyond the schema's numeric type requirement.

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 efficient sentence with no filler. Every word contributes meaning, and it is immediately scannable.

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?

Given the low complexity of the tool, the required numeric schema, and the clearly stated operation, the description is mostly complete. The only minor gap is that the return value is not explicitly described, though it is easily inferred as the sum.

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 0%, so the description must compensate. 'Add two numbers' indirectly clarifies that parameters a and b are the addends, but it adds no per-parameter details beyond what the parameter names and types already imply.

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 specifies a clear verb ('Add') and resource ('two numbers'), making the tool's core operation unambiguous. It distinguishes from sibling operations like math_divide and math_multiply by the stated operation, though not explicitly mentioning them.

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

Usage Guidelines3/5

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

The intended usage is implied: use this tool when two numeric values need to be summed. There is no explicit guidance about when not to use it or how it compares to alternative arithmetic tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

math_divideC

Divide two numbers

ParametersJSON Schema
NameRequiredDescriptionDefault
aYes
bYes

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states that division is performed and omits important behavior such as what happens when b is 0, whether the result is a float, and any error handling or precision details.

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?

The description is a single short sentence with no filler, and the operation is front-loaded. However, it is under-specified rather than efficiently complete, so it earns a middle score rather than a higher one.

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

Completeness2/5

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

With two required numeric parameters and no output schema, the description omits essential context: operand order and division-by-zero behavior. The tool is simple, but an agent selecting and invoking it correctly would need more information.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the description does not map a to a dividend or b to a divisor. Since division is non-commutative, failing to specify operand order is a material omission that the description does nothing to resolve.

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 uses a specific verb ('divide') and a clear object ('two numbers'), and the operation is semantically distinct from siblings like math_add and math_multiply. It does not specify which operand is the dividend and which is the divisor, but the core purpose is unambiguous.

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

Usage Guidelines2/5

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

There is no guidance about when to use math_divide versus math_multiply, math_add, or any alternative. No examples, prerequisites, or disambiguating conditions are provided; the only implied usage comes from the tool name itself.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

math_multiplyA

Multiply two numbers

ParametersJSON Schema
NameRequiredDescriptionDefault
aYes
bYes

TDQS

A3.5/5.0
Behavior3/5

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

No annotations are provided, so the description carries the burden of behavioral disclosure. 'Multiply two numbers' implies a pure, side-effect-free calculation, but it does not explicitly state that no state changes occur, what the return value is, or any edge-case behavior. For a simple arithmetic operation, this minimal disclosure is adequate but not rich.

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 zero wasted words. It communicates the core purpose efficiently and is appropriately sized for a tool of this trivial complexity.

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, so the description should ideally mention that the tool returns the product. 'Multiply two numbers' strongly implies a numeric result, making the tool callable, but the lack of an explicit return-value statement leaves a minor gap. Error behavior and edge cases are also absent, but for multiplication this is not critical.

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 0%, so the description should compensate. It refers to 'two numbers', which generally maps to parameters a and b, but it adds no detail beyond the schema's type declarations. Since multiplication is commutative, parameter ordering is irrelevant, and the schema already makes the types clear; the description provides just enough context.

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 the specific verb 'Multiply' with a clear resource ('two numbers'), which unambiguously distinguishes it from sibling tools like math_add and math_divide. An agent can immediately understand what this tool does without needing to inspect other definitions.

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

Usage Guidelines2/5

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

There is no guidance about when to use this tool versus alternatives. The presence of math_add and math_divide as siblings makes such guidance valuable, but the description simply states the operation without any mention of selection criteria or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

session_infoB

Get information about the current Claude Code session

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.4/5.0
Behavior3/5

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

There are no annotations, so the description carries the full burden of behavioral disclosure. 'Get information' suggests a read-only operation, but it does not explicitly state side effects, permissions, or what 'session' scope means. For a zero-parameter query tool this is acceptable but minimal.

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 declarative sentence with no redundant words. It earns its place and leaves no room for unnecessary detail.

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?

For a simple zero-parameter getter, this is nearly sufficient, but 'information' is vague and there is no output schema. An agent can invoke the tool correctly but may not know what fields or shape the returned session information will take.

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 has zero parameters and the schema is trivially fully covered with an empty object, so the baseline is 4. There is no parameter information for the description to add, and none is missing.

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?

Description states a specific verb ('Get') and resource ('information about the current Claude Code session'), making the core function clear. It does not explicitly differentiate from sibling context-test_contextInfo, which may also return session-related data, so it stops short of a 5.

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

Usage Guidelines2/5

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

No guidance is provided on when to use this tool instead of sibling session/context tools, and no exclusions or prerequisites are mentioned. The only usage signal is the generic implication that you should call it when you want session information.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

session_notifyC

Send a notification through MCP

ParametersJSON Schema
NameRequiredDescriptionDefault
levelNoNotification levelinfo
messageYesThe notification message

TDQS

C2.5/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral disclosure burden. It reveals that the tool sends a notification, but does not state where the notification goes, whether it persists, whether the level affects delivery, or whether any side effects or permissions are involved. For a side-effecting operation, this is a significant transparency gap.

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?

The description is one short sentence and is front-loaded, but it is also low on substance. The phrase 'through MCP' adds little value, and the sentence largely restates what the tool name already implies. It is concise, but conciseness is not accompanied by useful context.

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

Completeness2/5

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

The tool has a simple flat schema, so an agent can construct a call, but the description does not explain the tool's effect, destination, delivery semantics, or return behavior. Since there are no annotations and no output schema, the description needed to compensate more than it does.

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 the input schema already documents both message and level, including the enum values and default. The description adds no parameter-level meaning beyond the schema, so the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states the verb 'Send' and the object 'notification', so an agent can infer the core action. However, 'through MCP' is vague and does not clarify to whom or where the notification goes, and it does not differentiate this from the nearby session_info and session_request tools. The phrasing borders on restating the tool name.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus alternatives, and no mention of prerequisites or context. The sibling list contains session_info and session_request, but the description gives no reason to prefer one over another. An agent must rely entirely on the tool name and schema.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

session_requestC

Make a request through MCP protocol

ParametersJSON Schema
NameRequiredDescriptionDefault
methodYesThe MCP method to call

TDQS

C2/5.0
Behavior1/5

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

No annotations are provided, so the description carries the full burden of disclosing behavior. It only says 'make a request' with no mention of side effects, required context, failure modes, or what protocol interaction actually occurs.

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

Conciseness2/5

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

The description is short, but its brevity reflects under-specification rather than effective conciseness. The single sentence 'Make a request through MCP protocol' does not provide enough substance to justify its place.

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

Completeness2/5

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

For a tool with no annotations, no output schema, and unclear differentiation from siblings, the description is inadequate. An agent cannot determine what a successful request looks like, what methods are supported, or when this tool should be selected over related session tools.

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 the parameter is already minimally documented. However, the description adds no meaningful detail about what values 'method' accepts, what formats are expected, or how the parameter affects the request.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Make a request through MCP protocol' essentially restates the tool name and adds no concrete resource or action detail. It does not clarify what kind of request, what session it operates on, or how it differs from sibling tools like session_info or session_notify.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus alternatives such as session_info or session_notify. The description provides no context, prerequisites, or hints about intended invocation scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

systemB

Get system information and MCP context

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.3/5.0
Behavior3/5

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

No annotations are provided, so the description carries the behavioral burden. 'Get' clearly signals a read-only, non-mutating operation, but the description does not disclose output shape, response details, or any operational constraints beyond that.

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

Conciseness4/5

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

The description is one concise, front-loaded sentence with no filler. It could be more informative, but it is appropriately brief for a simple, parameterless informational tool.

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?

For a zero-parameter read-only tool, the description is minimally sufficient, but it does not define what 'system information' or 'MCP context' includes. With no output schema, the agent must guess what the returned payload will contain.

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 input schema is empty with zero parameters, so the description does not need to explain any parameter semantics. This matches the baseline of 4 for parameterless tools.

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 clear action ('Get') and a specific resource ('system information and MCP context'). It is not a tautology and is distinct enough from most siblings, though it could more sharply differentiate itself from context-related tools like context-test_contextInfo.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus sibling tools, no exclusions, and no mention of prerequisites. The intended invocation context is left entirely to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

testC

Test tool to verify MCP loader works

ParametersJSON Schema
NameRequiredDescriptionDefault
messageNo

TDQS

C2.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden of disclosing behavior. It only states that this is a test tool; it does not say whether the call is read-only, whether it has side effects, what it returns, or what 'verify' entails. Some behavior is implied but not meaningfully disclosed.

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?

The description is concise and front-loaded with the core purpose in a single sentence. However, the brevity comes at the cost of under-specification: it omits parameter semantics, return behavior, and any guidance that would make the tool independently usable.

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

Completeness2/5

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

With no output schema, no annotations, and no parameter explanation, an agent cannot fully predict the call's behavior or response. For a tool whose entire job is to verify a loader, the description should at least state the expected result or failure signal. The current description is only minimally adequate as a placeholder.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, and the description does not mention the 'message' parameter at all. The input schema provides only a name and type, leaving an agent without any idea what message means, whether it is echoed, validated, or used as a test payload.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a general purpose—verifying the MCP loader works—so it is not a pure tautology. However, it is vague: it does not specify what the tool actually does when called, what 'works' means, or how it differs from sibling test tools like test_echo or test_liveTest.

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

Usage Guidelines3/5

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

The phrase 'to verify MCP loader works' implies the tool should be used as a smoke test for the loader. There is no explicit guidance about when to prefer this tool over sibling test tools, and no exclusions or alternative recommendations are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

test_echoA

Echo back a message

ParametersJSON Schema
NameRequiredDescriptionDefault
textYes

TDQS

A3.9/5.0
Behavior4/5

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

With no annotations, the description carries full behavioral burden. 'Echo back a message' accurately communicates the action and implies no state change, which is sufficient for a trivial read-like operation, though it stops short of explicitly stating side effects or return details.

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 four-word sentence with no fluff, and the core action is front-loaded. Every word earns its place.

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 trivial one-parameter echo tool with no output schema, the description provides enough information to call it correctly: the purpose and the role of the text parameter are clear. No additional context is essential.

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?

The schema has a single 'text' string parameter with no description (0% coverage). The description's 'message' maps to this parameter, adding some meaning, but it does not elaborate on formatting, constraints, or edge cases.

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 'Echo back a message' uses a specific verb and resource, clearly stating that the tool returns the provided message. No sibling tool has a matching purpose, so differentiation is unambiguous.

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

Usage Guidelines2/5

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

There is no guidance on when to use this tool versus alternatives like test_liveTest or test_getTime. The description implies a simple testing utility but does not state appropriate contexts or exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

test_getTimeB

Get current UTC time

ParametersJSON Schema
NameRequiredDescriptionDefault
formatNo

TDQS

B3.4/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure. It clearly states a read-only retrieval of UTC time, but it does not disclose what is returned (e.g., ISO string, Unix epoch), how the format parameter changes the output, or whether there is a default format. This is a meaningful gap for an agent invoking the tool.

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 short sentence with no filler or redundant information. The core behavior is front-loaded and immediately understandable.

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?

The tool is simple and can be called with zero arguments, but there is no output schema and no annotation coverage. The description establishes that the tool returns the current UTC time but leaves the return representation and the role of the format parameter unexplained. This is adequate for a basic call yet incomplete for deliberate use of the parameter.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema documents a single optional format parameter with enum values but no descriptions, and schema description coverage is 0%. The description does not mention the parameter at all, so it fails to compensate for the schema gaps. The enum names are somewhat self-explanatory, but no default or meaning of each format is provided.

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 ('Get') and identifies the exact resource ('current UTC time'), which makes the tool's purpose unambiguous. It also adds the UTC qualifier that the bare name test_getTime lacks, and no sibling tool appears to offer the same functionality.

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

Usage Guidelines3/5

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

The description implies the tool should be used whenever current UTC time is needed, but it gives no explicit guidance about when not to use it or whether alternatives exist. There is also no mention of how the optional format parameter should influence selection of this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

test_hotReloadTestD

Test that hot reload is working

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNo

TDQS

D1.5/5.0
Behavior1/5

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

No annotations exist, so the description must disclose behavior itself. It does not: there is no mention of side effects, environment requirements, assertions performed, output produced, or whether the test mutates anything. The description is too thin to inform an agent about the tool's actual behavior.

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

Conciseness2/5

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

The description is one short sentence, but this is under-specification rather than effective conciseness. Every sentence is minimal, yet the content does not earn its place because it adds almost no information beyond the tool name.

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

Completeness1/5

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

Despite being a simple tool with one optional parameter and no output schema, the description is insufficient: an agent cannot know what 'hot reload' refers to, what conditions the test checks, whether it is safe to call, or what a successful or failed result looks like. The description needs substantial additional context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema declares one optional string parameter 'name', but schema description coverage is 0%. The description does not mention 'name' at all, nor does it explain its purpose, format, or effect. Since the description provides zero compensation for the undocumented parameter, this is a major gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Test that hot reload is working' essentially restates the tool name test_hotReloadTest. It names a vague goal ('test hot reload') but does not specify what action the tool performs, what resource it operates on, or how it differs from sibling tools like test_liveTest or test_echo.

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

Usage Guidelines2/5

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

There is no guidance about when to use this tool, what conditions warrant calling it, or which sibling tool would be a better fit. The description simply repeats the tool's stated purpose without giving an agent any decision criteria.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

test_liveTestC

Live reload test - added without restart

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

C2.3/5.0
Behavior1/5

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

No annotations are provided, so the description must carry the full burden of behavioral disclosure. It only mentions that the tool is a live reload test added without restart; it does not describe side effects, return values, safety, or operational behavior. An agent has essentially no information about what happens on invocation.

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

Conciseness4/5

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

The description is very short and contains no redundant or repetitive text. However, the phrase 'added without restart' is deployment-oriented metadata rather than functional guidance, so it is not fully optimized for agent-facing usage, though it remains appropriately brief.

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

Completeness2/5

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

For a tool with no parameters, no output schema, and no annotations, the description should at least state what the tool returns or why an agent might call it. 'Live reload test - added without restart' provides neither functional semantics nor return expectations, leaving the tool contextually incomplete.

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 input schema is empty with zero parameters, so there is nothing for the description to clarify. Schema coverage is effectively complete, and no parameter documentation is needed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Live reload test - added without restart' largely restates the tool name and lacks a clear verb and resource. It signals that the tool is a test artifact but does not specify what the tool actually does when invoked, and it does not distinguish itself from sibling test tools like test_hotReloadTest.

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

Usage Guidelines2/5

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

There is no guidance on when to call this tool or when to prefer an alternative. Sibling tools include several test and context tools, but the description provides no conditions, exclusions, or recommendations to help an agent choose correctly.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 16 tool updatesv0.2.0
    • First observedcontext-test_contextInfo
    • First observedcontext-test_trackUsage
    • First observedcontext-test_withTimeout
    • First observeddemo
    • First observedmath_add
    • First observedmath_divide
    • First observedmath_multiply
    • First observedsession_info
    • First observedsession_notify
    • First observedsession_request
    • First observedsystem
    • First observedtest
    • First observedtest_echo
    • First observedtest_getTime
    • First observedtest_hotReloadTest
    • First observedtest_liveTest

TDQS

C2.4/5.0

Scored across 16 tools

Disambiguation2/5

Several tools overlap in purpose, especially the generic verification tools 'test', 'demo', 'test_hotReloadTest', and 'test_liveTest', which an agent could easily confuse. The context/system information tools also blur together: 'system', 'session_info', and 'context-test_contextInfo' all report similar environment/context details.

Naming Consistency2/5

Tool naming is mixed: math_, session_, and test_ prefixes are used, but there are bare names like 'demo', 'system', and 'test' alongside hyphens and camelCase in 'context-test_contextInfo' and 'test_hotReloadTest'. The overall pattern is readable but inconsistent.

Tool Count3/5

At 16 tools, the set is borderline heavy for what appears to be a loader/test utility server. Many of the test/demo/verification tools could likely be consolidated without losing functionality.

Completeness3/5

The set covers math, session, context, echo, time, and reload-testing scenarios, but it feels like a grab bag rather than a complete domain surface. Notable gaps include no math subtraction, no negative/error-case testing tools, and redundant generic test tools that do not clearly advance the loader-testing purpose.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A hot-reloadable MCP proxy server that enables users to create and manage custom Python tools through dynamic module loading. Users can build their own utilities, wrap APIs, and extend functionality by simply adding Python files to designated folders.
    7
    Apache 2.0
  • A
    license
    B
    quality
    C
    maintenance
    Dynamic MCP server for Node.js enabling runtime tool creation, management, and execution in isolated sandboxes (Docker or Node).
    8
    20
    1
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides a starting template for building MCP servers with TypeScript, including examples of tools and resources to accelerate development.
    -