Skip to main content
get_guide is the canonical source for workflow and guide text. Called with no name it lists every workflow and guide. Called with a name it returns that one’s text and version, the same text the prompt or resource serves. It reads no workspace data and changes nothing. Reach for it when the user asks how to do a job (“set up heyBTW”, “record this guest list”, “write the follow-up”) and when a client shows neither prompts nor resources. Follows the heyBTW MCP rules.

When to use it

  • “Set up heyBTW.”
  • “How do I get my past events in?”
  • “What does sourced mean in this answer?”
  • “Which workflows does heyBTW have?”

Parameters

What it serves

Prompts and resources describes each one, with its arguments and windows.

Response

With no name, data holds one row per workflow or guide: With a name, data[0] carries the same fields without description, plus text: the full workflow or guide. A list call, trimmed here to two of its ten rows and shown without query_time_ms and metadata:
Versions change as the workflows improve. Read the version from the response and never assume one.

Rules the agent must follow

  • Follow a workflow’s text as served. It is the manual for that job.
  • A workflow reads first, proposes in the conversation and writes only what the user accepts.
  • A workflow run outside its applies_to windows says how far the event is and hands off.

Errors and gaps

  • entity_not_found: no workflow or guide has that name. The error’s what_to_do lists the valid names.
  • rate_limit_exceeded: wait for Retry-After. See Limits and errors.