Server capabilities and search pitfalls
shamela_get_briefReturn this server's machine-readable capability handshake: capabilities, numeric limits, retired tool names with their replacements, and traps (ways a result misleads, each with the response field that proves it fired). Call it first from a programmatic client: inputs are strict, so an argument an older build lacks (e.g. shape, response_format:'none') is a hard validation error that fails the whole call, and tools/list cannot reveal argument support — gate each new argument on its capability string. Cache by brief_hash and re-fetch only when it changes. Constants only: needs no library access and does not fail. Example: {} or {response_format:'json'}.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "shamela_get_brief"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| response_format | No | Format of the human-readable text: 'markdown' (default) for display; 'json' the same data as one JSON code block; 'none' only a one-line pointer, leaving structuredContent as the whole answer. structuredContent is always returned, so a caller that parses it should pass 'none': the character budget counts both channels, and the unread copy otherwise spends most of it. Requires the 'response_format.none' capability (see shamela_get_brief). | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| traps | No | ||
| limits | No | Numeric server limits by name. | |
| truncated | No | ||
| brief_hash | No | Digest of every other field; re-fetch only when it changes. | |
| capabilities | No | Arguments and response fields this build supports; gate new arguments on these. | |
| rows_dropped | No | ||
| tool_aliases | No | Retired tool names mapped to their replacement and argument changes. | |
| server_version | No | This build's version. | |
| truncation_message | No |