Personal use and permission
API access, including REST endpoints and MCP, is rate limited and strictly for personal, non-commercial use unless Script Bible grants prior written permission. A personal agent connected solely for your own use is permitted.
Using the API to power a shared application, or for church, nonprofit, or commercial purposes, requires our prior written permission. This applies even if the application is free or stays below the rate limits. Public access without an API key does not grant permission for these uses.
Request permission before building or launching an integration for others. See the Terms of Service for the access conditions.
Machine-readable discovery
- llms.txt — a concise agent guide and curated resource map.
- OpenAPI 3.1 document — core read-only API operations and parameters.
- MCP server manifest — standard metadata for the public Streamable HTTP server.
- Agent instructions — best-fit jobs, calling workflow, error recovery, and boundaries.
- API lifecycle policy — versioning, deprecation, and rate-limit guarantees.
- XML sitemap — the complete public page inventory.
- Homepage Markdown — a clean, low-markup overview of Script Bible.
Core read-only endpoints
- GET /api/v1/books — Bible book metadata.
- GET /api/v1/chapters/john/1?version=web — chapter text by version, book, and chapter.
- GET /api/v1/search?q=love&mode=keyword — keyword, meaning, hybrid, and reference search.
No API key is currently required. Version 1 permits additive, backward-compatible changes. Clients should respect HTTP cache headers, use RateLimit and RateLimit-Policy to self-throttle, and wait for Retry-After on 429 responses. Every Script Bible REST error includes a stable code, a message, and a resolution hint.
Remote MCP server
Connect a Streamable HTTP MCP client to https://script.bible/mcp. Public tools retrieve WEB and KJV passages, search Scripture, and list reading plans without an API key. After OAuth sign-in, account tools can read and update reading plans, bookmarks, and notes. Manage approved connections in Account → Agents. Script Bible does not currently publish an SDK. To request permission for shared or organizational API use, use the contact page.