get_concept

Read a concept. A concept’s markdown body and frontmatter, with its provenance (sources, generated, verified), trust tier, status, staleness, links, and backlinks. Read-only.

Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Concept ID, its tree first: `company:product/okforest-product-brief`. In a Forest of one tree, the tree may be left out.

Returns

One JSON object (see All tools):

Field	Type	Always	Description
`tree`	Tree reference	Yes	The tree it’s in, and the commit it was read at.
`concept`	object	Yes	The concept.
`concept.id`	string	Yes	The concept’s ID: its tree’s slug, a colon, and its path without `.md`.
`concept.tree`	string	Yes	The slug of the tree it’s in.
`concept.path`	string	Yes	Its file’s path in the tree.
`concept.url`	string	Yes	The concept’s page in OKForest.
`concept.type`	string	No	Its `type`, when it has one.
`concept.title`	string	No	Its `title`, when it has one.
`concept.description`	string	No	Its `description`, when it has one.
`concept.tags`	list of strings	Yes	Its `tags`.
`concept.status`	`draft` \| `stable` \| `deprecated`	Yes	Its lifecycle status; `stable` when it gives none.
`concept.stale`	boolean	Yes	Whether it’s past its `stale_after` date.
`concept.staleAfter`	string	No	Its `stale_after` date, when it has one.
`concept.trustTier`	`unverified` \| `machine-confirmed` \| `human-reviewed`	Yes	How it has been verified, from its `verified` entries.
`concept.verified`	list of objects	Yes	Its `verified` entries: who verified it (`by`), and when (`at`).
`concept.generated`	object	No	Its `generated` entry, when it has one: what made it (`by`), and when (`at`).
`concept.sources`	list of objects	Yes	Its `sources` entries: `id`, `resource`, `title`, `author`, and so on.
`concept.frontmatter`	object	Yes	Its frontmatter, as written.
`concept.body`	string	Yes	Its markdown body.
`concept.links`	list of Concept link	Yes	The concepts it links to.
`concept.backlinks`	list of Concept link	Yes	The concepts that link to it.

Example

Asked “Tell me about Acme Corp.”, an assistant might call get_concept with:

{
  "id": "company:customers/acme-corp"
}

On OKForest’s test Forest (Acme’s made-up company knowledge), it returns:

{
  "tree": {
    "slug": "company",
    "repo": "acme/acme-okf",
    "commit": "abc1234abc1234abc1234abc1234abc1234abc1",
    "url": "https://app.okforest.ai/@/3f2b8c1e-9a4d-4c7b-8e2f-6d1a0b5c9e7f/company/"
  },
  "concept": {
    "id": "company:customers/acme-corp",
    "path": "customers/acme-corp.md",
    "type": "Customer",
    "title": "Acme Corp",
    "description": "Our largest retail customer.",
    "tags": [
      "customer",
      "retail"
    ],
    "status": "stable",
    "trustTier": "human-reviewed",
    "stale": false,
    "frontmatter": {
      "type": "Customer",
      "title": "Acme Corp",
      "description": "Our largest retail customer.",
      "tags": [
        "customer",
        "retail"
      ],
      "verified": {
        "by": "human:jane",
        "at": "2026-09-01T00:00:00Z"
      }
    },
    "body": "# Acme Corp\n\nAcme Corp buys our retail analytics plan. Their main competitor of ours\nis [Rival Co](../competitors/rival-co.md); see [their site](https://acme.example).\n",
    "sources": [],
    "verified": [
      {
        "by": "human:jane",
        "at": "2026-09-01T00:00:00Z"
      }
    ],
    "links": [
      {
        "id": "company:competitors/rival-co",
        "title": "Rival Co",
        "tree": "company",
        "url": "https://app.okforest.ai/@/3f2b8c1e-9a4d-4c7b-8e2f-6d1a0b5c9e7f/company/competitors/rival-co"
      }
    ],
    "backlinks": [],
    "tree": "company",
    "url": "https://app.okforest.ai/@/3f2b8c1e-9a4d-4c7b-8e2f-6d1a0b5c9e7f/company/customers/acme-corp"
  }
}