# inspect_tool

> 查看单个工具的完整描述和 JSON 输入 schema。

URL: https://mcp-docs.opennomos.com/zh/docs/tools/discovery/inspect_tool

> 查看单个工具的完整描述和 JSON 输入 schema。

> 以上是服务端发布的英文描述的译文；英文原文见[英文页](https://mcp-docs.opennomos.com/docs/tools/discovery/inspect_tool.md)。工具名、参数名和取值保持原样。

| 字段 | 值 |
| --- | --- |
| 工具包 | Core (`core`) |
| 每次调用的预估成本 | $0 |
| 工具包每月上限 | 无 |
| 项目 | 按顺序确定：显式的 `project` → 请求头 → 凭据默认项目 → 工作区默认项目 |

## 参数

| 参数 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| `name` | 是 | `string` | 工具名，例如 'seo_research'。 |

## 示例调用

```json
{
  "name": "seo_research"
}
```

REST:`POST https://service.opennomos.com/v1/tools/inspect_tool`，以上 JSON 作为请求体。MCP:`tools/call`,`name: "inspect_tool"`，以上 JSON 作为 `arguments`。

## 示例结果

示例里的值是示意性的；结构来自服务端代码。

```json
{
  "name": "seo_research",
  "description": "SEO data. action=serp: …",
  "inputSchema": {
    "type": "object",
    "properties": "…",
    "required": [
      "action"
    ]
  }
}
```

## 说明

- 返回的 `name`、`description` 和 JSON Schema，与 `tools/list`（MCP）和 `GET /v1/tools` 发布的完全一致。
- 未知的工具，或所在工具包未启用的工具，会返回错误 `No tool <name>`。

## 错误

被拒绝的调用（输入有误、id 未知、触发限流）返回 `message` 和 `code`；走 MCP 时结果带 `isError: true`。见[错误](https://mcp-docs.opennomos.com/zh/docs/reference/errors.md)。