Read one OKF concept
okf_get_conceptRead a full OKF concept by ID: get frontmatter, trust and lifecycle signals, provenance, links, and body in one call, so you can verify definitions and cite sources.
Instructions
Read a single concept in full: its frontmatter, trust and lifecycle signals, provenance, body, and links.
Args:
bundle_path (string): directory containing the bundle
id (string): concept id — the file path without .md, e.g. "metrics/revenue"
include_body (boolean): default true; set false for metadata only
response_format ('markdown' | 'json'): default 'markdown'
Returns: { "id": string, "title": string, "type": string, "description": string, "tags": string[], "resource": string, "status": ..., "trust": ..., "verified_by": string[], "verified_at": string, "updated_at": string, "stale_since": string, "generated": { "by": string, "at": string }, "sources": [{ "id": string, "resource": string, "title": string, "author": string, "lastModified": string, "usageCount": number }], "computation": { // present only for type "Attested Computation" "runtime": string, "parameters": [{ "name": string, "type": string, "required": boolean }], "path": string, "executor": { "resource": string, "receipt": string[] }, "attester": { "resource": string } }, "links_to": string[], "cited_by": string[], "body": string // omitted when include_body is false }
Trust and freshness are worth checking before relying on a definition: "trust" is
derived from verified (§5.3) and "stale_since" from stale_after (§5.5). They are
advisory signals, not access control.
For an Attested Computation, the caller may supply values for the declared parameters ONLY, and must never author or rewrite the computation itself — that boundary is the point of the type (§10).
Examples:
Use when: "How is revenue defined?" -> id="metrics/revenue"
Use when: you need a concept's sources to cite it
Error Handling:
An unknown id returns near-miss suggestions from the bundle
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Concept id: path without .md, e.g. "metrics/revenue" | |
| bundle_path | Yes | Path to the OKF bundle directory (a folder of .md files). Absolute paths are safest. | |
| include_body | No | Include the markdown body | |
| response_format | No | 'markdown' for reading, 'json' for machine processing | markdown |