home / mcp / gospel library mcp server
Provides scripture tools and conference talks through an MCP interface for LLMs, enabling exact verse lookups, keyword searches, random verses, and talk retrieval.
Configuration
View docs{
"mcpServers": {
"adammharris-gospel-library-mcp": {
"url": "https://gospel-library-mcp.harrisadam42103.workers.dev/sse",
"headers": {
"GOSPEL_DB_PATH": "/path/to/database/gospel-library.db"
}
}
}
}You can run the Gospel Library MCP Server to expose Gospel Library data to LLM interfaces like Claude, ChatGPT, or LM Studio. It provides tools to fetch exact scriptures, search by keywords, retrieve a random verse, and find conference talks, enabling intelligent, context-aware scripture exploration directly from your preferred large language model.
Connect to the MCP server from your client by choosing either the remote HTTP endpoint or a local STDIO setup. The HTTP option uses a remote URL, while the STDIO option runs the server on your machine and communicates through standard input/output. Once connected, you can invoke the available tools to fetch scriptures, search topics, or retrieve talks and random verses. Always fetch the exact scripture text before quoting to ensure accuracy, and use keyword searches to discover verses related to a topic or theme. When you receive results, review the snippet content and then proceed with your workflow in your client.
Key capabilities you can use in your MCP client include: getting an exact scripture reference, searching scriptures by keyword, getting a random scripture, and searching conference talks by speaker, conference date, or topic. Use fuzzy matching to accommodate variations in book names or speaker spellings, and rely on intelligent filtering to combine multiple search parameters for precise results.
Prerequisites: you need Node.js and npm (or a compatible JavaScript runtime) installed on your machine.
1. Create a local configuration to run the MCP server in STDIO mode. Use the command and arguments shown in the snippet to start the server with access to your Gospel Library database.
{
"mcpServers": {
"gospel_stdio": {
"type": "stdio",
"name": "gospel_stdio",
"command": "node",
"args": ["dist/stdio-server.js"],
"env": { "GOSPEL_DB_PATH": "/Users/path/to/database/gospel-library.db" }
}
}
}2. If you prefer a remote setup, deploy the HTTP MCP endpoint and connect your client to the provided URL. The remote endpoint path is /sse on the deployment URL.
3. If you are using the remote deployment, ensure your client supports MCP servers and that you point it at the correct URL for the streaming endpoint.
Local STDIO configuration uses a local database file. The server will search for gospel-library.db in the project root first, and then fall back to a cloud-based D1 binding if no local database is found. To operate entirely offline, place a SQLite dump named gospel-library.db in the project root.
Remote deployment provides a single URL you can connect to from your MCP client. The recommended remote approach is to use the one-click deployment flow to get up and running quickly.
If a search returns no results, you will receive actionable hints suggesting alternative search terms or parameter adjustments. Ensure the local database path is correct when running in STDIO mode, and verify that the remote URL is reachable when using the HTTP configuration.
Security considerations: keep your local database path secure and prevent exposure of the database file to untrusted clients. When using remote deployment, rely on the host’s security and access controls for the MCP endpoint.
Find a specific scripture reference
- get_exact_scripture{ reference: "John 3:16" }
- get_exact_scripture{ reference: "Omni 7" } // Fuzzy matches to Omni 1:7
- get_exact_scripture{ reference: "Matt 5:16" } // Fuzzy matches to Matthew 5:16Search scriptures by topic
- search_scriptures_by_keyword{ query: "charity", limit: 5 }
- search_scriptures_by_keyword{ query: "plan of salvation" }Find a Russell M. Nelson talk from October 1990
- search_conference_talks{ speaker: "Russell M. Nelson", conference: "October 1990" }Get a full talk by ID
- search_conference_talks{ id: 12345 }Fetch an exact scripture verse or short contiguous range with fuzzy matching and a range limit. Always resolve wording before quoting.
Search scriptures by keyword or phrase to discover topics. Optional limit caps results; default is 10.
Return a single random scripture verse for daily prompts or inspiration.
Search and retrieve General Conference talks by speaker, conference date, and keywords. Supports fuzzy matching and multi-parameter filtering; returns full talk when a single match is found.