Skip to main content
Glama

ovice MCP Server

このリポジトリについて

ローカル環境でMCPサーバーを構築する個人的な検証のための非公式なリポジトリです(動作保証いたしかねます)

ovice API と連携し、ワークスペース、グループ、ユーザー管理や通知機能を提供するMCPサーバーです。

Related MCP server: ServiceNow MCP Server

機能概要

このMCPサーバーは以下の機能を提供します:

  • ワークスペース管理: 組織内のワークスペース一覧取得、ユーザー一覧、アクセスURL生成

  • グループ管理: 組織内のグループ一覧取得、メンバー管理

  • 通知機能: 組織、ワークスペース、グループへの通知送信

  • 情報取得: スペース名の取得など

初期設定

Claude Desktop

設定ファイルを編集してMCPサーバーを登録します。

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ovice-mcp-server": {
      "command": "npx",
      "args": ["github:cti1650/ovice-mcp-server"],
      "env": {
        "OVICE_DOMAIN": "api.ovice.com",
        "OVICE_CLIENT_ID": "your-client-id",
        "OVICE_CLIENT_SECRET": "your-client-secret",
        "OVICE_ORGANIZATION_ID": "your-organization-id",
        "OVICE_SERVICE_NAME": "Your Service Name",
        "OVICE_SERVICE_LOGO_URL": "https://your-logo-url.com/logo.svg"
      }
    }
  }
}

環境変数

変数名

必須

デフォルト値

説明

OVICE_CLIENT_ID

-

oVice APIクライアントID

OVICE_CLIENT_SECRET

-

oVice APIクライアントシークレット

OVICE_ORGANIZATION_ID

-

組織ID

OVICE_DOMAIN

-

"api.ovice.com"

oVice APIドメイン(本番環境以外では変更が必要)

OVICE_SERVICE_NAME

-

"This is demo"

通知に表示されるサービス名

OVICE_SERVICE_LOGO_URL

-

oViceロゴURL

通知に表示されるサービスロゴURL

利用可能なツール

ワークスペース関連

get_organization_workspaces

  • 説明: 組織のワークスペース一覧を取得

  • パラメータ: なし

  • 戻り値: ワークスペース一覧(JSON形式)

get_workspace_users

  • 説明: 指定したワークスペースのユーザー一覧を取得

  • パラメータ:

    • workspaceId (string): ワークスペースID

  • 戻り値: ユーザー一覧(JSON形式)

get_space_name_by_id

  • 説明: スペースIDからスペース名を取得

  • パラメータ:

    • spaceId (string): スペースID

  • 戻り値: スペース名

