ncp-mcp-server
Provides tools to manage Naver Cloud Platform infrastructure, including servers, networks, load balancers, and databases.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ncp-mcp-servershow me all my NCP server instances"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
NCP MCP Server
Naver Cloud Platform (NCP) Model Context Protocol (MCP) Server for Claude Desktop
π νλ‘μ νΈ μκ°
Claude Desktopκ³Ό μ°λνμ¬ NCP(Naver Cloud Platform)μ μΈνλΌλ₯Ό λννμΌλ‘ κ΄λ¦¬ν μ μλ MCP μλ²μ λλ€. Claude AIμ μμ°μ΄λ‘ λννλ©΄μ ν΄λΌμ°λ 리μμ€λ₯Ό μμ±, μ‘°ν, κ΄λ¦¬ν μ μμ΅λλ€.
Related MCP server: Superjolt MCP Server
β¨ μ£Όμ κΈ°λ₯
μλ² κ΄λ¦¬
μλ² μΈμ€ν΄μ€ μμ±/μμ/μ€μ§/μμ
μλ² λͺ©λ‘ μ‘°ν λ° μμΈ μ 보 νμΈ
λ€νΈμν¬ κ΄λ¦¬
VPC (Virtual Private Cloud) μμ±/μ‘°ν/μμ
Subnet μμ±/μ‘°ν/μμ
ACG (Access Control Group) μμ±/μ‘°ν/μμ
보μ κ·μΉ μΆκ°
λ‘λ λ°Έλ°μ
Load Balancer μμ±/μ‘°ν/μμ
νκ² μλ² λ±λ‘ λ° κ΄λ¦¬
λ°μ΄ν°λ² μ΄μ€
Cloud DB μΈμ€ν΄μ€ μμ±/μ‘°ν/μμ
π κΈ°μ μ€ν
Language: TypeScript
Runtime: Node.js
Framework: Model Context Protocol (MCP) SDK
API: Naver Cloud Platform REST API
Authentication: NCP API Key (HMAC-SHA256 Signature)
π¦ μ€μΉ λ°©λ²
1. μ μ₯μ ν΄λ‘
git clone https://github.com/YOUR_USERNAME/ncp-mcp-server.git
cd ncp-mcp-server2. μμ‘΄μ± μ€μΉ
npm install3. νκ²½ λ³μ μ€μ
.env νμΌμ μμ±νκ³ NCP API ν€λ₯Ό μ€μ ν©λλ€:
NCP_ACCESS_KEY=your_access_key_here
NCP_SECRET_KEY=your_secret_key_here4. λΉλ
npm run buildπ μ¬μ© λ°©λ²
Claude Desktop μ€μ
Claude Desktopμ μ€μ νμΌμ MCP μλ²λ₯Ό μΆκ°ν©λλ€:
macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"ncp-compute": {
"command": "node",
"args": ["/path/to/ncp-compute-mcp-server/dist/index.js"],
"env": {
"NCP_ACCESS_KEY": "your_access_key",
"NCP_SECRET_KEY": "your_secret_key"
}
}
}
}Claude Desktopμμ μ¬μ©
Claude Desktopμ μ¬μμν ν, λ€μκ³Ό κ°μ΄ μμ°μ΄λ‘ λͺ λ Ήν μ μμ΅λλ€:
- "NCP μλ² λͺ©λ‘ 보μ¬μ€"
- "web-server-1 μ΄λ¦μΌλ‘ μλ² μμ±ν΄μ€"
- "μλ² μμν΄μ€"
- "λ‘λ λ°Έλ°μ μμ±ν΄μ€"π API λͺ©λ‘
Server APIs
list_servers- μλ² μΈμ€ν΄μ€ λͺ©λ‘ μ‘°νget_server_detail- μλ² μμΈ μ 보 μ‘°νcreate_server- μλ² μμ±start_server- μλ² μμstop_server- μλ² μ€μ§delete_server- μλ² μμ
VPC APIs
list_vpcs- VPC λͺ©λ‘ μ‘°νcreate_vpc- VPC μμ±delete_vpc- VPC μμ
Subnet APIs
list_subnets- Subnet λͺ©λ‘ μ‘°νcreate_subnet- Subnet μμ±delete_subnet- Subnet μμ
ACG APIs
list_acgs- ACG λͺ©λ‘ μ‘°νcreate_acg- ACG μμ±delete_acg- ACG μμ add_acg_rule- μΈλ°μ΄λ κ·μΉ μΆκ°
Load Balancer APIs
list_load_balancers- Load Balancer λͺ©λ‘ μ‘°νcreate_load_balancer- Load Balancer μμ±delete_load_balancer- Load Balancer μμ add_load_balancer_target- νκ² μλ² μΆκ°
Cloud DB APIs
list_cloud_dbs- Cloud DB λͺ©λ‘ μ‘°νcreate_cloud_db- Cloud DB μμ±delete_cloud_db- Cloud DB μμ
π 보μ
NCP API μΈμ¦μ HMAC-SHA256 μλͺ λ°©μ μ¬μ©
API ν€λ νκ²½ λ³μλ‘ κ΄λ¦¬
.envνμΌμ.gitignoreμ ν¬ν¨λμ΄ λ²μ κ΄λ¦¬μμ μ μΈ
π νΈλ¬λΈμν
401 Unauthorized μ€λ₯
API ν€κ° μ¬λ°λ₯Έμ§ νμΈ
μλͺ μμ± μ 쿼리 νλΌλ―Έν°κ° ν¬ν¨λλμ§ νμΈ
404 Not Found μ€λ₯
API μλν¬μΈνΈ κ²½λ‘ νμΈ
NCP API λ²μ νμΈ
400 Bad Request μ€λ₯
νμ νλΌλ―Έν° λλ½ νμΈ (μ: serverCreateCount)
νλΌλ―Έν° νμ νμΈ
π μ°Έκ³ μλ£
π― ν₯ν κ³ν
Object Storage API μΆκ°
Monitoring (Cloud Insight) API μΆκ°
Auto Scaling API μΆκ°
Block Storage κ΄λ¦¬ κΈ°λ₯
μΈνλΌ μλ κ΅¬μΆ ν νλ¦Ώ
μλ¬ νΈλ€λ§ κ°μ
Available Tools
23 toolsadd_acg_ruleB
ACGμ μΈλ°μ΄λ κ·μΉμ μΆκ°ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| ipBlock | No | IP λΈλ‘ (μ: 0.0.0.0/0) | |
| portRange | No | ν¬νΈ λ²μ (μ: 80, 1-65535) | |
| protocolTypeCode | Yes | νλ‘ν μ½ νμ (TCP/UDP/ICMP) | |
| accessControlGroupNo | Yes | ACG λ²νΈ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. However, it only says 'adds an inbound rule' without disclosing any behavioral traits such as side effects, permission requirements, idempotency, or error conditions. For a mutation tool, this is a significant gap.
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?
The description is a single, short sentence with no redundancy. It is front-loaded with the action and target, and every word earns its place. It is not over-specified, just appropriately terse.
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?
Despite the tool's simplicity, the description is sparse. With no annotations and no output schema, the description does not mention return values, prerequisites, or any behavioral context. While the schema covers parameters, the description alone is insufficient for an agent to fully understand the tool's implications.
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?
Schema coverage is 100%, so all four parameters are already documented in the input schema. The description adds no additional meaning or context to the parameters, so it meets the baseline but does not go beyond it.
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 clearly states the action ('adds') and the target ('inbound rule to ACG'), using a specific verb and resource. It is unambiguous and, while it does not explicitly name a sibling alternative, there are no other rule-related tools among the siblings to confuse it with.
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?
The description offers no guidance on when to use this tool versus alternatives, nor does it mention any prerequisites or exclusions. It simply states the function without contextualizing it in a decision process.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
add_load_balancer_targetC
λ‘λ λ°Έλ°μμ νκ² μλ²λ₯Ό μΆκ°ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| serverInstanceNoList | Yes | μλ² μΈμ€ν΄μ€ λ²νΈ 리μ€νΈ | |
| loadBalancerInstanceNo | Yes | λ‘λ λ°Έλ°μ μΈμ€ν΄μ€ λ²νΈ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It does not disclose any behavioral traits such as mutation effects, permissions required, idempotency, or failure modes. For a state-changing operation, this lack of transparency is a gap.
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?
The description is a single sentence with no filler, front-loaded with the action verb. It is perfectly concise and well-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?
The tool is a simple mutation with two parameters and no output schema, but without annotations the description should provide context such as prerequisites, idempotency, or what happens if the target already exists. It does none of this, leaving the agent underinformed for a state-changing operation.
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?
Schema coverage is 100% with both parameters already described in the schema. The description adds little beyond restating that it adds target servers; it does not clarify relationships or constraints beyond what the schema provides. Baseline 3 is appropriate.
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 uses a specific verb 'adds' (μΆκ°ν©λλ€) and identifies the resource 'target server to the load balancer' (λ‘λ λ°Έλ°μμ νκ² μλ²). It clearly states the action, though it does not explicitly distinguish from sibling tools like create_load_balancer.
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?
The description provides no guidance on when to use this tool versus alternatives, no prerequisites, and no exclusions. It is a bare action statement without context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_acgB
μλ‘μ΄ ACGλ₯Ό μμ±ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| vpcNo | Yes | VPC λ²νΈ | |
| accessControlGroupName | Yes | ACG μ΄λ¦ | |
| accessControlGroupDescription | No | ACG μ€λͺ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full responsibility for disclosing behavior. However, it only states the creation action and offers no information about side effects, required permissions, idempotency, or error handling.
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?
The description is a single, front-loaded sentence with no unnecessary words, making it concise and well-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?
The tool is simple with fully documented parameters, but it lacks information about return values or dependencies. Given no output schema, the description is adequate but misses valuable context for a complete understanding.
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?
Schema description coverage is 100%, so the baseline is 3. The description adds no additional parameter-level semantics beyond what the schema already explains.
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 'μλ‘μ΄ ACGλ₯Ό μμ±ν©λλ€' translates to 'Creates a new ACG', using a specific verb (create) and resource (ACG). This clearly distinguishes it from sibling tools like delete_acg or add_acg_rule.
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?
No guidance is provided on when to use this tool versus alternatives. It does not mention prerequisites such as an existing VPC, nor does it suggest checking list_acgs before creation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_cloud_dbB
μλ‘μ΄ Cloud DB μΈμ€ν΄μ€λ₯Ό μμ±ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| vpcNo | No | VPC λ²νΈ | |
| subnetNo | No | μλΈλ· λ²νΈ | |
| cloudDBProductCode | Yes | μν μ½λ | |
| cloudDBServerCount | Yes | μλ² κ°μ | |
| cloudDBServiceName | Yes | Cloud DB μλΉμ€ μ΄λ¦ | |
| dataStorageTypeCode | Yes | μ€ν λ¦¬μ§ νμ μ½λ | |
| cloudDBImageProductCode | Yes | μ΄λ―Έμ§ μν μ½λ | |
| cloudDBServerNamePrefix | Yes | μλ² μ΄λ¦ μ λμ¬ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden of behavioral disclosure. It only states that it creates an instance, but does not mention potential side effects such as provisioning time, cost implications, required permissions, or whether the operation is asynchronous. This leaves significant ambiguity.
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?
The description is a single sentence with no wasted words, which is appropriately concise. However, it is slightly under-specified for a tool with 8 parameters, but the brevity does not harm clarity significantly.
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?
Given the complexity of creating a Cloud DB instance (8 parameters, no output schema), the description is incomplete. It lacks information about expected outcomes, potential errors, or any unique aspects of the process. This leaves the agent without sufficient context to invoke the tool confidently.
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?
The input schema has full description coverage (100%), so the baseline is 3. The tool description itself adds no parameter semantics beyond what the schema already provides. The schema descriptions are standard and clear, so this dimension is adequately covered by the structured data.
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 states 'Creates a new Cloud DB instance' in Korean, which is a specific verb+resource combination. It clearly distinguishes from sibling tools like list_cloud_dbs and delete_cloud_db, as creation is a distinct operation.
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?
No guidance is provided about when to use this tool versus alternatives. While the name implies usage for creating a Cloud DB, there is no explicit context or exclusions, making it unclear whether there are prerequisites or constraints.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_load_balancerC
μλ‘μ΄ λ‘λ λ°Έλ°μλ₯Ό μμ±ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| vpcNo | No | VPC λ²νΈ | |
| subnetNoList | No | μλΈλ· λ²νΈ 리μ€νΈ | |
| loadBalancerName | Yes | λ‘λ λ°Έλ°μ μ΄λ¦ | |
| loadBalancerAlgorithmTypeCode | Yes | μκ³ λ¦¬μ¦ νμ (RR/LC/SIPHS) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description must fully disclose behavioral traits. It only says 'creates' with no information about side effects, permissions, asynchronous behavior, or what the return value looks like. This is essentially no disclosure beyond the basic operation.
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?
The description is a single concise sentence, which is easy to process. However, it is under-specified, conveying only the bare fact that a load balancer is created, without any of the richness that would make it a truly effective description.
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?
For a 4-parameter mutation tool with no annotations and no output schema, the description is too sparse. It fails to mention usage context, output behavior, prerequisites (like VPC/subnet requirements), or any operational details, leaving significant gaps in understanding.
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?
The schema descriptions cover 100% of the parameters, so the schema already provides meaningful context for each field. The description does not add any additional parameter semantics, but it does not need to because the schema is sufficient.
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 'μλ‘μ΄ λ‘λ λ°Έλ°μλ₯Ό μμ±ν©λλ€' clearly states the action (create) and target (load balancer), which is specific and unambiguous. However, it does not add any additional detail or nuance beyond the tool name, so it only partially differentiates from sibling creation tools.
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?
No guidance is provided about when to use this tool versus alternatives, nor any prerequisites or context. The description simply states the action without indicating scenarios where it is appropriate, making it minimally useful for tool selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_serverB
μλ‘μ΄ μλ² μΈμ€ν΄μ€λ₯Ό μμ±ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| vpcNo | No | VPC λ²νΈ | |
| subnetNo | No | μλΈλ· λ²νΈ | |
| serverName | Yes | μλ² μ΄λ¦ | |
| loginKeyName | No | λ‘κ·ΈμΈ ν€ μ΄λ¦ | |
| serverCreateCount | No | μμ±ν μλ² κ°μ (κΈ°λ³Έκ°: 1) | |
| serverProductCode | Yes | μλ² μν μ½λ | |
| serverImageProductCode | Yes | μλ² μ΄λ―Έμ§ μν μ½λ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It discloses nothing beyond the basic create actionβno mention of required VPC/subnet dependencies, provisioning time, billing implications, or failure behavior. This is a significant gap for a creation tool.
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?
The description is a single, direct sentence that immediately states the tool's purpose. There is no filler or redundant content, and the structure is as concise as possible for a simple creation action.
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?
For a creation tool with 7 parameters and no output schema or annotations, the description is minimal. It lacks context about prerequisites (e.g., VPC, subnet, login key), execution semantics (synchronous vs asynchronous), and what the response contains. The schema covers parameters but not operational context.
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?
The input schema provides 100% coverage of all 7 parameters with descriptions. The tool description adds no extra parameter guidance, so the baseline of 3 is appropriate since the schema does the heavy lifting.
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 states 'μλ‘μ΄ μλ² μΈμ€ν΄μ€λ₯Ό μμ±ν©λλ€' (creates a new server instance), which is a specific verb plus resource. It clearly distinguishes from sibling tools like list_servers, delete_server, and create_load_balancer.
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?
The description gives no guidance on when to use this tool versus alternatives, nor does it mention prerequisites or conditions. With many sibling create/list/delete tools, some usage direction is needed but absent.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_subnetB
μλ‘μ΄ μλΈλ·μ μμ±ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| vpcNo | Yes | VPC λ²νΈ | |
| subnet | Yes | μλΈλ· CIDR (μ: 10.0.1.0/24) | |
| zoneCode | Yes | μ‘΄ μ½λ (μ: KR-1) | |
| subnetName | Yes | μλΈλ· μ΄λ¦ | |
| networkAclNo | Yes | Network ACL λ²νΈ | |
| subnetTypeCode | Yes | μλΈλ· νμ μ½λ (PUBLIC/PRIVATE) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must disclose behavioral traits. It only states 'creates,' without mentioning permissions, async behavior, idempotency, or response format. This is a minimal disclosure for a mutation tool.
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?
The description is a single concise sentence with no filler, appropriate for the tool's simplicity and front-loaded with the core action.
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?
While the schema covers parameters, the description lacks critical context for a create operation: no expected output, no side effects, no prerequisite conditions. The absence of an output schema makes this a significant gap.
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?
The schema provides descriptions for all 6 parameters (100% coverage), including an example for CIDR and zone code. The description adds no additional parameter meaning, so the baseline score of 3 applies.
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 'μλ‘μ΄ μλΈλ·μ μμ±ν©λλ€' (Creates a new subnet) uses a specific verb-resource pairing, clearly distinguishing it from sibling tools like list_subnets and delete_subnet.
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?
The description provides no guidance on when to use this tool versus alternatives, no prerequisites (e.g., VPC existence), or exclusions. It only states the basic action, leaving the agent without context for correct invocation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_vpcC
μλ‘μ΄ VPCλ₯Ό μμ±ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| vpcName | Yes | VPC μ΄λ¦ | |
| ipv4CidrBlock | Yes | IPv4 CIDR λΈλ‘ (μ: 10.0.0.0/16) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full responsibility for behavioral disclosure. It only states the creation action without mentioning side effects, permissions, or failure modes, leaving the agent completely in the dark.
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?
The description is a single sentence with no wasted words, making it concise. However, it is minimal and lacks structure beyond the basic statement, so it does not fully earn a 5.
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?
Given the tool has only two parameters and no output schema, the description is extremely minimal. It does not explain expected outcomes, resource provisioning details, or any constraints, leaving the agent under-informed.
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?
The input schema already documents both parameters (vpcName, ipv4CidrBlock) with descriptions, so coverage is 100%. The description adds no additional parameter semantics, but the baseline is 3 due to high schema coverage.
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 'μλ‘μ΄ VPCλ₯Ό μμ±ν©λλ€' clearly states the action (create) and resource (VPC), distinguishing it from sibling tools like delete_vpc and list_vpcs. However, it lacks any scope or additional nuance that would elevate it to a 5.
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?
The description provides no guidance on when to use this tool versus alternatives such as create_subnet, and no prerequisites or conditions are mentioned. It is entirely silent on usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_acgB
ACGλ₯Ό μμ ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| accessControlGroupNo | Yes | ACG λ²νΈ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden for behavioral disclosure. It indicates deletion but does not mention irreversibility, impact on dependent resources, required permissions, or response behavior. This is a significant gap for a mutation tool.
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?
The description is a single, concise sentence with no filler words. It is appropriately sized for the simple operation and front-loaded with the action.
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?
Given the simple operation (one parameter, no output schema), the description is minimally acceptable but lacks usage guidelines and behavioral context. For a delete operation, more detail about consequences or prerequisites would make it more complete.
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?
The schema documents accessControlGroupNo with description 'ACG λ²νΈ' (ACG number), giving 100% schema description coverage. The tool description adds no extra meaning beyond the schema, so baseline 3 is appropriate.
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 'ACGλ₯Ό μμ ν©λλ€' translates to 'Deletes ACG', which clearly states the verb and resource. It is specific and distinguishes from siblings like create_acg, list_acgs, and add_acg_rule.
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?
No guidance is provided on when to use this tool versus alternatives, nor any prerequisites or when-not-to-use conditions. The description solely states the action without contextual usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_cloud_dbB
Cloud DB μΈμ€ν΄μ€λ₯Ό μμ ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| cloudDBInstanceNo | Yes | Cloud DB μΈμ€ν΄μ€ λ²νΈ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full responsibility for behavioral disclosure. It only states 'deletes' without specifying whether deletion is permanent, requires the instance to be stopped, or cascades to associated resources. This is a significant gap for a destructive operation.
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?
The description is a single short sentence that immediately states the action. It is extremely concise and earns a top score for conciseness.
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?
For a simple delete tool, the description is minimal but the lack of any behavioral caveats (e.g., irreversibility, dependencies) leaves it incomplete for an agent evaluating consequences. It does not fully cover the context needed.
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?
The schema has 100% coverage for the single parameter, so the description need not add parameter details. However, it adds no extra semantic value beyond the schema, earning the baseline score.
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 uses a specific verb 'μμ ν©λλ€' (deletes) and clearly identifies the resource as 'Cloud DB μΈμ€ν΄μ€', distinguishing it from sibling delete tools for servers, VPCs, subnets, and load balancers. The intent is unambiguous.
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?
No guidance is provided on when to use this tool, prerequisites, or alternatives. The description simply states the action without any contextual usage direction.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_load_balancerC
λ‘λ λ°Έλ°μλ₯Ό μμ ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| loadBalancerInstanceNo | Yes | λ‘λ λ°Έλ°μ μΈμ€ν΄μ€ λ²νΈ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full responsibility for disclosing behavioral traits. It fails to mention that deletion is permanent, irreversible, or may impact associated resources. This is a significant gap for a destructive operation.
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?
The description is concise (a single sentence) but adds little value beyond restating the tool name. It is not verbose, but the sentence does not earn its place by providing additional information.
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?
Given the simplicity of the tool (one parameter, no output schema), the description is still incomplete for a delete operation. It omits important context such as effect on associated resources, irreversibility, or expected response behavior, which is crucial for an agent to use it correctly.
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?
The schema description covers the only parameter ('Load balancer instance number') with 100% coverage. The tool description adds no additional semantic meaning; it does not elaborate on how the parameter is used or any constraints.
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 clearly states the action ('Deletes the load balancer') with a specific verb and resource. It does not explicitly differentiate from sibling tools, but the action is unambiguous and aligns with 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.
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, prerequisites, or exclusions. The description simply states the action without any context about appropriate usage scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_serverB
μλ² μΈμ€ν΄μ€λ₯Ό μμ ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| serverInstanceNo | Yes | μμ ν μλ² μΈμ€ν΄μ€ λ²νΈ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It merely says 'Deletes' without mentioning permanence, reversibility, prerequisites (e.g., server must be stopped), or impact on associated resources. For a destructive 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.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single, short sentence that is immediately informative and not padded with unnecessary words. It is appropriately sized for the tool's simplicity and front-loads the core action.
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?
The tool has a single parameter and no output schema, but deletion is irreversible. The description lacks essential context such as whether the action is permanent, whether associated resources are affected, or any safety warnings. This makes it incomplete for a destructive operation despite its simplicity.
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?
Schema description coverage is 100% for the single parameter serverInstanceNo, whose description 'μμ ν μλ² μΈμ€ν΄μ€ λ²νΈ' (Server instance number to delete) is clear. The tool description adds no extra parameter meaning, so the baseline score of 3 applies.
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 'μλ² μΈμ€ν΄μ€λ₯Ό μμ ν©λλ€' (Deletes the server instance) clearly states a specific verb (delete) and resource (server instance), distinguishing it from siblings like stop_server, start_server, and create_server.
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?
The description implies usage through the verb 'delete', but provides no explicit when-to-use vs alternatives. Given sibling tools like stop_server and start_server, there is no guidance on when deletion is appropriate versus other lifecycle operations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_subnetC
μλΈλ·μ μμ ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| subnetNo | Yes | μλΈλ· λ²νΈ |
TDQS
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 the subnet is deleted, without mentioning whether the operation is destructive, requires permissions, or has cascading effects. This is a significant transparency gap for a delete operation.
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?
The description is a single, front-loaded sentence with no wasted words. It is efficient and to the point, but the extreme brevity means it lacks necessary context, though that is not penalized under this dimension.
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?
Given that the tool performs a delete operation, the description is highly incomplete. It does not explain the impact (e.g., irreversibility), what happens to associated resources, or what success looks like. With no annotations or output schema, the description alone is insufficient for an agent to understand the full context.
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?
The input schema has 100% coverage for the single parameter 'subnetNo', which is described as 'μλΈλ· λ²νΈ' (subnet number). The description adds no additional meaning beyond the schema, so the baseline of 3 applies.
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 'μλΈλ·μ μμ ν©λλ€' (Deletes the subnet) clearly states the action and resource, but it merely restates the tool name without adding any distinguishing detail. It does not differentiate this delete tool from sibling delete tools (e.g., delete_vpc, delete_acg) beyond the resource name, which is already in 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.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It does not mention any conditions, prerequisites, or scenarios where this tool is appropriate, nor does it exclude any use cases.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_vpcB
VPCλ₯Ό μμ ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| vpcNo | Yes | VPC λ²νΈ |
TDQS
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 only states the delete action but fails to mention side effects (e.g., deletion of associated subnets/ACGs), dependencies, or state requirements, leaving the agent unaware of critical safety aspects.
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?
The description is a single, clear sentence that front-loads the essential information. It is appropriately concise with no redundant or wasteful wording.
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?
For a destructive operation like deleting a VPC, the description is overly minimal. It does not mention what happens to dependent resources (subnets, ACGs, load balancers), whether the VPC must be empty, or return/error behaviors. This incompleteness is risky for safe tool invocation.
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?
The input schema already provides complete coverage for the single parameter (vpcNo with description 'VPC λ²νΈ'), so the description adds no additional parameter semantics. The baseline of 3 applies as the schema does the heavy lifting.
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 states 'VPCλ₯Ό μμ ν©λλ€' (deletes the VPC), clearly specifying both the action (delete) and resource (VPC). This distinguishes it from sibling tools like create_vpc, list_vpcs, and delete_subnet.
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?
The description provides no guidance on when to use this tool versus alternatives, no prerequisites (e.g., VPC must be empty), and no caution about irreversibility. It simply states the function without any contextual instructions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_server_detailB
νΉμ μλ² μΈμ€ν΄μ€μ μμΈ μ 보λ₯Ό μ‘°νν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| serverInstanceNo | Yes | μλ² μΈμ€ν΄μ€ λ²νΈ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. However, it does not disclose any behavioral traits such as response format, required permissions, or side effects beyond the basic action of retrieving information.
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?
The description is a single, efficient sentence in Korean, clearly stating the purpose without any unnecessary words. It is well-structured and front-loaded.
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?
For a simple read operation with one parameter, the description is minimally viable but lacks explanation of what 'detailed information' includes or any usage constraints. It adequately conveys the core function but leaves gaps in expected response details.
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?
The schema already documents the single parameter with 100% coverage, providing its name and description. The tool description does not add additional meaning or context beyond what the schema provides.
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 clearly states the tool retrieves detailed information for a specific server instance, using a specific verb and resource. It distinguishes itself from sibling list operations like list_servers by specifying 'νΉμ ' (specific) instance.
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?
No guidance is provided on when to use this tool versus alternatives such as list_servers or other lifecycle tools. The usage context is only implied by the purpose, with no explicit when-to-use or when-not-to-use instructions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_acgsB
ACG(Access Control Group) λͺ©λ‘μ μ‘°νν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| vpcNo | No | VPC λ²νΈ (μ νμ¬ν) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, and the description only says 'retrieve list' without disclosing read-only behavior, pagination, or any side effects. It also fails to mention that the vpcNo parameter filters results, which is important behavioral context.
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?
The description is a single, clear sentence with no wasted words. It is appropriately concise for a simple list operation and is easy to parse quickly.
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?
The tool is simple with one optional parameter, but there is no output schema, and the description does not explain the return value or any limitations. It is adequate but lacks details like whether a list of ACG objects or IDs is returned.
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?
The schema fully documents the single parameter vpcNo with 'VPC number (optional)', giving 100% coverage. The description adds no additional parameter meaning, so it does not exceed the baseline.
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 clearly states 'Retrieves the list of ACG (Access Control Group)', providing a specific verb and resource. However, it does not differentiate from sibling list tools like list_servers or list_vpcs, so it stops short of a full 5.
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 guidance on when to use this tool versus alternatives. It does not mention whether to use it before creating/deleting ACGs or how the optional vpcNo filter should be used, leaving usage entirely implied.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_cloud_dbsA
Cloud DB μΈμ€ν΄μ€ λͺ©λ‘μ μ‘°νν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
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 only states that it retrieves a list, but does not disclose any limitations, return format, or side effects (e.g., whether it returns all instances, pagination, or requires auth). The description essentially restates the tool's name without adding meaningful behavioral context.
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?
The description is a single, concise sentence that is front-loaded with the essential information. It wastes no words and is directly relevant to the tool's function.
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?
Given the simplicity of the tool (no parameters, no output schema), the description is minimally adequate for basic invocation. However, it lacks details about the response structure or potential limitations, which would help the agent interpret results. The description is complete enough for a trivial list operation but could be improved.
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?
The tool has zero parameters, and the schema coverage is 100% (vacuously). With no parameters to describe, the baseline is 4, and the description does not need to explain parameter semantics. It does not add any conflicting or redundant information.
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 clearly states the action (μ‘°ν/retrieve) and the resource (Cloud DB μΈμ€ν΄μ€ λͺ©λ‘ = list of Cloud DB instances). It is specific and distinguishes this tool from sibling list tools like list_servers and list_load_balancers, which target different resources.
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?
The description provides no guidance on when to use this tool versus alternatives, nor does it mention prerequisites, filters, or exclusions. It is only a bare statement of the tool's function, leaving the agent without decision-making context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_load_balancersA
λ‘λ λ°Έλ°μ λͺ©λ‘μ μ‘°νν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It only states that it retrieves a list; it does not disclose whether it returns all load balancers, any scoping, read-only nature, or response behavior. For a read-only list tool, the description adds minimal behavioral context beyond the literal action.
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?
The description is a single, short, direct sentence with no unnecessary words. It is effectively front-loaded and earns its place by conveying the core purpose.
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?
The tool is simple with no parameters and no output schema, but the description does not provide any context about the returned data or the scope of the list. Without an output schema, the description should compensate by hinting at what fields or information is included, but it remains purely a bare statement of intent.
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?
The tool has zero parameters and schema description coverage is 100% (vacuously). Per the baseline, a 0-param tool earns a 4. The description adds no parameter details because there are none to describe.
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 clearly states a specific action (μ‘°νν©λλ€/retrieves) and a specific resource (λ‘λ λ°Έλ°μ λͺ©λ‘/list of load balancers). It distinguishes itself from sibling tools by being the list operation for load balancers, separate from create/delete/add operations.
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?
The usage is implied: use this tool when you need to see the list of load balancers. However, there is no explicit guidance on when to use this vs. alternatives, no exclusions, and no mention of related detail tools. It is not misleading, but it lacks proactive direction.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_serversA
NCPμ λͺ¨λ μλ² μΈμ€ν΄μ€ λͺ©λ‘μ μ‘°νν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| regionCode | No | 리μ μ½λ (μ: KR, JP) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full transparency burden, but it only states the basic listing action. It does not disclose that the operation is read-only, how the optional regionCode parameter affects results, or any pagination or output format details, leaving significant behavioral ambiguity.
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?
The description is a single, efficient sentence that immediately states the action and object. There is no redundancy or unnecessary detail, making it highly concise and front-loaded.
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?
For a simple list tool, the description is minimally acceptable but incomplete: it does not describe the return format, pagination, or the behavioral effect of the regionCode parameter. Since there is no output schema, the description should provide a bit more context to be fully complete.
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?
The input schema already documents regionCode with a description and example, giving 100% coverage, so the baseline is 3. The tool description adds no additional meaning and even creates slight ambiguity with the word 'all' relative to the optional regionCode filter.
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 uses a clear verb ('μ‘°νν©λλ€' - retrieves/lists) and specifies the resource ('server instances'), making it obvious that this tool lists all server instances. This distinguishes it from siblings like get_server_detail (single server) and create_server/delete_server/stop_server/start_server (mutations).
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?
The description gives no explicit guidance on when to use list_servers versus alternatives, such as when to use get_server_detail or list_vpcs. Usage is implied by the tool name and purpose, but 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.
list_subnetsB
μλΈλ· λͺ©λ‘μ μ‘°νν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| vpcNo | No | VPC λ²νΈ (μ νμ¬ν) |
TDQS
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. It implies read-only behavior via 'μ‘°ν' but does not mention pagination, authentication, or the effect of the optional vpcNo parameter, leaving important behavioral context undisclosed.
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?
The description is a single, front-loaded sentence with no filler words. It is compact and easy to parse, though it is slightly redundant with the tool name.
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?
For a simple list tool with one optional parameter, the description conveys the core action and implies a list return value. However, without annotations or an output schema, it lacks details on return structure and filtering behavior, making it only minimally complete.
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?
The only parameter, vpcNo, is fully described in the input schema as an optional VPC number. The description adds no additional meaning about how this parameter affects the request, so it does not go 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 'μλΈλ· λͺ©λ‘μ μ‘°νν©λλ€' clearly states a list/retrieve action on subnet resources. It distinguishes from sibling tools like create_subnet and delete_subnet by indicating a read-only listing operation.
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?
No guidance is provided on when to use this tool versus alternatives. The description simply states the action, with no mention of VPC filtering behavior or exclusions relative to list_vpcs or other list_* tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_vpcsA
VPC λͺ©λ‘μ μ‘°νν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It only states 'retrieve the list' without mentioning return format, pagination, permissions, or any side effects. For a list operation, this leaves significant ambiguity about what the agent will receive.
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?
The description is a single, concise sentence in Korean that directly conveys the purpose without any wasted words. It is front-loaded and easy to parse.
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?
The tool is simple with no parameters and no output schema. The description covers the core function but does not specify the shape of the returned data or any constraints. For a basic list operation, it is minimally adequate but could be more informative.
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?
The input schema has zero parameters, so the description does not need to explain parameters. The baseline for 0 params is 4, and there is nothing for the description to add beyond what the schema already covers.
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 clearly states the action 'μ‘°νν©λλ€' (retrieve) and the resource 'VPC λͺ©λ‘' (VPC list). This distinguishes it from sibling tools like list_load_balancers and list_servers, which target different resources.
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?
The usage is implied by the tool name and description: use this when you need to list VPCs. However, it provides no explicit alternatives or exclusions, though the sibling tools for other resources make the context clear enough.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
start_serverA
μ€μ§λ μλ² μΈμ€ν΄μ€λ₯Ό μμν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| serverInstanceNo | Yes | μμν μλ² μΈμ€ν΄μ€ λ²νΈ |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full responsibility for behavioral disclosure. It only states the action without mentioning potential side effects, required permissions, failure conditions, or whether the operation is asynchronous. This is a significant gap for a state-changing tool.
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?
The description is a single, front-loaded sentence with no wasted words. It conveys the action and target state efficiently.
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?
Given the simplicity (one required parameter, no output schema, no annotations), the description is minimally adequate but lacks details about expected return values or behavioral nuances like asynchronous completion. It is not incomplete enough to warrant a 2, but it does not go beyond the bare minimum.
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?
Schema description coverage is 100%βthe parameter 'serverInstanceNo' is already described as the server instance number to start. The tool description adds no additional parameter meaning, so the baseline score of 3 is appropriate.
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 clearly states it starts a stopped server instance, using a specific verb and resource. It also distinguishes from sibling tools like create_server and stop_server by explicitly targeting the 'stopped' state, making its purpose unambiguous.
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?
The description provides clear context by specifying that it applies to stopped server instances, implying the appropriate use case. However, it does not explicitly mention alternatives or provide exclusionary guidance (e.g., 'not for creating new servers'), so it falls short of a 5.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
stop_serverA
μ€ν μ€μΈ μλ² μΈμ€ν΄μ€λ₯Ό μ€μ§ν©λλ€
| Name | Required | Description | Default |
|---|---|---|---|
| serverInstanceNo | Yes | μ€μ§ν μλ² μΈμ€ν΄μ€ λ²νΈ |
TDQS
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 states the core action and does not mention side effects, prerequisites, or what happens to the server after stopping (e.g., whether it's a graceful shutdown or force stop).
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?
The description is a single, clear sentence with no superfluous words. It is perfectly concise and front-loaded with the action.
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?
For a simple one-parameter tool with no output schema, the description is adequate but minimal. It does not explain return values or potential error conditions, but the simplicity of the operation makes this less critical.
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?
Schema description coverage is 100% β the only parameter, serverInstanceNo, is adequately described in the schema. The description adds no additional parameter meaning, 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.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('μ€μ§ν©λλ€' = stops) and the specific resource ('μ€ν μ€μΈ μλ² μΈμ€ν΄μ€' = running server instance). It distinguishes this from siblings like start_server and delete_server by specifying the running state.
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?
The usage is implied: when you need to stop a running server. However, it does not explicitly mention alternatives or exclusions, such as noting that start_server is the complementary action or that delete_server should be used for permanent removal.
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.
23 tool updates
v1.0.0- First observed
add_acg_rule - First observed
add_load_balancer_target - First observed
create_acg - First observed
create_cloud_db - First observed
create_load_balancer - First observed
create_server - First observed
create_subnet - First observed
create_vpc - First observed
delete_acg - First observed
delete_cloud_db - First observed
delete_load_balancer - First observed
delete_server - First observed
delete_subnet - First observed
delete_vpc - First observed
get_server_detail - First observed
list_acgs - First observed
list_cloud_dbs - First observed
list_load_balancers - First observed
list_servers - First observed
list_subnets - First observed
list_vpcs - First observed
start_server - First observed
stop_server
TDQS
Scored across 23 tools
Each tool name clearly identifies a specific resource and action (e.g., list_servers vs. create_server). No two tools overlap in purpose, and the verbs (list, get, create, delete, etc.) disambiguate operations within the same resource type.
All tools follow a consistent verb_noun pattern in snake_case (e.g., list_vpcs, create_subnet). There are no deviations in style or convention.
With 23 tools spanning six resource types, the count feels heavy but is reasonable for the scope. The number is on the high end of the acceptable range, but each tool serves a distinct purpose.
Core lifecycle operations (create, read/list, delete) exist for most resources, but update/modify operations are missing entirely. Additionally, there are no get_detail tools for VPCs, subnets, ACGs, load balancers, or Cloud DBs, and some specific actions like removing ACG rules or load balancer targets are absent.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Deploy, monitor, and manage your OpenClaw AI assistants via natural language.
Your AI Agent's Infrastructure Layer. Connect Claude, Copilot, Codex, or ChatGPT to 200+ managed open source services. Start databases, pipelines, and applications through natural language.
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Build and manage AI-native customer support agents from Claude or any MCP client.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables managing Google Cloud Platform resources through natural language commands in Claude Desktop, supporting comprehensive operations across compute, storage, databases, networking, monitoring, and IAM without manual credential setup.5620-
- -licenseNot gradedqualityNot gradedmaintenanceEnables AI-powered infrastructure management of JavaScript applications via natural language commands, allowing users to deploy, configure, and manage cloud services through Claude Desktop.4-
- FlicenseBqualityDmaintenanceEnables conversational management of Naver Cloud Platform infrastructure through Claude Desktop, allowing users to create, query, and manage cloud resources like servers, VPCs, load balancers, and databases using natural language.23-
- AlicenseAqualityDmaintenanceEnables AI assistants to discover and invoke KakaoCloud OpenAPI endpoints for managing cloud resources like VMs, VPCs, load balancers, and databases.51MIT