Bible Swipe

Official6 tools

by GoodTurnStudio · JavaScript

A Bible reading a day, line by line, any passage by reference, and search.

io.github.GoodTurnStudio/bible (MCP Server)

A Bible reading application exposed via an MCP server. It supports reading content a day at a time, progressing line by line. Users can access any passage by reference and perform search to find relevant Bible text.

🛠️ Key Features

Daily Bible reading
Line-by-line progression
Retrieve passages by reference
Search across Bible content

🚀 Use Cases

Follow a structured “Bible reading a day” routine
Navigate to a specific passage using a reference
Search for themes, words, or passages within the Bible

⚡ Developer Benefits

Programmatic access to daily, line-by-line reading
Reference-based passage retrieval
Search support for Bible text queries

⚠️ Limitations

Limited details available beyond reading (daily/line-by-line), passage-by-reference, and search.

Captured live from the server via tools/list.

get_today

Today's reading, line by line (same as the app shows today). Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters1

date

string

optional

Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

list_readings

All curated daily readings and plans. Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

get_reading

One reading or plan, line by line. Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters1

string

required

A reading or plan id from list_readings, or a plan name such as "japji" or "The Gita in 18 Days".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "A reading or plan id from list_readings, or a plan name such as \"japji\" or \"The Gita in 18 Days\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

search_readings

Search the curated readings, best match first. Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters1

string

required

Words to search for, for example forgiveness or shepherd.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words to search for, for example forgiveness or shepherd."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

get_passage

Any verse, range, chapter or cross-chapter range (Genesis 1:1-2:3) of the World English Bible.

Parameters1

ref

string

required

For example: John 3:16.

Raw schema

{
  "type": "object",
  "properties": {
    "ref": {
      "type": "string",
      "description": "For example: John 3:16."
    }
  },
  "required": [
    "ref"
  ],
  "additionalProperties": false
}

get_card

Today's reading one line at a time, for voice.. Bible: daily readings, plans, search and passage lookup (World English Bible)

Parameters3

n	integer	optional	Which card, starting at 1. Defaults to 1.
reading	string	optional	A reading or plan id from list_readings. Defaults to today's reading.
date	string	optional	Optional day as YYYY-MM-DD. Defaults to today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Which card, starting at 1. Defaults to 1."
    },
    "reading": {
      "type": "string",
      "description": "A reading or plan id from list_readings. Defaults to today's reading."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Optional day as YYYY-MM-DD. Defaults to today (UTC)."
    }
  },
  "required": [],
  "additionalProperties": false
}

README.md4 KBView on GitHub

goodturn-mcp

Remote MCP servers for 25 free, read-only everyday helpers by Good Turn Studio: money, health, jobs, travel, shopping, halal checks, football and scripture reading. One Cloudflare Worker turns each product's public OpenAPI spec into an MCP server, so any assistant that speaks MCP (Claude, ChatGPT, Alexa+, Cursor, VS Code and others) can use them.

One server per product: https://goodturn-mcp.pages.dev/<slug>/mcp
All products in one: https://goodturn-mcp.pages.dev/all/mcp (tool names start with the product slug)
Streamable HTTP, stateless JSON, MCP 2025-11-25 (and 2025-06-18, 2025-03-26), no sign-in
Every tool is read-only, with a title and annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true)
Nothing about the user is stored. Privacy: https://goodturn-mcp.pages.dev/privacy

Products

Product	Slug	What it does
Mizan	`mizan`	Shariah screening of US stocks under four standards, halal alternatives, purification, zakat
Halal or Not	`halalornot`	Halal checks for food, ingredients, medicines, stocks, funds and crypto
Fare Deals	`faredeals`	Cheap flights from any city, and the cheapest days to fly
Cheapest Price	`cheapestprice`	The lowest current price for a product, checked live
Spin My Day	`spinmyday`	A whole day out in any city, matched to weather, mood and diet
Cancel My Sub	`cancelmysub`	How to cancel US and UK subscriptions, and what a card charge is
Lower My Bill	`lowermybill`	Call scripts and low-cost plans to lower household bills
Price Drop Back	`pricedropback`	Store price-adjustment rules, deadlines and a claim message
Find My Money	`findmymoney`	Official unclaimed money searches in the US and UK
Supplement Check	`supplementcheck`	Supplement labels and doses against official upper limits
Plate Pal	`platepal`	Calories and nutrition for foods, chain meals and barcodes
Plan My Workout	`planmyworkout`	Workout plans and how to do any exercise
Med Bill Check	`medbillcheck`	US medical bills against Medicare rates, with dispute letters
Appeal My Claim	`appealmyclaim`	US health insurance denials, rights, deadlines and appeal letters
Job Spotter	`jobspotter`	Current US and UK job listings
Sync My Cycle	`syncmycycle`	Likely cycle phase today, with food and workout ideas
Wardrobe Connect	`wardrobeconnect`	Clothes that match a description or a picture
Form Guide	`formguide`	Football form, fixtures, results and tables
Books Like This	`bookslikethis`	Books like one you enjoyed, and screen adaptations
Talmud Scroller	`talmud`	Daily Talmud with Daf Yomi, and tractates in English
Scroll the Gurbani	`gurbani`	Daily Gurbani with English, any Ang or shabad
Gita Scroller	`gita`	Daily Bhagavad Gita verses with English
Scroll the Lore	`lore`	Greek and Norse myth, Homer, Hesiod and the Poetic Edda
Stoic Scroller	`stoics`	Marcus Aurelius, Epictetus and Seneca
Bible Swipe	`bible`	Daily Bible readings and any passage

How it works

build.py reads each product's live openapi.json and writes products.js: one tool per GET operation, named from its operationId, with inputs from its parameters. Descriptions are tidied into plain tool descriptions.
worker.mjs is the MCP server: initialize, tools/list and tools/call, which calls the product's own API and returns its answer. Answers with a say field carry a ready-made summary.
servers.json lists every server for the official MCP Registry (as io.github.GoodTurnStudio/<slug>). The Publish to the MCP Registry workflow logs in with GitHub OIDC and runs publish.py; publish.ps1 does the same from Windows.

Build and test

code

npm install
npm run build          # python3 build.py, then bundle to deploy/_worker.js
npm test               # every product through the worker, against the live APIs
npm run test:live      # every tool through the deployed servers with the MCP SDK client

Deploy deploy/ as a Cloudflare Pages project in advanced mode (_worker.js).

Licence

MIT for this code. Each product's API, data and answers belong to that product and are served under its own terms, linked from its page at https://goodturn-mcp.pages.dev/<slug>.

Install

Tools (6)

get_todaylist_readingsget_readingsearch_readingsget_passageget_card

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://goodturn-mcp.pages.dev/bible/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "bible": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://goodturn-mcp.pages.dev/bible/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.GoodTurnStudio/bible (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_today

list_readings

get_reading

search_readings

get_passage

get_card

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers