{"openapi":"3.1.0","info":{"title":"Scripture API","version":"0.1.0","description":"Bible (17 translations + KJV search), Bhagavad Gita, Hukamnama and Guru Granth Sahib, Jewish texts via Sefaria, Dhammapada, Tao Te Ching, daily reading.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://scripture.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/scripture/docs"},"termsOfService":"https://connectorbay.com/scripture/terms"},"servers":[{"url":"https://scripture.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/scripture/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/bible_passage":{"post":{"operationId":"bible_passage","summary":"A Bible passage — a verse, a range or a whole chapter — in the translation asked for, verse by verse with the","description":"A Bible passage — a verse, a range or a whole chapter — in the translation asked for, verse by verse with the\n    joined text. Use for \"read me Psalm 23\", \"John 3:16 in the KJV\", \"Romans 8:28-39\", \"Genesis 1 in Latin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"reference":{"description":"A reference: 'John 3:16', 'Psalm 23', 'Romans 8:28-39', '1 Cor 13:4-7', 'Genesis 1:1-2:3'.","examples":["John 3:16","Psalm 23","1 Corinthians 13:4-7"],"title":"Reference","type":"string"},"translation":{"default":"web","description":"web (default), kjv, asv, bbe, darby, dra, ylt, oeb-us, oeb-cw, webbe, clementine (Latin), almeida (Portuguese), rccv (Romanian), synodal (Russian), cuv (Chinese), bkr (Czech), cherokee.","examples":["web","kjv"],"title":"Translation","type":"string"}},"required":["reference"],"title":"bible_passageArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/bible_search":{"post":{"operationId":"bible_search","summary":"Full-text search of the King James Version (bundled, 31,102 verses): exact phrase matches first, then verses","description":"Full-text search of the King James Version (bundled, 31,102 verses): exact phrase matches first, then verses\n    containing all the words; filter by book or testament. Use for \"where does the Bible say X\", \"verses about\n    forgiveness\", \"find 'the Lord is my shepherd'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A phrase or words to find, e.g. 'love is patient', 'fear not', 'shepherd'.","examples":["love is patient","fear not"],"title":"Query","type":"string"},"book":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Limit to one book.","examples":["Psalms"],"title":"Book"},"testament":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"'old' or 'new'.","examples":["new"],"title":"Testament"},"max_results":{"default":30,"maximum":100,"minimum":1,"title":"Max Results","type":"integer"}},"required":["query"],"title":"bible_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/bible_books":{"post":{"operationId":"bible_books","summary":"The 66 books of the Protestant canon with chapter counts, plus the available translations and their languages.","description":"The 66 books of the Protestant canon with chapter counts, plus the available translations and their languages.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"bible_booksArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/gita_verse":{"post":{"operationId":"gita_verse","summary":"A Bhagavad Gita verse: Sanskrit (Devanagari), IAST transliteration, English translations by Swami Sivananda, Shri","description":"A Bhagavad Gita verse: Sanskrit (Devanagari), IAST transliteration, English translations by Swami Sivananda, Shri\n    Purohit Swami, Swami Gambirananda, Swami Adidevananda and Prabhupada, and Hindi by Swami Tejomayananda, with the\n    chapter's name. Use for \"Gita 2:47\", \"karmanye vadhikaraste verse\", \"what does 18.66 say\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chapter":{"description":"Chapter 1–18.","maximum":18,"minimum":1,"title":"Chapter","type":"integer"},"verse":{"description":"Verse number within the chapter.","maximum":78,"minimum":1,"title":"Verse","type":"integer"},"translator":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Prefer one English translation: sivananda, purohit, gambirananda, adidevananda, prabhupada. Default: all.","examples":["sivananda"],"title":"Translator"}},"required":["chapter","verse"],"title":"gita_verseArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/gita_chapter":{"post":{"operationId":"gita_chapter","summary":"A Gita chapter's name (Sanskrit, transliterated, translated), meaning, verse count and summary — or the list of all","description":"A Gita chapter's name (Sanskrit, transliterated, translated), meaning, verse count and summary — or the list of all\n    18 chapters. Use for \"what is chapter 12 of the Gita about\", \"list the Gita's chapters\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chapter":{"anyOf":[{"maximum":18,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Chapter 1–18; omit to list all chapters.","title":"Chapter"}},"title":"gita_chapterArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/gita_search":{"post":{"operationId":"gita_search","summary":"Search all 700 verses of the Gita (English translations) for words or a theme, returning references with one","description":"Search all 700 verses of the Gita (English translations) for words or a theme, returning references with one\n    translation each; fetch the full verse with gita_verse. Use for \"what does the Gita say about anger\", \"verses on\n    meditation\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Words to find in the English translations.","examples":["anger","duty without attachment"],"title":"Query","type":"string"},"max_results":{"default":15,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"}},"required":["query"],"title":"gita_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hukamnama":{"post":{"operationId":"hukamnama","summary":"The Hukamnama — the daily order read at Sri Darbar Sahib (Golden Temple), Amritsar — in Gurmukhi with English","description":"The Hukamnama — the daily order read at Sri Darbar Sahib (Golden Temple), Amritsar — in Gurmukhi with English\n    translation and transliteration, ang, raag and writer. Use for \"today's Hukamnama\", \"what was the Hukamnama on a date\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"day":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date (YYYY-MM-DD) for a past day; default today.","examples":["2026-09-22"],"title":"Day"}},"title":"hukamnamaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/gurbani":{"post":{"operationId":"gurbani","summary":"Sri Guru Granth Sahib: a whole ang (page) line by line, one shabad by id, or a Gurmukhi search — each line with","description":"Sri Guru Granth Sahib: a whole ang (page) line by line, one shabad by id, or a Gurmukhi search — each line with\n    Gurmukhi, English transliteration, and English/Punjabi translation. Use for \"ang 1 of the Guru Granth Sahib\", \"read\n    the Mool Mantar\", \"find lines with ਵਾਹਿਗੁਰੂ\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ang":{"anyOf":[{"maximum":1430,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Ang (page) of Sri Guru Granth Sahib, 1–1430.","title":"Ang"},"shabad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A shabad id from a search or Hukamnama (e.g. 'DMP').","examples":["DMP"],"title":"Shabad Id"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Gurmukhi (Unicode) words to search, e.g. 'ਸਤਿ ਨਾਮੁ'; or first letters.","examples":["ਸਤਿ ਨਾਮੁ"],"title":"Search"},"search_mode":{"default":"full","description":"'full' (whole words) or 'first_letters'.","examples":["full"],"title":"Search Mode","type":"string"},"max_results":{"default":10,"maximum":50,"minimum":1,"title":"Max Results","type":"integer"}},"title":"gurbaniArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/jewish_text":{"post":{"operationId":"jewish_text","summary":"Tanakh, Talmud, Mishnah, Midrash, halakhic and other Jewish texts from Sefaria by reference, in English or Hebrew,","description":"Tanakh, Talmud, Mishnah, Midrash, halakhic and other Jewish texts from Sefaria by reference, in English or Hebrew,\n    with the version and licence named and links to the previous/next section. Use for \"Genesis 1 in Hebrew\", \"what\n    does Pirkei Avot 1:14 say\", \"Berakhot 2a\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"reference":{"description":"A Sefaria-style reference: 'Genesis 1:1-5', 'Exodus 20', 'Berakhot 2a', 'Pirkei Avot 1:14', 'Mishnah Peah 1:1', 'Psalms 23'.","examples":["Genesis 1:1-5","Berakhot 2a","Pirkei Avot 1:14"],"title":"Reference","type":"string"},"language":{"default":"english","description":"'english' or 'hebrew'.","examples":["english"],"title":"Language","type":"string"}},"required":["reference"],"title":"jewish_textArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/dhammapada":{"post":{"operationId":"dhammapada","summary":"The Dhammapada (Bhikkhu Sujato's translation, CC0, with Pali): one verse, a whole chapter, or a search — or, with","description":"The Dhammapada (Bhikkhu Sujato's translation, CC0, with Pali): one verse, a whole chapter, or a search — or, with\n    no arguments, the 26 chapters. Use for \"Dhammapada verse 5\", \"the chapter on anger\", \"Dhammapada on hatred\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"verse":{"anyOf":[{"maximum":423,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Verse 1–423.","title":"Verse"},"chapter":{"anyOf":[{"maximum":26,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Chapter 1–26 (whole chapter).","title":"Chapter"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Words to find in the English translation.","examples":["hatred"],"title":"Search"}},"title":"dhammapadaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/tao_te_ching":{"post":{"operationId":"tao_te_ching","summary":"The Tao Te Ching in James Legge's 1891 translation: one of the 81 chapters, or a search across all of them. Use","description":"The Tao Te Ching in James Legge's 1891 translation: one of the 81 chapters, or a search across all of them. Use\n    for \"Tao Te Ching chapter 8\", \"the chapter about the empty vessel\", \"what does the Tao say about water\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chapter":{"anyOf":[{"maximum":81,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Chapter 1–81.","title":"Chapter"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Words to find.","examples":["water"],"title":"Search"}},"title":"tao_te_chingArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/daily_reading":{"post":{"operationId":"daily_reading","summary":"A reading for the day — the same for everyone on a given date — from one tradition or all: a Bible verse (WEB), a","description":"A reading for the day — the same for everyone on a given date — from one tradition or all: a Bible verse (WEB), a\n    Gita verse, today's Hukamnama, a Dhammapada verse and a Tao Te Ching chapter. Use for \"verse of the day\", \"a\n    reading for today from the Gita\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"tradition":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"bible, gita, sikh, buddhist, taoist — or omit for all.","examples":["bible"],"title":"Tradition"},"day":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date; default today (UTC).","title":"Day"}},"title":"daily_readingArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}