summarize_api_definition
Summarizes API YAML definitions to reduce token use: list endpoint names or selected fields for triage, or return full details only when needed.
Instructions
Summarize a canonical API YAML without returning the full definition. Use names_only for triage (optionally with fields to trim endpoint entries); use full only when needed.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"definitionRelativePath": "<definitionRelativePath>"
},
"name": "summarize_api_definition"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | No | When given (detailLevel names_only only), projects each `endpoints` item to these keys only (id/method/path/description). | |
| requestId | No | ||
| detailLevel | No | names_only | |
| workspaceRoot | No | ||
| definitionRelativePath | Yes |