Skip to main content
Glama

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-server

2. μ˜μ‘΄μ„± μ„€μΉ˜

npm install

3. ν™˜κ²½ λ³€μˆ˜ μ„€μ •

.env νŒŒμΌμ„ μƒμ„±ν•˜κ³  NCP API ν‚€λ₯Ό μ„€μ •ν•©λ‹ˆλ‹€:

NCP_ACCESS_KEY=your_access_key_here
NCP_SECRET_KEY=your_secret_key_here

4. λΉŒλ“œ

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 tools
add_acg_ruleB

ACG에 μΈλ°”μš΄λ“œ κ·œμΉ™μ„ μΆ”κ°€ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
ipBlockNoIP 블둝 (예: 0.0.0.0/0)
portRangeNo포트 λ²”μœ„ (예: 80, 1-65535)
protocolTypeCodeYesν”„λ‘œν† μ½œ νƒ€μž… (TCP/UDP/ICMP)
accessControlGroupNoYesACG 번호

TDQS

B3.2/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. 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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines2/5

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

λ‘œλ“œ λ°ΈλŸ°μ„œμ— νƒ€κ²Ÿ μ„œλ²„λ₯Ό μΆ”κ°€ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
serverInstanceNoListYesμ„œλ²„ μΈμŠ€ν„΄μŠ€ 번호 리슀트
loadBalancerInstanceNoYesλ‘œλ“œ λ°ΈλŸ°μ„œ μΈμŠ€ν„΄μŠ€ 번호

TDQS

C2.9/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. 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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
vpcNoYesVPC 번호
accessControlGroupNameYesACG 이름
accessControlGroupDescriptionNoACG μ„€λͺ…

TDQS

B3.1/5.0
Behavior1/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose5/5

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.

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 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 μΈμŠ€ν„΄μŠ€λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
vpcNoNoVPC 번호
subnetNoNoμ„œλΈŒλ„· 번호
cloudDBProductCodeYesμƒν’ˆ μ½”λ“œ
cloudDBServerCountYesμ„œλ²„ 개수
cloudDBServiceNameYesCloud DB μ„œλΉ„μŠ€ 이름
dataStorageTypeCodeYesμŠ€ν† λ¦¬μ§€ νƒ€μž… μ½”λ“œ
cloudDBImageProductCodeYes이미지 μƒν’ˆ μ½”λ“œ
cloudDBServerNamePrefixYesμ„œλ²„ 이름 접두사

TDQS

B3.1/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines2/5

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

μƒˆλ‘œμš΄ λ‘œλ“œ λ°ΈλŸ°μ„œλ₯Ό μƒμ„±ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
vpcNoNoVPC 번호
subnetNoListNoμ„œλΈŒλ„· 번호 리슀트
loadBalancerNameYesλ‘œλ“œ λ°ΈλŸ°μ„œ 이름
loadBalancerAlgorithmTypeCodeYesμ•Œκ³ λ¦¬μ¦˜ νƒ€μž… (RR/LC/SIPHS)

TDQS

C2.6/5.0
Behavior1/5

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.

Conciseness3/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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

μƒˆλ‘œμš΄ μ„œλ²„ μΈμŠ€ν„΄μŠ€λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
vpcNoNoVPC 번호
subnetNoNoμ„œλΈŒλ„· 번호
serverNameYesμ„œλ²„ 이름
loginKeyNameNo둜그인 ν‚€ 이름
serverCreateCountNo생성할 μ„œλ²„ 개수 (κΈ°λ³Έκ°’: 1)
serverProductCodeYesμ„œλ²„ μƒν’ˆ μ½”λ“œ
serverImageProductCodeYesμ„œλ²„ 이미지 μƒν’ˆ μ½”λ“œ

TDQS

B3.2/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. 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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines2/5

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

μƒˆλ‘œμš΄ μ„œλΈŒλ„·μ„ μƒμ„±ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
vpcNoYesVPC 번호
subnetYesμ„œλΈŒλ„· CIDR (예: 10.0.1.0/24)
zoneCodeYesμ‘΄ μ½”λ“œ (예: KR-1)
subnetNameYesμ„œλΈŒλ„· 이름
networkAclNoYesNetwork ACL 번호
subnetTypeCodeYesμ„œλΈŒλ„· νƒ€μž… μ½”λ“œ (PUBLIC/PRIVATE)

TDQS

B3.2/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines2/5

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λ₯Ό μƒμ„±ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
vpcNameYesVPC 이름
ipv4CidrBlockYesIPv4 CIDR 블둝 (예: 10.0.0.0/16)

TDQS

C2.5/5.0
Behavior1/5

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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines1/5

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λ₯Ό μ‚­μ œν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
accessControlGroupNoYesACG 번호

TDQS

