{"openapi":"3.1.0","info":{"title":"Bible MCP Server","version":"0.1.0","description":"HTTP Actions API for custom GPTs and other OpenAPI clients. Remote MCP clients should use Streamable HTTP at /mcp with OAuth 2.1. Stripe stays in test mode on this preview."},"servers":[{"url":"https://mcp.biblemcpserver.com"}],"paths":{"/v1/tools/get_passage":{"post":{"operationId":"get_passage","summary":"Get Passage","description":"Retrieve the exact text of a Bible verse or passage in your chosen supported translation. Key inputs: bibleId and reference. Costs 1 credit.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"bibleId":{"type":"string","enum":["de4e12af7f28f599-02","0a8c5612ed1cb866-01","a556c5305ee15c3f-01","d6e14a625393b4da-01","a81b73293d3080c9-01","63097d2a0a2f7db3-01","592420522e16049f-01","bba9f40183526463-01","9879dbb7cfe39e4d-01","40072c4a5aba4022-01","bb09dd8345dbc13f-01","6bab4d6c61b31b80-01","65bfdebd704a8324-01","72f4e6dc683324df-01","c315fa9f71d4af3a-01","7644de2e4c5188e5-01"],"description":"Supported API.Bible translation id. Call list_translations to see the catalog. Example: de4e12af7f28f599-02 for the King James Version."},"reference":{"type":"string","minLength":1,"maxLength":120,"description":"Scripture reference such as John 3:16 or Romans 8:1-11."}},"required":["bibleId","reference"],"additionalProperties":false,"description":"Fetch licensed Scripture text for one reference in a supported translation."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/list_translations":{"post":{"operationId":"list_translations","summary":"List Translations","description":"Discover the Bible translations available for Scripture retrieval and study. Key inputs: none. Costs 1 credit.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false,"description":"No arguments. Returns the supported translation catalog."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/search_passages":{"post":{"operationId":"search_passages","summary":"Search Passages","description":"Search Scripture by keyword or natural-language question, optionally within a specific translation. Key inputs: query and optional bibleId. Costs 1 credit.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":2000,"description":"Keyword or natural-language question used to search Scripture."},"bibleId":{"type":"string","enum":["de4e12af7f28f599-02","0a8c5612ed1cb866-01","a556c5305ee15c3f-01","d6e14a625393b4da-01","a81b73293d3080c9-01","63097d2a0a2f7db3-01","592420522e16049f-01","bba9f40183526463-01","9879dbb7cfe39e4d-01","40072c4a5aba4022-01","bb09dd8345dbc13f-01","6bab4d6c61b31b80-01","65bfdebd704a8324-01","72f4e6dc683324df-01","c315fa9f71d4af3a-01","7644de2e4c5188e5-01"],"description":"Supported API.Bible translation id. Call list_translations to see the catalog. Example: de4e12af7f28f599-02 for the King James Version."}},"required":["query"],"additionalProperties":false,"description":"Search licensed Scripture by keyword or question."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/understand_passage":{"post":{"operationId":"understand_passage","summary":"Understand Passage","description":"Understand a passage's meaning and explore follow-up questions about its teaching. Key inputs: bibleId, reference, and optional extraQuestion. Costs 2 credits.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"bibleId":{"type":"string","enum":["de4e12af7f28f599-02","0a8c5612ed1cb866-01","a556c5305ee15c3f-01","d6e14a625393b4da-01","a81b73293d3080c9-01","63097d2a0a2f7db3-01","592420522e16049f-01","bba9f40183526463-01","9879dbb7cfe39e4d-01","40072c4a5aba4022-01","bb09dd8345dbc13f-01","6bab4d6c61b31b80-01","65bfdebd704a8324-01","72f4e6dc683324df-01","c315fa9f71d4af3a-01","7644de2e4c5188e5-01"],"description":"Supported API.Bible translation id. Call list_translations to see the catalog. Example: de4e12af7f28f599-02 for the King James Version."},"reference":{"type":"string","minLength":1,"maxLength":120,"description":"Scripture reference such as John 3:16 or Romans 8:1-11."},"extraQuestion":{"type":"string","maxLength":2000,"description":"Optional follow-up about the passage's teaching."}},"required":["bibleId","reference"],"additionalProperties":false,"description":"Study notes for a passage, with an optional follow-up question."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/context_passage":{"post":{"operationId":"context_passage","summary":"Context Passage","description":"Explore a passage's historical setting, author, original audience, and place within its biblical book. Key inputs: bibleId and reference. Costs 2 credits.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"bibleId":{"type":"string","enum":["de4e12af7f28f599-02","0a8c5612ed1cb866-01","a556c5305ee15c3f-01","d6e14a625393b4da-01","a81b73293d3080c9-01","63097d2a0a2f7db3-01","592420522e16049f-01","bba9f40183526463-01","9879dbb7cfe39e4d-01","40072c4a5aba4022-01","bb09dd8345dbc13f-01","6bab4d6c61b31b80-01","65bfdebd704a8324-01","72f4e6dc683324df-01","c315fa9f71d4af3a-01","7644de2e4c5188e5-01"],"description":"Supported API.Bible translation id. Call list_translations to see the catalog. Example: de4e12af7f28f599-02 for the King James Version."},"reference":{"type":"string","minLength":1,"maxLength":120,"description":"Scripture reference such as John 3:16 or Romans 8:1-11."}},"required":["bibleId","reference"],"additionalProperties":false,"description":"Historical and literary context for a passage."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/explain_passage":{"post":{"operationId":"explain_passage","summary":"Explain Passage","description":"Receive an in-depth explanation of a passage, including answers to specific interpretive questions. Key inputs: bibleId, reference, and optional question. Costs 2 credits.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"bibleId":{"type":"string","enum":["de4e12af7f28f599-02","0a8c5612ed1cb866-01","a556c5305ee15c3f-01","d6e14a625393b4da-01","a81b73293d3080c9-01","63097d2a0a2f7db3-01","592420522e16049f-01","bba9f40183526463-01","9879dbb7cfe39e4d-01","40072c4a5aba4022-01","bb09dd8345dbc13f-01","6bab4d6c61b31b80-01","65bfdebd704a8324-01","72f4e6dc683324df-01","c315fa9f71d4af3a-01","7644de2e4c5188e5-01"],"description":"Supported API.Bible translation id. Call list_translations to see the catalog. Example: de4e12af7f28f599-02 for the King James Version."},"reference":{"type":"string","minLength":1,"maxLength":120,"description":"Scripture reference such as John 3:16 or Romans 8:1-11."},"question":{"type":"string","maxLength":2000,"description":"Optional interpretive question about the passage."}},"required":["bibleId","reference"],"additionalProperties":false,"description":"In-depth explanation of a passage."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/ask_emet":{"post":{"operationId":"ask_emet","summary":"Ask Emet","description":"Ask open-ended Bible questions and receive responses grounded in Scripture. Key inputs: message and optional bibleId. Costs 2 credits.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","minLength":1,"maxLength":2000,"description":"Open-ended Bible question for a Scripture-grounded answer."},"bibleId":{"type":"string","enum":["de4e12af7f28f599-02","0a8c5612ed1cb866-01","a556c5305ee15c3f-01","d6e14a625393b4da-01","a81b73293d3080c9-01","63097d2a0a2f7db3-01","592420522e16049f-01","bba9f40183526463-01","9879dbb7cfe39e4d-01","40072c4a5aba4022-01","bb09dd8345dbc13f-01","6bab4d6c61b31b80-01","65bfdebd704a8324-01","72f4e6dc683324df-01","c315fa9f71d4af3a-01","7644de2e4c5188e5-01"],"description":"Supported API.Bible translation id. Call list_translations to see the catalog. Example: de4e12af7f28f599-02 for the King James Version."}},"required":["message"],"additionalProperties":false,"description":"Pastoral, Scripture-first answer to an open-ended Bible question."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/create_study":{"post":{"operationId":"create_study","summary":"Create Study","description":"Generate a comprehensive Bible study on a passage, guided by your own research prompt. Key inputs: reference, optional bibleId, and optional prompt. Costs 3 credits. This is an async tool: it returns a jobId. Poll get_job_status until the job completes.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"reference":{"type":"string","minLength":1,"maxLength":120,"description":"Scripture reference such as John 3:16 or Romans 8:1-11."},"bibleId":{"type":"string","enum":["de4e12af7f28f599-02","0a8c5612ed1cb866-01","a556c5305ee15c3f-01","d6e14a625393b4da-01","a81b73293d3080c9-01","63097d2a0a2f7db3-01","592420522e16049f-01","bba9f40183526463-01","9879dbb7cfe39e4d-01","40072c4a5aba4022-01","bb09dd8345dbc13f-01","6bab4d6c61b31b80-01","65bfdebd704a8324-01","72f4e6dc683324df-01","c315fa9f71d4af3a-01","7644de2e4c5188e5-01"],"description":"Supported API.Bible translation id. Call list_translations to see the catalog. Example: de4e12af7f28f599-02 for the King James Version."},"prompt":{"type":"string","maxLength":2000,"description":"Optional research prompt that guides the study."}},"required":["reference"],"additionalProperties":false,"description":"Enqueue a comprehensive Bible study job for a passage."}}}},"responses":{"200":{"description":"Accepted async job. The payload includes a jobId. Poll get_job_status until the job completes.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/research":{"post":{"operationId":"research","summary":"Research","description":"Conduct in-depth research into biblical themes, words, people, places, events, archaeology, church history, and historical background. Key inputs: query and optional type (theme, word, person, place, event, archaeology, church_history, or context). Costs 3 credits. This is an async tool: it returns a jobId. Poll get_job_status until the job completes.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":2000,"description":"Research question or topic to investigate."},"type":{"type":"string","enum":["theme","word","person","place","event","archaeology","church_history","context"],"description":"Research focus. One of theme, word, person, place, event, archaeology, church_history, or context."}},"required":["query"],"additionalProperties":false,"description":"Enqueue an in-depth biblical research job."}}}},"responses":{"200":{"description":"Accepted async job. The payload includes a jobId. Poll get_job_status until the job completes.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/get_job_status":{"post":{"operationId":"get_job_status","summary":"Get Job Status","description":"Check the progress of background research, study generation, map creation, and other asynchronous tasks, and retrieve their completed results. Key inputs: jobId returned by an async tool. Costs 1 credit.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"jobId":{"type":"string","minLength":8,"maxLength":80,"description":"Identifier returned by an async tool such as research, create_study, create_map, reading_plan, or sermon_outline."}},"required":["jobId"],"additionalProperties":false,"description":"Read the status and result of an async job you own."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/create_map":{"post":{"operationId":"create_map","summary":"Create Map","description":"Generate biblical geography maps from natural-language prompts, including journeys and locations. Key inputs: prompt. Costs 2 credits. This is an async tool: it returns a jobId. Poll get_job_status until the job completes.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":2000,"description":"Natural-language request for a biblical geography map, including journeys and locations."}},"required":["prompt"],"additionalProperties":false,"description":"Enqueue a biblical geography map job."}}}},"responses":{"200":{"description":"Accepted async job. The payload includes a jobId. Poll get_job_status until the job completes.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/reading_plan":{"post":{"operationId":"reading_plan","summary":"Reading Plan","description":"Create personalized Bible reading plans centered on specific topics or study goals. Key inputs: topic. Costs 2 credits. This is an async tool: it returns a jobId. Poll get_job_status until the job completes.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"topic":{"type":"string","minLength":1,"maxLength":2000,"description":"Topic or study goal for the reading plan."}},"required":["topic"],"additionalProperties":false,"description":"Enqueue a personalized Bible reading plan job."}}}},"responses":{"200":{"description":"Accepted async job. The payload includes a jobId. Poll get_job_status until the job completes.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/prayer_assist":{"post":{"operationId":"prayer_assist","summary":"Prayer Assist","description":"Receive Scripture-based assistance in composing prayers for personal needs and requests. Key inputs: request. Costs 2 credits.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"request":{"type":"string","minLength":1,"maxLength":2000,"description":"Personal need or request that should shape the Scripture-based prayer."}},"required":["request"],"additionalProperties":false,"description":"Compose a Scripture-based prayer for a personal request."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/sermon_outline":{"post":{"operationId":"sermon_outline","summary":"Sermon Outline","description":"Develop structured sermon outlines grounded in a selected biblical passage. Key inputs: passage and optional prompt. Costs 3 credits. This is an async tool: it returns a jobId. Poll get_job_status until the job completes.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"passage":{"type":"string","minLength":1,"maxLength":120,"description":"Biblical passage the sermon outline should be grounded in."},"prompt":{"type":"string","maxLength":2000,"description":"Optional emphasis or audience note for the outline."}},"required":["passage"],"additionalProperties":false,"description":"Enqueue a structured sermon outline job."}}}},"responses":{"200":{"description":"Accepted async job. The payload includes a jobId. Poll get_job_status until the job completes.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}},"/v1/tools/journal_assist":{"post":{"operationId":"journal_assist","summary":"Journal Assist","description":"Explore Scripture-based journaling prompts, reflections, and personal study questions. Key inputs: prompt. Costs 2 credits.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","minLength":1,"maxLength":2000,"description":"Journaling theme, passage, or personal study question."}},"required":["prompt"],"additionalProperties":false,"description":"Return Scripture-based journaling prompts and reflections."}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"creditsCharged":{"type":"integer"}}}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"bmcp_test_ API key or OAuth access token (mcp_atk_)."}}}}