@pipeworx/mcp-bible 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pipeworx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @pipeworx/mcp-bible
+
+MCP server for [bible-api.com](https://bible-api.com) — look up verses by reference, retrieve passages in multiple translations, and get random verses. Free, no auth required.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_verse` | Fetch a verse or verse range by reference (WEB translation) |
+| `get_passage` | Fetch a passage with a specific translation (KJV, WEB, etc.) |
+| `random_verse` | Fetch a random Bible verse |
+
+## Quick Start
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "bible": {
+      "type": "url",
+      "url": "https://gateway.pipeworx.io/bible"
+    }
+  }
+}
+```
+
+## CLI Usage
+
+```bash
+npx @anthropic-ai/mcp-client https://gateway.pipeworx.io/bible
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@pipeworx/mcp-bible",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "keywords": ["mcp", "mcp-server", "model-context-protocol", "pipeworx", "bible"],
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,147 @@
+/**
+ * Bible MCP — wraps the Bible API (free, no auth)
+ * https://bible-api.com
+ *
+ * Tools:
+ * - get_verse: fetch a specific Bible verse or verse range by reference
+ * - get_passage: fetch a passage with a specific translation
+ * - random_verse: fetch a random Bible verse
+ */
+
+interface McpToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: 'object';
+    properties: Record<string, unknown>;
+    required?: string[];
+  };
+}
+
+interface McpToolExport {
+  tools: McpToolDefinition[];
+  callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+}
+
+const BASE_URL = 'https://bible-api.com';
+
+const tools: McpToolExport['tools'] = [
+  {
+    name: 'get_verse',
+    description:
+      'Fetch a specific Bible verse or verse range by reference (e.g. "john 3:16", "romans 8:28", "psalm 23:1-6"). Returns the verse text in the World English Bible (WEB) translation.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        reference: {
+          type: 'string',
+          description:
+            'Bible reference string (e.g. "john 3:16", "genesis 1:1-3", "psalm 23"). Spaces will be encoded automatically.',
+        },
+      },
+      required: ['reference'],
+    },
+  },
+  {
+    name: 'get_passage',
+    description:
+      'Fetch a Bible passage with a specified translation. Supported translations: web (World English Bible), kjv (King James Version), oeb-us, bbe, webbe, cherokee, dra.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        reference: {
+          type: 'string',
+          description: 'Bible reference string (e.g. "john 3:16", "genesis 1:1-5")',
+        },
+        translation: {
+          type: 'string',
+          description:
+            'Translation code: "web" (default), "kjv", "oeb-us", "bbe", "webbe", "cherokee", "dra"',
+        },
+      },
+      required: ['reference', 'translation'],
+    },
+  },
+  {
+    name: 'random_verse',
+    description:
+      'Fetch a random Bible verse. Returns the reference, text, and translation.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      required: [],
+    },
+  },
+];
+
+async function callTool(name: string, args: Record<string, unknown>): Promise<unknown> {
+  switch (name) {
+    case 'get_verse':
+      return getVerse(args.reference as string);
+    case 'get_passage':
+      return getPassage(args.reference as string, args.translation as string);
+    case 'random_verse':
+      return randomVerse();
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
+
+interface BibleApiResponse {
+  reference: string;
+  text: string;
+  translation_id: string;
+  translation_name: string;
+  verses: Array<{
+    book_id: string;
+    book_name: string;
+    chapter: number;
+    verse: number;
+    text: string;
+  }>;
+}
+
+function formatResponse(data: BibleApiResponse) {
+  return {
+    reference: data.reference,
+    translation: data.translation_id,
+    translation_name: data.translation_name,
+    text: data.text.trim(),
+    verses: data.verses.map((v) => ({
+      book: v.book_name,
+      chapter: v.chapter,
+      verse: v.verse,
+      text: v.text.trim(),
+    })),
+  };
+}
+
+async function getVerse(reference: string) {
+  const encodedRef = encodeURIComponent(reference);
+  const res = await fetch(`${BASE_URL}/${encodedRef}`);
+  if (!res.ok) throw new Error(`Bible API error: ${res.status}`);
+
+  const data = (await res.json()) as BibleApiResponse;
+  return formatResponse(data);
+}
+
+async function getPassage(reference: string, translation: string) {
+  const encodedRef = encodeURIComponent(reference);
+  const params = new URLSearchParams({ translation });
+
+  const res = await fetch(`${BASE_URL}/${encodedRef}?${params}`);
+  if (!res.ok) throw new Error(`Bible API error: ${res.status}`);
+
+  const data = (await res.json()) as BibleApiResponse;
+  return formatResponse(data);
+}
+
+async function randomVerse() {
+  const res = await fetch(`${BASE_URL}/?random=verse`);
+  if (!res.ok) throw new Error(`Bible API error: ${res.status}`);
+
+  const data = (await res.json()) as BibleApiResponse;
+  return formatResponse(data);
+}
+
+export default { tools, callTool } satisfies McpToolExport;

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true
+  },
+  "include": ["src"]
+}