Agents and MCP

The same reading goal follows you across your coding agents.

Set one Bible goal. After setup, the next reading shows up on its own in Claude Code, Codex, and Gemini CLI, delivered cleanly through the agent hook.

Install

Install the CLI, then run setup once to save a goal and add the ambient hook for all three agents.

pnpm add -g bible-coder
bible-coder setup

Add the MCP server

Setup already delivers the reading. Add the MCP server when you also want the agent to check goal status, pull free passages, and record progress with tools. Pick your client.

Codex

codex mcp add bible-coder -- bible-coder-mcp

Claude Code

claude mcp add bible-coder bible-coder-mcp

Gemini CLI

gemini mcp add bible-coder bible-coder-mcp

The reading just shows up

The hook from setup posts your next reading at the start of a session and after each prompt turn. Watch for Bibe Code Bible running - expand for reading and open it.

Claude Code and Codex append the reading to the agent's next response.
Gemini CLI shows the reading in the session without adding it to model context.

If Codex asks you to trust hooks, type /hooks and trust the entry whose command contains bible-coder hooks run --client codex. The docs cover the full trust and repair steps.

Goals

Book goals compile locally: Read Genesis becomes Genesis 1 through Genesis 50. For an ambiguous or topical goal, let the active model draft the references, confirm them with you, and save them through goal_update. Goals are free.

Tools

The MCP server gives your agent these tools. Free WEB and KJV text comes back inline.

session_bible - return the next goal reading and optionally record it.
session_coda - legacy alias for session_bible.
goal_status - read the current free local goal and progress.
goal_update - save a new reference-first goal plan.
plan_create - build a reading plan from a goal.
bible_get_passage - return a free WEB or KJV passage.
bible_search - search the free WEB and KJV text.
progress_record - record a progress event through sync.
progress_status - read recorded progress.
review_next - read synced review events.
billing_checkout - open a Pro checkout link.
sync_status - check whether sync is configured.
block_status - read Prayer Gate status (read only).

Paid Bible text stays display-only and is not returned inline to the model by default. Premium translations render in a trusted human surface, not in model-visible MCP output.