How to Use the Bible API MCP in Windsurf

Q: Can Cascade search multiple versions at once with the Bible API?

Yes. Cascade can autonomously call listbibles to get the list of available versions, loop through them, and run searchbibletext on each one without needing separate prompts from you.

Q: Does the Bible API support non-English translations in Windsurf?

Absolutely. You can use listbibles to find available languages and versions, then pass those specific language IDs to tools like getbibleverse or getbiblechapter.

Q: How does Cascade handle deep scripture searches?

It calls searchbibletext with your keywords. Because Cascade can run multi-step plans, it can take those search results, grab the full context of surrounding verses using getbibleverse, and present a complete summary.

Search, compare, and pull scripture directly into your code workspace with Cascade and the Bible API.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bible API MCP to Windsurf

Create your Vinkius account to connect Bible API to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Bible API with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Compare translations instantly using Cascade and this MCP Server

Cascade can chain several steps together when you ask to check a verse. It queries multiple versions at once using `list_bibles` to find active IDs, then grabs the text with `get_bible_verse`. You don't have to prompt it for every single translation you want to see. The agent handles the back-and-forth automatically. It parses the results, aligns the text side-by-side in your editor, and highlights the phrasing differences without you lifting a finger.

Auto-generate context-aware notes and commentary

Let your agent build study guides or reference materials right inside your project directories. By combining `list_bible_books` and `get_bible_chapter`, Cascade pulls down entire blocks of text and structures them into clean markdown files. It reads your local workspace context to see what theological or historical topics you are working on, runs targeted searches via `search_bible_text`, and inserts relevant scriptures directly into your open files.

Verify scripture references across your codebase

Stop manually double-checking whether your app's hardcoded verses are accurate. Cascade scans your files for scripture citations, calls `get_bible_details` to verify the source metadata, and fixes any typos in your text strings. If a citation is broken, this MCP Server lets Cascade look up the correct reference. It replaces the broken string and runs your test suite to make sure nothing broke in the process.

Setup guide

Set up Bible API MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Bible API MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Bible API payment history." If connected, Cascade will call the Bible API tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "bible-api-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Bible API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Bible API now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Bible API MCP in Windsurf

Open your settings and navigate to Cascade MCP Servers, or write it directly to your `~/.codeium/windsurf/mcp_config.json` file. Paste the connection URL from Vinkius under the `mcpServers` block and hit refresh in your MCP panel.

Yes. Cascade can autonomously call `list_bibles` to get the list of available versions, loop through them, and run `search_bible_text` on each one without needing separate prompts from you.

Absolutely. You can use `list_bibles` to find available languages and versions, then pass those specific language IDs to tools like `get_bible_verse` or `get_bible_chapter`.

It calls `search_bible_text` with your keywords. Because Cascade can run multi-step plans, it can take those search results, grab the full context of surrounding verses using `get_bible_verse`, and present a complete summary.

Your search queries and scripture requests never touch external logging servers. Vinkius runs this server inside an isolated sandboxed environment, keeping your theological research and API calls completely private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript