For developers and AI agents

Bible World API & MCP

Search Bible World's images every way the site can, use the character library to keep people looking the same, and create new images from your own apps and AI agents.

It is the same API as the Advent AI library: one key opens both, and agents connect to one MCP server.

Interactive reference OpenAPI specification

What you can do

Search images
By words, by Bible passage verse by verse, by theme, by the characters pictured, or by creator, and browse what is popular, trending or new.
Use the character library
Find a person, see every variant with its reference images, and use your own character sets.
Create images
Make new images with the same models and styles as the create page, put exact characters in them, build on any image, and follow each one until it is finished.

Your API keys

Sign in to create a key. Keys are free; creating images is a Premium feature that needs a paid plan (Premium or Pro) and uses your image credits.

Set up an AI agent

Copy these instructions into your AI agent. They explain how to connect and how to search, use characters and create images.

# Bible World — agent setup

You can search Bible World's public Bible images, use its character library, and create new images on the key owner's Bible World credits. Creating images is a Premium feature: the key owner needs a paid plan (Premium or Pro). The same server also opens the Advent AI library (books, periodicals, the Bible).

Replace YOUR_API_KEY with a key from https://beta.bibleworld.ai/api (sign in, then create a key).

API key: YOUR_API_KEY

## Preferred: MCP server

Add this MCP server (streamable HTTP):

```json
{
  "mcpServers": {
    "advent-ai-library": {
      "type": "http",
      "url": "https://beta.bibleworld.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

Claude Code: `claude mcp add --transport http advent-ai-library https://beta.bibleworld.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"`

Image tools: search_images, browse_images, bible_passage_images, get_image, list_image_themes, theme_images, pictured_characters, character_images, creator_images, creator_gallery.
Character library: search_characters, get_character, list_character_sets, get_character_set.
Creating images (Premium): get_image_options, get_print_sizes, get_credits, generate_image, get_generation, list_my_images.

## Alternative: REST API

Base URL: https://beta.bibleworld.ai/api/v1/bibleworld
Send the key on every request: `X-Api-Key: YOUR_API_KEY`
OpenAPI spec: https://beta.bibleworld.ai/api/v1/openapi.json

## How to work with it

1. Find images with search_images (words or a Bible reference), browse_images, or bible_passage_images for a passage verse by verse. Link people to an image's pageUrl.
2. To keep people looking the same, find them with search_characters and open get_character: each variant has a variantId and reference images.
3. Before creating, call get_image_options for models, styles and what each size costs, and get_credits for the balance. Creating spends the person's credits, so tell them the cost first. If generate_image answers premium_required, the person needs a paid plan: give them its upgradeUrl.
4. Call generate_image with the prompt. Pass characterVariantIds to fix exactly who appears, referenceImageIds to build on an existing image, and the returned sessionId for a series.
5. Follow it with get_generation (it waits up to 50 seconds) and give the finished image's url.
6. If credits run short, give the person buyCreditsUrl from get_credits (https://beta.bibleworld.ai/credits).

## Limits

Per key: reads burst to 120 then 2 per second; searches burst to 30 then 1 every 2 seconds; 25,000 requests per day; 8 at once. At most 15 of your images are made at a time. On HTTP 429, wait the Retry-After seconds or for an image to finish.

MCP server

Agents that support the Model Context Protocol connect directly. Add this server address with your API key as a Bearer token:

https://beta.bibleworld.ai/mcp

In Claude Code, run:

claude mcp add --transport http advent-ai-library https://beta.bibleworld.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

Images: search_images, browse_images, bible_passage_images, get_image, list_image_themes, theme_images, pictured_characters, character_images, creator_images, creator_gallery
Character library: search_characters, get_character, list_character_sets, get_character_set
Creating images (Premium): get_image_options, get_print_sizes, get_credits, generate_image, get_generation, list_my_images

Credits

Searching and the character library are free. Creating an image through the API is a Premium feature: the account the key belongs to needs a paid plan (Premium or Pro). Any other key is refused with premium_required and a link to the plans. Each image spends your image credits, exactly as on the create page; the options call lists what each model and size costs.

GET /credits (or the get_credits tool) returns your balance and buyCreditsUrl, the page where you or your agent's user can buy more:

https://beta.bibleworld.ai/credits

Buy credits

REST endpoints

All answers are JSON. The base address is:

https://beta.bibleworld.ai/api/v1/bibleworld

GET /images/search?q=: Search public images by words or a Bible reference.
GET /images?sort=popular|trending|recent: Browse the public gallery.
GET /images/bible?ref=: A Bible passage verse by verse, with the images tagged to each verse.
GET /images/{guid}: One image: creator, style, characters, themes and Bible references.
GET /images/characters?q=: Characters pictured in public images, most pictured first.
GET /characters/{id}/images: Public images of one character.
GET /themes: Image themes with how many images carry each.
GET /themes/{slug}/images: Public images in a theme.
GET /creators/{username}/images: A creator's public images.
GET /creators/{username}/galleries/{slug}: A creator's public gallery.
GET /characters?q=&characterSetId=: Search the character library.
GET /characters/{id}: A character's variants and reference images.
GET /character-sets: Your character sets.
GET /character-sets/{id}: One character set with its variants.
GET /generation/options: Models, styles, sizes and what each costs in credits.
GET /generation/print-sizes: Paper sizes for print-ready images.
GET /credits: Your image credits and the link to buy more.
POST /generations: Premium: create a new image on your credits. Needs a paid plan (Premium or Pro).
GET /generations/{id}?wait=: Follow an image until it is finished.
GET /generations: Your images, newest first.

Example:

curl -H "X-Api-Key: YOUR_API_KEY" "https://beta.bibleworld.ai/api/v1/bibleworld/images/search?q=lions%20den"

Fair use

Limits are per key: bursts of 120 reads and 30 searches, 25,000 requests a day, and 8 at a time. At most 15 of your images are made at once. Over a limit the answer is 429; wait the Retry-After seconds or for an image to finish.

Use of the API is governed by theAPI Terms of Use.

What you can doWhat you can do

Search imagesSearch images

Use the character libraryUse the character library

Create imagesCreate images

Your API keysYour API keys

Set up an AI agentSet up an AI agent

MCP serverMCP server

CreditsCredits

REST endpointsREST endpoints

Fair useFair use