B3.3/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 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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose5/5

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.

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 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 μΈμŠ€ν„΄μŠ€λ₯Ό μ‚­μ œν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
cloudDBInstanceNoYesCloud DB μΈμŠ€ν„΄μŠ€ 번호

TDQS

B3.2/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose5/5

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.

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, 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

λ‘œλ“œ λ°ΈλŸ°μ„œλ₯Ό μ‚­μ œν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
loadBalancerInstanceNoYesλ‘œλ“œ λ°ΈλŸ°μ„œ μΈμŠ€ν„΄μŠ€ 번호

TDQS

C2.8/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 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.

Conciseness3/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

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, 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

μ„œλ²„ μΈμŠ€ν„΄μŠ€λ₯Ό μ‚­μ œν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
serverInstanceNoYesμ‚­μ œν•  μ„œλ²„ μΈμŠ€ν„΄μŠ€ 번호

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 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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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

μ„œλΈŒλ„·μ„ μ‚­μ œν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
subnetNoYesμ„œλΈŒλ„· 번호

TDQS

C2.6/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 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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose3/5

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.

Usage Guidelines2/5

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λ₯Ό μ‚­μ œν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
vpcNoYesVPC 번호

TDQS

B3.2/5.0
Behavior2/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 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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines2/5

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

νŠΉμ • μ„œλ²„ μΈμŠ€ν„΄μŠ€μ˜ 상세 정보λ₯Ό μ‘°νšŒν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
serverInstanceNoYesμ„œλ²„ μΈμŠ€ν„΄μŠ€ 번호

TDQS

B3.3/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. 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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose5/5

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.

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 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) λͺ©λ‘μ„ μ‘°νšŒν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
vpcNoNoVPC 번호 (선택사항)

TDQS

B3.1/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose4/5

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.

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. 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 μΈμŠ€ν„΄μŠ€ λͺ©λ‘μ„ μ‘°νšŒν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/5.0
Behavior2/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 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.

Conciseness5/5

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.

Completeness3/5

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.

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 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.

Purpose5/5

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.

Usage Guidelines2/5

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

λ‘œλ“œ λ°ΈλŸ°μ„œ λͺ©λ‘μ„ μ‘°νšŒν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.6/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. 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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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의 λͺ¨λ“  μ„œλ²„ μΈμŠ€ν„΄μŠ€ λͺ©λ‘μ„ μ‘°νšŒν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
regionCodeNo리전 μ½”λ“œ (예: KR, JP)

TDQS

A3.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 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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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

μ„œλΈŒλ„· λͺ©λ‘μ„ μ‘°νšŒν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
vpcNoNoVPC 번호 (선택사항)

TDQS

B3.2/5.0
Behavior2/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. 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.

Conciseness4/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose5/5

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.

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 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 λͺ©λ‘μ„ μ‘°νšŒν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/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. 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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters4/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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

μ€‘μ§€λœ μ„œλ²„ μΈμŠ€ν„΄μŠ€λ₯Ό μ‹œμž‘ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
serverInstanceNoYesμ‹œμž‘ν•  μ„œλ²„ μΈμŠ€ν„΄μŠ€ 번호

TDQS

A3.7/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 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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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

μ‹€ν–‰ 쀑인 μ„œλ²„ μΈμŠ€ν„΄μŠ€λ₯Ό μ€‘μ§€ν•©λ‹ˆλ‹€

ParametersJSON Schema
NameRequiredDescriptionDefault
serverInstanceNoYes쀑지할 μ„œλ²„ μΈμŠ€ν„΄μŠ€ 번호

TDQS

A3.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 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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines3/5

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.

  1. 23 tool updatesv1.0.0
    • First observedadd_acg_rule
    • First observedadd_load_balancer_target
    • First observedcreate_acg
    • First observedcreate_cloud_db
    • First observedcreate_load_balancer
    • First observedcreate_server
    • First observedcreate_subnet
    • First observedcreate_vpc
    • First observeddelete_acg
    • First observeddelete_cloud_db
    • First observeddelete_load_balancer
    • First observeddelete_server
    • First observeddelete_subnet
    • First observeddelete_vpc
    • First observedget_server_detail
    • First observedlist_acgs
    • First observedlist_cloud_dbs
    • First observedlist_load_balancers
    • First observedlist_servers
    • First observedlist_subnets
    • First observedlist_vpcs
    • First observedstart_server
    • First observedstop_server

TDQS

B3.2/5.0

Scored across 23 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count3/5

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.

Completeness3/5

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

ActivitySlowing
ResponsivenessNo issues

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

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    Enables 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.
    56
    20
    -
  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI-powered infrastructure management of JavaScript applications via natural language commands, allowing users to deploy, configure, and manage cloud services through Claude Desktop.
    4
    -
  • F
    license
    B
    quality
    D
    maintenance
    Enables 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
    -