List concepts in an OKF bundle
okf_list_conceptsList concepts from an OKF bundle, filtering by type, tag, lifecycle status, or trust. Returns summary entries without bodies, making it safe for large bundles.
Instructions
List concepts, optionally filtered by type, tag, or lifecycle status.
Returns summaries without bodies, so it is safe to call on a large bundle. Use okf_get_concept to read one in full.
Args:
bundle_path (string): directory containing the bundle
type (string, optional): exact OKF type, e.g. "Metric", "BigQuery Table", "Attested Computation"
tag (string, optional): exact tag
status ('draft' | 'stable' | 'deprecated', optional): lifecycle filter (spec §5.4)
trust ('unverified' | 'machine-confirmed' | 'human-reviewed', optional): trust tier (spec §5.3)
limit (number): 1-200, default 50
offset (number): default 0
response_format ('markdown' | 'json'): default 'markdown'
Returns: { "total": number, "count": number, "offset": number, "has_more": boolean, "next_offset": number, // present only when has_more "concepts": [{ "id": string, "title": string, "type": string, "description": string, "tags": string[], "resource": string, "status": "draft"|"stable"|"deprecated", "trust": "unverified"|"machine-confirmed"|"human-reviewed", "verified_by": string[], "verified_at": string, "updated_at": string, "stale_since": string }] }
Examples:
Use when: "What metrics are defined?" -> type="Metric"
Use when: "Which definitions has nobody verified?" -> trust="unverified"
Use when: "Show me anything deprecated" -> status="deprecated"
Error Handling:
An unmatched type or tag returns an empty list plus the values that do exist
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Exact tag to filter by | |
| type | No | Exact OKF type to filter by | |
| limit | No | Maximum results | |
| trust | No | Trust tier derived from `verified` (§5.3) | |
| offset | No | Results to skip, for pagination | |
| status | No | Lifecycle status (§5.4) | |
| 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 |