PromptOwl + ContextNest Docs
Contents

Source Frontmatter

Updated Open in ChatGPTOpen in Claude

Source nodes include a source block in their frontmatter with structured metadata for the resolver and runtime.

Fields

Field Type Required Description
transport string Yes mcp, rest, cli, or file
server string No Server name from the vault's config.yaml server registry
tools string[] No Tool names used by this source
depends_on string[] No contextnest:// URIs of sources this depends on
cache_ttl integer No Cache lifetime in seconds. 0 means no caching.

Transport types

Transport Description
mcp Model Context Protocol server
rest HTTP REST API
cli Command-line tool
file Local file read

Example

---
title: "Recent PR Activity"
type: source
tags: ["#engineering", "#github"]
status: published
version: 1
source:
  transport: mcp
  server: github
  tools:
    - github_list_pull_requests
  cache_ttl: 600
---

Server registry

The server field references a named entry in .context/config.yaml:

servers:
  jira:
    url: "https://mycompany.atlassian.net"
    transport: mcp
  github:
    url: "https://api.github.com"
    transport: mcp

Related pages

  • PromptOwl DocumentationWelcome to the documentation for PromptOwl and Context Nest — the open protocol and hosted platform for giving AI agents structured, versioned, governed…
  • Add DocumentsThis creates nodes/api-design.md from a frontmatter template as version 1, and regenerates the index. Tags accept a comma- or space-separated list; you…
  • Addressing OverviewContext Nest uses the contextnest:// URI scheme to address documents, sections, tags, and folders within a vault.
  • Authentication & API KeysContextNest Community distinguishes two kinds of key, and it is worth keeping them straight:
  • CLI ReferenceThe Context Nest CLI (ctx) is a structured, versioned knowledge base your AI agents can query. It provides commands for setting up vaults, creating and…

Referenced by