io.github.StructLabs-io/runitonai-mcp

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Read-only MCP connector serving the Run It on AI book; index and Implementation Blocks are free.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "runitonai-mcp": {
      "url": "https://mcp.runitonai.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (11)

• activate

  Start here. Returns the Run It on AI companion's full operating instructions (engagement modes, routing, voice rules, tool usage). Call this FIRST — before any other tool — when the user says "Activate Run It on AI", mentions the Run It on AI ebook, or asks for help choosing/deploying AI in their business. No authentication.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_book_index

  Discovery: every valid chapter_id with its title — front matter, all chapters, AND all appendices (e.g. appendix-b-online-reference) — plus Implementation Block names per chapter. Call this whenever unsure which chapter_id to use. No authentication.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• lookup_chapter

  Fetch a full chapter or a named section by slug — works for appendices too. Buyer-gated: pass the reader's access_code (their Gumroad license key). Unsure of the slug? Call list_book_index first.

  Parameters:

  • chapter_id (required) — string — Manuscript slug, e.g. how-ai-actually-works or appendix-b-online-reference. Full list via list_book_index.
  • section — string — Optional H2 section slug within the chapter.
  • access_code — string — The reader's access code: the Gumroad license key from their Run It on AI receipt (format XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX). Required unless the request carries an Authorization: Bearer token. Once the reader has supplied it, pass it on every call.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_implementation_block

  Fetch a structured Implementation Block (reader_prompt, agent_notes, target_artifact) by chapter and name. Free to call — no access code needed; the Implementation Blocks are public (they also ship in the open-source server repo).

  Parameters:

  • chapter_id (required) — string
  • name — string — IB name, e.g. compounding-question. Omit to list IBs in chapter.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• find_section

  Stub — not implemented in Phase 1. See tool response 'phase' field.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• find_playbook

  Stub — not implemented in Phase 1. See tool response 'phase' field.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_playbook

  Stub — not implemented in Phase 1. See tool response 'phase' field.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• report_telemetry

  Stub — not implemented in Phase 1. See tool response 'phase' field.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_session_history

  Stub — not implemented in Phase 1. See tool response 'phase' field.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• save_session_state

  Stub — not implemented in Phase 1. See tool response 'phase' field.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• forget_session_history

  Stub — not implemented in Phase 1. See tool response 'phase' field.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.