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
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 |