Search an OKF bundle
okf_searchSearch OKF bundle concepts using full-text query to find matches across titles, IDs, types, tags, descriptions, and bodies, then review results with metadata.
Instructions
Full-text search over a bundle's concepts — titles, ids, types, tags, descriptions, and bodies.
Args:
bundle_path (string): directory containing the bundle
query (string): search text, 1-200 characters
limit (number): 1-50, default 10
response_format ('markdown' | 'json'): default 'markdown'
Returns: { "query": string, "count": number, "results": [{ "id": string, "title": string, "type": string, "description": string, "tags": string[], "status": ..., "trust": ..., "updated_at": string, "stale_since": string }] }
Examples:
Use when: "Where is churn defined?" -> query="churn"
Use when: you do not know the concept id
Don't use when: you have the exact id (use okf_get_concept, it is cheaper)
Error Handling:
No matches returns the available types and tags to redirect the search
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": {
"bundle_path": "<bundle_path>",
"query": "<query>"
},
"name": "okf_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results | |
| query | Yes | Search text | |
| bundle_path | Yes | Path to the OKF bundle directory (a folder of .md files). Absolute paths are safest. | |
| response_format | No | 'markdown' for reading, 'json' for machine processing | markdown |