Scroll the Gurbani

Official9 tools

by GoodTurnStudio · JavaScript

Gurbani a few lines a day in Gurmukhi with English, any Ang or shabad, and whole banis.

Model Context Protocol (MCP) Server: io.github.GoodTurnStudio/gurbani

This MCP server provides “Gurbani a few lines a day” in Gurmukhi, along with English. It supports selecting any Ang or shabad, and it can return whole banis. The server description indicates it is focused on daily Gurbani content delivery across these granularity levels.

🛠️ Key Features

Few lines per day Gurbani
Output includes Gurmukhi and English
Supports any Ang or shabad
Supports whole banis

🚀 Use Cases

Daily Gurbani reading with Gurmukhi + English
Retrieving specific Ang or shabad selections
Fetching full bani texts

⚡ Developer Benefits

Consistent content retrieval across Ang/shabad and whole bani
Bilingual results (Gurmukhi with English) as described

⚠️ Limitations

Only information provided is about Gurbani content; no additional capabilities or tooling details are included in the source data.

Captured live from the server via tools/list.

get_today

Today's reading, line by line (same as the app shows today). Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

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. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

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

get_reading

One reading or plan, line by line. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

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. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters1

string

required

Words or a bani's name to search for, for example Japji or humility.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Words or a bani's name to search for, for example Japji or humility."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

get_ang

Every line on an Ang in Gurmukhi with transliteration and English. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters1

ang

integer

required

The Ang (page) of Sri Guru Granth Sahib, 1 to 1430.

Raw schema

{
  "type": "object",
  "properties": {
    "ang": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1430,
      "description": "The Ang (page) of Sri Guru Granth Sahib, 1 to 1430."
    }
  },
  "required": [
    "ang"
  ],
  "additionalProperties": false
}

get_shabad

A whole shabad by BaniDB id, with transliteration and English. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters1

integer

required

A BaniDB shabad ID.

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "A BaniDB shabad ID."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

get_card

Today's reading one line at a time, for voice.. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

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
}

list_books

The whole books in the Library that can be read a passage at a time. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters

No parameters.

Raw schema

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

read_book

Follow next for the next passage; it carries on into the next chapter. Gurbani: daily shabad, plans, search, Ang and shabad lookup; whole books from the Library, read a passage at a time.

Parameters4

book	string	required	Book id or title from list_books, for example japji, sukhmani.
section	string	optional	Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, "chapter 2", "havamal", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it.
n	integer	optional	Passage within the section, starting at 1.
ref	string	optional	Optional: jump straight to a passage by its reference, for example "Havamal 139", "Meditations 4.3", "Gita 2.47", "Iliad 1.5" or "10b". Overrides section and n.

Raw schema

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "Book id or title from list_books, for example japji, sukhmani."
    },
    "section": {
      "type": "string",
      "description": "Chapter, book, poem, letter or daf to start at, as listed in the book (for example 5, \"chapter 2\", \"havamal\", or 10b for the second side of a daf). Defaults to the beginning; Bekhorot defaults to today's Daf Yomi page while the cycle is in it."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "description": "Passage within the section, starting at 1."
    },
    "ref": {
      "type": "string",
      "description": "Optional: jump straight to a passage by its reference, for example \"Havamal 139\", \"Meditations 4.3\", \"Gita 2.47\", \"Iliad 1.5\" or \"10b\". Overrides section and n."
    }
  },
  "required": [
    "book"
  ],
  "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 (9)

get_todaylist_readingsget_readingsearch_readingsget_angget_shabadget_cardlist_books

Remote endpoint

Streamable HTTP

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

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

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

Model Context Protocol (MCP) Server: io.github.GoodTurnStudio/gurbani

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_today

list_readings

get_reading

search_readings

get_ang

get_shabad

get_card

list_books

read_book

goodturn-mcp

Products

How it works

Build and test

Licence

Install

Remote endpoint

Related servers