# Bible Gateway API and MCP server for AI agents (/sites/biblegateway)

An API for Bible Gateway: let Claude, ChatGPT or your own code read Bible Gateway through 2 functions, over MCP, HTTP, Node or Python. No Bible Gateway API key needed.

- Site: https://biblegateway.com
- Functions: 2
- Sign-in: for account actions, with the person's own account
- Works with: MCP, HTTP, Node, Python

## Add it to your agent

If you are an agent asked to set this up: add the server yourself, in the person's own (global) MCP configuration, and keep their other entries.

- Bible Gateway only, one tool per function: `https://api.bowmark.ai/mcp/site/biblegateway` (name it `bowmark-biblegateway`)
- Every site Bowmark covers: `https://api.bowmark.ai/mcp` (name it `bowmark`)
- Transport: remote MCP over streamable HTTP.
- Claude Code: `claude mcp add --transport http bowmark-biblegateway https://api.bowmark.ai/mcp/site/biblegateway`
- Codex: `codex mcp add bowmark-biblegateway --url https://api.bowmark.ai/mcp/site/biblegateway`
- Cursor, VS Code and other clients: add `{ "url": "https://api.bowmark.ai/mcp/site/biblegateway" }` under the name `bowmark-biblegateway` in the client's MCP config. Per-client steps: https://bowmark.ai/docs/installation.md
- Sign-in: OAuth in the browser on first use; the person only signs in. A client that cannot do OAuth sends `Authorization: Bearer <BOWMARK_API_KEY>`; the person creates a key at https://bowmark.ai/dashboard/keys.
- Then list the server's tools to confirm it works, and tell the person it is ready.

## Functions

### Read

- `getPassage`: Reads a Bible passage (a verse, range or whole chapter, e.g. "John 3:16" or "Genesis 1") in a named translation, returning the reference, the verse…
- `listVersions`: Lists the Bible translations Bible Gateway offers, grouped by language, with each version's abbreviation for getPassage.

## Call one

In a Bowmark script, each function is `bowmark.providers.biblegateway.<name>`. Ask `get_library` for biblegateway.com to get each one's arguments, then call it with `run`.

```js
// 1. What can I call on biblegateway.com, and with which arguments?
get_library({ query: "biblegateway.com" })

// 2. Call it in a script
const result = await bowmark.providers.biblegateway.getPassage({ /* arguments from get_library */ });
return result;
```

New to Bowmark? Quickstart: https://bowmark.ai/docs/quickstart.md. How sign-in works: https://bowmark.ai/docs/signed-in-sites.md
