JW.Org MCP Tool
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@JW.Org MCP Tool What does the Bible say about love?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
JW.Org MCP Tool
A Model Context Protocol (MCP) server that provides controlled, verifiable access to content from jw.org for AI applications and LLM integrations.
Overview
The JW.Org MCP Tool ensures that scriptural and doctrinal information comes exclusively from official jw.org sources, eliminating the risk of hallucinations or external contamination when handling religious queries. This tool acts as a trusted intermediary between AI applications and jw.org content.
Related MCP server: JW MCP Server
Features
Trusted Source Enforcement: Fetches data strictly from jw.org domains
Comprehensive Search: Search across articles, videos, publications, audio, and scriptures
Intelligent Query Parsing: Extracts meaningful search terms from natural language queries
Full Article Retrieval: Get complete article content with scripture references
Scripture Lookup: Direct scripture reference search
Performance Optimized: 15-minute caching, Brotli compression, async operations
Structured Output: Machine-readable responses with verification metadata
Installation
Requirements
Python 3.13+
uv for package management
Install with uv
# Clone the repository
git clone https://github.com/yourusername/jw-org-mcp.git
cd jw-org-mcp
# Install dependencies
uv sync
# Install with development dependencies
uv sync --group devUsage
Running the MCP Server
uv run jw-org-mcpThe server runs in stdio mode and communicates via the Model Context Protocol.
Adding to Claude Desktop
To use this MCP server with Claude Desktop, add it to your Claude configuration file:
Location:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Configuration:
{
"mcpServers": {
"jw-org": {
"command": "uv",
"args": [
"--directory",
"E:\\Projects\\Python\\jw-org-mcp",
"run",
"jw-org-mcp"
]
}
}
}Note: Replace E:\\Projects\\Python\\jw-org-mcp with the actual path to your project directory. On Windows, use double backslashes (\\) in the path.
After saving the configuration:
Restart Claude Desktop
The JW.Org MCP tools will be available in your conversations
Look for tools like
search_content,get_article, andget_scripture
Configuration
Configuration is done via environment variables with the prefix JWORG_MCP_:
# Cache settings
export JWORG_MCP_CACHE_TTL_SECONDS=900 # 15 minutes (default)
export JWORG_MCP_ENABLE_CACHE=true
# Request settings
export JWORG_MCP_REQUEST_TIMEOUT=30
export JWORG_MCP_MAX_RETRIES=3
# Search settings
export JWORG_MCP_DEFAULT_LANGUAGE=E # English
export JWORG_MCP_DEFAULT_SEARCH_LIMIT=10
# Logging
export JWORG_MCP_LOG_LEVEL=INFOMCP Tools
search_content
Search JW.Org content across multiple types.
Parameters:
query(required): Search query - can be natural languagefilter(optional): Content type -all,publications,videos,audio,bible,indexes(default:all)language(optional): Language code -Efor English,Sfor Spanish, etc. (default:E)limit(optional): Maximum results (default: 10)
Example:
{
"query": "What does the Bible say about love?",
"filter": "all",
"limit": 5
}The query parser automatically extracts "love" as the search term.
get_article
Retrieve full article content from a jw.org URL.
Parameters:
url(required): Article URL from wol.jw.org
Example:
{
"url": "https://wol.jw.org/en/wol/d/r1/lp-e/1985720"
}get_scripture
Get scripture text by reference.
Parameters:
reference(required): Scripture reference (e.g., "John 3:16", "1 Thessalonians 5:3")translation(optional): Bible translation code (default: "nwtsty")
Example:
{
"reference": "John 3:16"
}get_cache_stats
Get cache statistics including hit rate and entry count.
Parameters: None
Development
Setup Development Environment
# Install with development dependencies
uv sync --group dev
# Install pre-commit hooks (optional)
uv run pre-commit installRunning Tests
# Run all tests
uv run pytest
# Run with coverage
uv run pytest --cov=jw_org_mcp --cov-report=html
# Run specific test file
uv run pytest tests/test_parser.pyCode Quality
# Run linter
uv run ruff check .
# Format code
uv run ruff format .
# Type checking
uv run mypy src/jw_org_mcpProject Structure
jw-org-mcp/
├── src/
│ └── jw_org_mcp/
│ ├── __init__.py # Entry point
│ ├── auth.py # Authentication & CDN discovery
│ ├── cache.py # Caching layer
│ ├── client.py # JW.Org API client
│ ├── config.py # Configuration management
│ ├── exceptions.py # Custom exceptions
│ ├── models.py # Data models
│ ├── parser.py # Content parsers
│ └── server.py # MCP server implementation
├── tests/ # Test suite
├── docs/ # Documentation
├── pyproject.toml # Project configuration
└── README.mdArchitecture
Authentication Flow
Discover CDN URL from jw.org homepage
Request JWT token from CDN endpoint
Use token for authenticated API requests
Automatically refresh token before expiration
Search Flow
Parse user query to extract search terms
Check cache for existing results
Make authenticated API request if cache miss
Parse and structure response
Cache results for 15 minutes
Return structured data
Content Retrieval
Fetch HTML content from wol.jw.org
Parse article structure (title, paragraphs, references)
Extract clean text without HTML artifacts
Cache parsed content
Return structured article data
API Response Format
All responses include metadata for verification:
{
"data": {
// Response-specific data
},
"metadata": {
"source_domain": "jw.org",
"source_url": "https://...",
"timestamp": "2024-01-01T00:00:00Z",
"query_params": {},
"cache_hit": false
}
}Performance
Response Time: < 2 seconds for search queries (cached: < 100ms)
Cache TTL: 15 minutes (configurable)
Compression: Brotli for all API requests
Concurrency: Async I/O with connection pooling
Error Handling
The tool provides graceful error handling with specific exception types:
AuthenticationError: JWT token issuesCDNDiscoveryError: CDN discovery failuresSearchError: Search operation failuresContentRetrievalError: Content fetch failuresParseError: Content parsing failures
All errors are logged and returned with descriptive messages.
Security & Privacy
No PII Logging: No personally identifiable information is logged
HTTPS Only: All external requests use HTTPS
Token Security: JWT tokens are managed securely in memory
Input Validation: All user inputs are sanitized
Contributing
Fork the repository
Create a feature branch
Make your changes with tests
Ensure all tests pass and code is formatted
Submit a pull request
License
[Add your license here]
Support
For issues and questions:
GitHub Issues: [Add your repo URL]
Documentation: See
docs/folder
Acknowledgments
Built with FastMCP
Uses the Model Context Protocol standard
Provides verified access to jw.org content
Available Tools
4 toolsget_articleA
Retrieve full article content from a JW.Org URL. Returns the article text with paragraphs and scripture references.
Inputs: url (required).
get_cache_statsA
Get cache statistics including hit rate and entry count.
Inputs: no named parameters.
get_scriptureA
Get scripture text by reference (e.g., 'John 3:16', '1 Thessalonians 5:3'). Returns the scripture text and reference.
Inputs: reference (required), translation.
search_contentA
Search JW.Org content including articles, videos, publications, audio, and scriptures. Extracts meaningful search terms from natural language queries.
Inputs: query (required), limit, filter, language.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: searching content, retrieving an article, fetching scripture, and inspecting cache statistics. There is no overlap or ambiguity between them.
All tool names follow a consistent verb_noun pattern in snake_case (search_content, get_article, get_scripture, get_cache_stats), making the API predictable and easy to navigate.
With 4 tools, the server is well-scoped for its purpose of accessing JW.Org content. Each tool is essential and the count is neither sparse nor excessive.
The core workflow of searching and retrieving content is covered, including article and scripture retrieval. A minor gap is the lack of direct retrieval for other content types (e.g., videos, audio), but search covers discovery for those, so the surface feels reasonably complete.
Maintenance
Related MCP Connectors
Scripture-cited answers to any Bible question, plus verse text and study pages, for AI agents.
Verbatim scripture for AI (Septuagint, KJV, Geneva, WEB, 1 Enoch) plus branded verse images.
AI Bible study you can actually check: Scripture, Hebrew and Greek, and the church fathers.
Faith tools for AI agents: cited KJV Scripture, ORA Q&A, sermons, churches, prayer & giving.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides read-only access to the Watchtower Online Library (WOL) with advanced search capabilities, document retrieval, and multilingual support. Enables users to search and browse Jehovah's Witnesses publications through natural language interactions.5MIT
- AlicenseAqualityCmaintenanceProvides access to JW.org content including Christian Life and Ministry workbook materials, Watchtower study articles, and video captions with subtitles across multiple languages.9118 npm43MIT
- AlicenseAqualityCmaintenanceAn MCP server that provides controlled, verifiable access to official jw.org content, enabling AI applications to search articles, retrieve full articles, and lookup scriptures without hallucinations.416GPL 3.0
- AlicenseAqualityDmaintenanceA remote MCP server for traceable research across JW.org and the Watchtower Online Library, providing tools for searching, retrieving articles, footnotes, cross-references, and daily texts with optional AI-powered synthesis.202MIT