get_workspace_access_path

  • 説明: ワークスペースにアクセスするためのURLを生成

  • パラメータ:

    • workspaceId (string): ワークスペースID

  • 戻り値: アクセスURL (https://{appDomain}/ws/{workspaceDomain}/)

  • 備考: APIからワークスペース情報を取得し、ドメインベースのURLを生成

グループ関連

get_organization_groups

  • 説明: 組織のグループ一覧を取得

  • パラメータ: なし

  • 戻り値: グループ一覧(JSON形式)

get_group_members

  • 説明: 指定したグループのメンバー一覧を取得

  • パラメータ:

    • groupId (string): グループID

  • 戻り値: メンバー一覧(JSON形式)

通知機能

send_organization_notification

  • 説明: 組織全体に通知を送信

  • パラメータ:

    • message (string): 通知メッセージ

    • serviceName (string, optional): サービス名

    • serviceLogoUrl (string, optional): サービスロゴURL

  • 戻り値: 送信結果(JSON形式)

send_workspace_notification

  • 説明: 特定のワークスペースに通知を送信

  • パラメータ:

    • workspaceId (string): ワークスペースID

    • auth (array): 通知対象の権限レベル ("admin", "member", "visitor", "guest")

    • message (string): 通知メッセージ

    • serviceName (string, optional): サービス名

    • serviceLogoUrl (string, optional): サービスロゴURL

  • 戻り値: 送信結果(JSON形式)

send_group_notification

  • 説明: 特定のグループに通知を送信

  • パラメータ:

    • groupId (string): グループID

    • message (string): 通知メッセージ

    • serviceName (string, optional): サービス名

    • serviceLogoUrl (string, optional): サービスロゴURL

  • 戻り値: 送信結果(JSON形式)

API仕様

このMCPサーバーは oVice Public API v1 を使用します:

  • エンドポイント: https://{OVICE_DOMAIN}/api/public/v1/

  • 認証: クライアントIDとクライアントシークレットによるヘッダー認証

エラーハンドリング

  • 環境変数が不足している場合は適切なエラーメッセージを表示

  • API呼び出し失敗時はHTTPステータスコードとエラー詳細を返却

  • 指定されたリソース(ワークスペース、グループなど)が見つからない場合は専用のエラーメッセージを表示

参考サイト

Available Tools

9 tools
get_group_membersB

グループのメンバー一覧を取得する

ParametersJSON Schema
NameRequiredDescriptionDefault
groupIdYesグループID

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 of disclosing behavior. It only states the action, omitting details such as required permissions, response format, pagination, 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 concise sentence in Japanese, front-loaded with the action, and contains no unnecessary words.

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 a single parameter and no output schema, the description is minimally viable but lacks mention of return value structure or edge cases. It does not provide additional context beyond the basic purpose.

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 covers 100% of parameters with a description for groupId. The tool description adds no further parameter semantics, 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 clearly states 'Get the list of group members' using a specific verb and resource. It distinguishes from siblings such as get_workspace_users or get_organization_groups by targeting group members specifically.

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

Usage Guidelines2/5

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

No guidance is given on when to use this tool versus alternatives. It does not mention exclusions or context, leaving the agent to infer usage from the name and description.

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

get_organization_groupsB

組織のグループ一覧を取得する

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/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. It only says '取得する' (retrieve), implying a read operation, but does not disclose details like whether it returns all groups, requires specific permissions, or any side effects.

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 is entirely front-loaded and contains no filler. It efficiently conveys the tool's purpose in the minimum words needed.

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 no output schema and no annotations, so the description must explain the response shape or behavior. It does not mention what the returned list contains, whether it includes all groups, or any pagination/limits, leaving the agent to infer.

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?

With zero parameters, the schema already fully documents the absence of inputs. The baseline for 0 parameters is 4, and the description adds no parameter-related meaning, which is acceptable since there are none.

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

Purpose4/5

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

The description states a specific verb and resource: '組織のグループ一覧を取得する' (retrieve the organization's group list). It is clear about the operation, though it does not explicitly distinguish from siblings like get_organization_workspaces or get_group_members.

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 usage guidance is provided. The description does not indicate when to prefer this tool over alternatives, such as get_organization_workspaces for workspaces or get_group_members for group contents.

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

get_organization_workspacesB

組織のワークスペース一覧を取得する

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.2/5.0
Behavior2/5

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

With no annotations, the description carries full behavioral transparency burden, but it only states the function without disclosing permissions, pagination, or whether it returns all workspaces or only accessible ones. The verb '取得' implies a read operation, but no further behavioral details are provided.

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, focused sentence in Japanese, with no filler or redundancy. It is appropriately sized for a simple get-list tool.

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

Completeness3/5

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

The description is minimal and covers the basic purpose, but with no output schema or annotations, it lacks details about the return format, workspace object fields, or any filtering/pagination behavior. It is adequate for a trivial tool but not comprehensive.

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?

There are no parameters to document, so the description's lack of parameter information is not a gap. The baseline of 4 is appropriate for zero-parameter tools.

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

Purpose4/5

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

The description uses the specific verb '取得する' (retrieve) and names the resource '組織のワークスペース一覧' (organization's workspace list), making the core function clear. However, it does not differentiate from sibling tools like get_workspace_users or get_organization_groups, though the name itself provides some differentiation.

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 alternative sibling tools. There is no mention of prerequisites, context, or exclusions.

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

get_space_name_by_idB

スペースIDからスペース名を取得する

ParametersJSON Schema
NameRequiredDescriptionDefault
spaceIdYesスペースID

TDQS

B3.3/5.0
Behavior2/5

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

With no annotations provided, the description must carry the full burden of behavioral disclosure. It only states the basic operation and does not mention read-only nature, potential errors, or any side effects. While the getter nature is obvious, no additional context is provided.

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, brief sentence with no redundant words. It is concise and clearly structured, earning a perfect score for conciseness.

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 lookup tool, the description is adequate but lacks explicit specification of the return value format or error conditions. Since there is no output schema, the description would benefit from stating that it returns a string (the space name), but the implied meaning is clear enough for a minimal viable description.

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 fully describes the single parameter (spaceId as 'スペースID'), with 100% schema coverage. The tool description adds no additional meaning about the parameter, such as format, length, or constraints, 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 uses the specific verb '取得する' (retrieve) and states the resource 'スペース名' (space name) along with the input 'スペースID'. This clearly distinguishes it from sibling tools that deal with workspaces, users, groups, or notifications.

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 compared to alternatives, nor does it mention any prerequisites or context. It simply states the function without any usage instructions or exclusions.

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

get_workspace_access_pathC

ワークスペースにアクセスするためのパスを返す

ParametersJSON Schema
NameRequiredDescriptionDefault
workspaceIdYesワークスペースID

TDQS

C2.9/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 disclosing behavior. It only says 'returns the path' and gives no details about output format, error cases, or side effects. For a simple getter this may suffice, but the absence of any behavioral context is notable.

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 concise sentence, front-loaded with the key action. It is efficient with no filler, though the brevity borders on under-specification.

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

Completeness2/5

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

For a tool with no output schema and no annotations, the description should explain the return value more precisely. 'Path' is vague and could mean multiple things. The description lacks enough context for an agent to confidently interpret the result.

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 workspaceId with a simple description 'ワークスペースID'. The tool description adds no extra meaning beyond that, so the baseline of 3 applies. It does not explain how workspaceId is used or formatted.

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

Purpose4/5

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

The description states a clear verb and resource: 'returns the path for accessing the workspace.' This distinguishes it from sibling tools that list workspace users or organization workspaces. However, 'path' is somewhat ambiguous (URL, filesystem path, API path), preventing a perfect score.

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, fallback tools, or typical scenarios. This is a clear gap given the sibling toolset.

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

get_workspace_usersB

ワークスペースのユーザー一覧を取得する

ParametersJSON Schema
NameRequiredDescriptionDefault
workspaceIdYesワークスペースID

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 bears the full burden of behavioral disclosure. It only states the basic read action, with no mention of pagination, result format, permissions, or edge cases.

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 verb and resource. Every word is useful and there is no wasted space.

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, but without an output schema, the description should at least indicate the expected return (e.g., a list of user objects) or any other context. It does not, making the description incomplete for an agent to fully understand the tool's behavior.

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 coverage (100%) for the single required parameter workspaceId, so the baseline is 3. The description does not add any extra semantic meaning beyond what the schema already 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 action (get) and the resource (workspace user list), which is specific and distinct from sibling tools like get_group_members or get_organization_workspaces. It leaves no doubt about what the tool does.

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. It does not mention any exclusions or prerequisites, and the sibling tools are not referenced.

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

send_group_notificationB

グループに通知を送信する

ParametersJSON Schema
NameRequiredDescriptionDefault
groupIdYesグループID
messageYes通知メッセージ
serviceNameNoサービス名(環境変数 OVICE_SERVICE_NAME で設定可能)
serviceLogoUrlNoサービスロゴURL(環境変数 OVICE_SERVICE_LOGO_URL で設定可能)

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 transparency. It only states 'send a notification to a group' without disclosing side effects, permission requirements, delivery behavior, or reversibility. This is insufficient 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, clear sentence with no redundant or filler words. It is front-loaded and concise, earning its place without waste. The extreme brevity is not penalized here because it is not tautological.

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 4 parameters, no output schema, and no annotations. The description only covers the basic action and target, omitting any context about optional parameters (serviceName, serviceLogoUrl), behavior, or when to use it. Given the tool's complexity, the description is incomplete.

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 4 parameters, achieving 100% coverage. The tool description adds no additional meaning beyond the schema, so the baseline score of 3 applies. The schema descriptions are minimal but present.

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 sends a notification to a group, with a specific verb (送信する) and resource (グループ). It distinguishes from sibling tools like send_organization_notification and send_workspace_notification by specifically targeting groups.

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. There is no mention of prerequisites, exclusions, or preference scenarios. The description only states the action, not the context of use.

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

send_organization_notificationC

組織に通知を送信する

ParametersJSON Schema
NameRequiredDescriptionDefault
messageYes通知メッセージ
serviceNameNoサービス名(環境変数 OVICE_SERVICE_NAME で設定可能)
serviceLogoUrlNoサービスロゴURL(環境変数 OVICE_SERVICE_LOGO_URL で設定可能)

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 of behavioral disclosure, but it only says 'send notification to organization'. It does not mention permission requirements, whether the message goes to all organization members, delivery guarantees, rate limits, or result/error behavior. The basic side effect is clear, but meaningful behavioral transparency is absent.

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

Conciseness5/5

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

The description is a single short sentence with no filler or redundancy. It is front-loaded and all content is relevant, though minimal.

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 state-changing tool with no annotations and no output schema, the description is quite thin. It omits target audience, expected return behavior, and usage context beyond the bare action. The parameter schema helps, but the overall description is not complete enough for confident invocation decisions.

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%: message is clearly described as the notification content, and serviceName/serviceLogoUrl are optional with environment variable fallbacks. The description itself adds no parameter-level detail, but the schema already documents all parameters, so the baseline 3 applies.

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 Japanese description '組織に通知を送信する' clearly states the action (send notification) and target (organization), so the tool's purpose is easy to grasp. It does not explicitly contrast with send_workspace_notification or send_group_notification, but the org target does distinguish it among sibling tools. It adds little beyond the tool name, so it stops short of a 5.

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool instead of send_workspace_notification or send_group_notification. There are no conditions, exclusions, or alternative tool mentions. The agent must rely solely on the tool name to infer targeting semantics.

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

send_workspace_notificationC

ワークスペースに通知を送信する

ParametersJSON Schema
NameRequiredDescriptionDefault
authYes通知対象の権限レベル
messageYes通知メッセージ
serviceNameNoサービス名(環境変数 OVICE_SERVICE_NAME で設定可能)
workspaceIdYesワークスペースID
serviceLogoUrlNoサービスロゴURL(環境変数 OVICE_SERVICE_LOGO_URL で設定可能)

TDQS

C2.7/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, but it only says 'send a notification to workspace' with no mention of side effects, permission requirements, scope of recipients, or return behavior. This provides essentially no transparency beyond the action itself.

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 or repetition, effectively front-loading 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?

Given the absence of annotations, output schema, and any behavioral explanation, the description is too sparse for an agent to fully understand invocation context, such as what happens after sending or what permissions are required. The schema fills some gaps, but the overall context remains incomplete.

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 describes all 5 parameters with 100% coverage (e.g., auth as '通知対象の権限レベル', message as '通知メッセージ'), so the baseline is 3. The description adds no additional parameter semantics, and the schema descriptions are terse but minimally 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 (send notification) and the target resource (workspace). It distinguishes from sibling notification tools for organization and group by naming the workspace scope, though it does not explicitly mention alternatives.

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 the sibling tools send_organization_notification and send_group_notification. The description only states what it does, leaving the selection context entirely implicit.

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. Dates show when Glama detected each change.

  1. 9 tool updatesv0.1.0
    • First observedget_group_members
    • First observedget_organization_groups
    • First observedget_organization_workspaces
    • First observedget_space_name_by_id
    • First observedget_workspace_access_path
    • First observedget_workspace_users
    • First observedsend_group_notification
    • First observedsend_organization_notification
    • First observedsend_workspace_notification

TDQS

A3.5/5.0
Disambiguation5/5

Each tool targets a distinct resource and action: get operations for workspaces, users, spaces, access paths, groups, and members, plus send operations for notifications to different scopes. No two tools overlap in purpose.

Naming Consistency5/5

All tools follow a consistent 'get_' or 'send_' prefix followed by a specific object, making the action and target predictable. The pattern is uniform across the set.

Tool Count5/5

Nine tools is well within the ideal 3-15 range, and each tool addresses a specific need in the ovice management domain.

Completeness4/5

The toolset covers the main information retrieval and notification needs for organizations, workspaces, and groups. While there are no create/update/delete operations, they appear out of scope for this server's apparent purpose.

Maintenance

ActivityInactive
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

  • A
    license
    C
    quality
    D
    maintenance
    Enables Claude to interact with ServiceNow instances through comprehensive API integration. Supports incident management, service catalog operations, change requests, knowledge base management, user administration, and agile project management with multiple authentication methods.
    82
    MIT
  • A
    license
    C
    quality
    D
    maintenance
    Enables Claude to interact with ServiceNow instances to manage incidents, service catalogs, workflows, and knowledge bases through the ServiceNow API. It supports comprehensive operations including record querying, script execution, and user management using various authentication methods.
    66
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables Claude to interact with DingTalk workspaces to search for users, retrieve detailed employee information, and send private messages. It bridges the Model Context Protocol with DingTalk's internal enterprise APIs for seamless workspace communication.
    10
    5
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cti1650/ovice-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server