MCP setup

Wire Ezra into any MCP client.

The endpoint is https://ezramcp.com/v1/mcp. Auth header is Authorization: Bearer ezra_live_…. JSON-RPC 2.0 over HTTP.

Get a key first

Sign up for a free key 20 calls / month, no card.

Claude Code

claude mcp add ezra https://ezramcp.com/v1/mcp \
  --header "Authorization: Bearer ezra_live_..."

Cursor / Cline / any MCP client

{
  "mcpServers": {
    "ezra": {
      "transport": "http",
      "url": "https://ezramcp.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ezra_live_..."
      }
    }
  }
}

The 11 tools

• get_verses_by_topic(topic, limit?) — primary lookup, returns verses with refs and text
• list_topics(category?, limit?) — discovery; filter by theme / story / parable
• get_pericope(name) — return a story or parable with its verses
• find_topic(query) — fuzzy search topic names
• get_related_topics(topic, limit?) — topics that co-occur with this one
• get_jesus_teachings(mode?) — Jesus' beliefs, commands, or both, grounded in Gospel refs
• create_verse_collection(...) — save refs, bible version, API.Bible tags, and global tags
• get_verse_collection(id) — return an accessible collection without stored verse text
• find_verse_collections(tag?, tag_source?) — find public and owned collections by tag
• get_verse(ref) — single-verse lookup with topics and pericopes
• get_chapter(book, chapter) — full chapter with per-verse topics

Example tool call

curl https://ezramcp.com/v1/mcp \
  -H "Authorization: Bearer ezra_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
      "name": "get_verses_by_topic",
      "arguments": { "topic": "Forgiveness", "limit": 5 }
    }
  }'

Jesus beliefs and commands

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_jesus_teachings",
    "arguments": { "mode": "both" }
  }
}

Custom verse collections

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "create_verse_collection",
    "arguments": {
      "title": "Jesus commands",
      "visibility": "private",
      "bible_version": "WEB",
      "verse_refs": ["Matthew 22:37", "John 13:34"],
      "api_bible_tags": ["Jesus", "Commands"],
      "global_tags": ["daily-practice"]
    }
  }
}

Rate limits

• Free — 20 tool calls per month per key
• Pro — 10,000 per month
• Max — 100,000 per month

Rate-limit errors return JSON-RPC code: -32004 with an upgrade_url. Counts reset at the start of each UTC month.

Source data

World English Bible (public domain). Topic, story, and parable tags are an original derivative work released under AGPL-3.0 in the ezra-bible-data repository.