查询系统工具¶

接口用途¶

发现系统工具目录，例如 GitHub Issues、Repository、Rate Limit、PR、Actions。

请求方式¶

GET

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/tools?catalog=system&limit=200&offset=0&view=full

身份认证¶

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数¶

无。

查询参数¶

名称	说明
`catalog`	使用 `system` 查系统工具；`workspace` 查工作区工具。
`query`	关键词，如 `GitHub`。
`limit`	分页大小。
`offset`	分页偏移。
`view`	使用 `full` 拉取完整绑定信息。
`status`	状态过滤。
`kind`	类型过滤。

请求体¶

无请求体。

请求示例¶

curl -X GET 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/tools?catalog=system&query=GitHub&limit=20' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json'

响应说明¶

除 A2A JSON-RPC 外，多数工作区接口成功响应形如 {"code":0,"data":...}；下列字段描述 data（或 HTTP 202 时的 data）。

工具列表：

字段	类型	说明
`items`	array	资源列表
`total`	integer	总数
`limit`	integer	分页大小
`offset`	integer	偏移量
`items[]`	object	工具对象，可用于对照前台显示名与 API 工具名