faithfinder-mcp-server
This server provides a search tool for finding US churches and faith-based community connections.
Search by city, ZIP code, denomination, worship style, or church name.
Browse all available churches by leaving the search query empty.
Discover faith-based community events and volunteer opportunities.
Get church details plus a link to the Soul Signature quiz for personalized matching.
FaithFinder MCP Server: Find a Church from Any AI Assistant
FaithFinder is a free church finder for the United States. This Model Context Protocol (MCP) server lets ChatGPT, Claude, Gemini, Copilot, Cursor and other AI assistants answer questions like these with real, current church listings:
"Find me a church near Frisco, TX with a good kids ministry"
"We're moving to Nashville. Are there any Reformed or Presbyterian churches?"
"Is there an Anglican church near 30309?"
"What is Watermark Community Church in Dallas like? Where can I watch their sermons?"
"I'm not sure what kind of church fits me. Can you help?"
It searches 22,600+ Christian churches across all 50 states + DC by city, ZIP code, denomination, worship style, kids/youth ministry, size, and theology. Each result includes the church's website, latest sermon video, statement of faith, Google rating, and a link to its FaithFinder profile.
No API key, no account, and no network calls: the data ships with the package and is searched in memory.
Quick start
Claude Desktop
Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):
{
"mcpServers": {
"faithfinder": {
"command": "npx",
"args": ["-y", "faithfinder-mcp-server@latest"]
}
}
}Claude Code
claude mcp add faithfinder -- npx -y faithfinder-mcp-server@latestVS Code / GitHub Copilot
Click Install in VS Code above, or add to .vscode/mcp.json:
{ "servers": { "faithfinder": { "command": "npx", "args": ["-y", "faithfinder-mcp-server@latest"] } } }Cursor
Click Install in Cursor above, or add the Claude Desktop JSON to ~/.cursor/mcp.json.
Windsurf
Add the Claude Desktop JSON to ~/.codeium/windsurf/mcp_config.json.
Gemini CLI
gemini mcp add faithfinder npx -y faithfinder-mcp-server@latestChatGPT, Claude.ai and other web or mobile apps (remote connector)
Web and mobile chat apps connect to a hosted HTTPS endpoint, not to npx. Deploy the server (see Hosting a remote endpoint), then add:
ChatGPT: Settings → Apps & Connectors → Developer mode → Create → URL
https://<your-host>/mcp, no auth.Claude.ai: Settings → Connectors → Add custom connector →
https://<your-host>/mcp.Custom GPT Actions: import
https://<your-host>/openapi.json(oropenai-action.json).
Related MCP server: bible-mcp
Tools
Tool | When an assistant uses it |
| "Find a church near…" requests. Accepts natural language ( |
| Questions about one church: beliefs, sermons, website, reviews, similar churches nearby. |
| The person isn't sure what kind of church fits them. Returns 4 short questions, 4 church archetypes, and the free Soul Signature quiz link. |
| Which states and cities are covered, with counts. |
| ChatGPT connector / deep-research compatible search and fetch (OpenAI MCP spec). |
All tools are read-only (readOnlyHint: true) and have no side effects.
Resources: faithfinder://overview, faithfinder://coverage, faithfinder://theology-and-styles
Prompts: find_a_church, church_search_advisor
Hosting a remote endpoint
HTTP mode turns on automatically when PORT is set (or with --http). It runs a stateless Streamable HTTP MCP endpoint plus a small REST API:
Path | Purpose |
| MCP endpoint (ChatGPT, Claude.ai, any remote MCP client) |
| REST search (used by Custom GPT Actions) |
| REST church details |
| REST quiz framework |
| OpenAPI 3.1 spec (server URL filled from |
| MCP discovery card |
| Health check |
# Local
PORT=8080 PUBLIC_BASE_URL=http://localhost:8080 npm start
# Google Cloud Run (from this folder; scales to zero)
gcloud run deploy faithfinder-mcp --source . --region us-central1 --allow-unauthenticated \
--set-env-vars PUBLIC_BASE_URL=https://<service-url>After deploying, add a remotes entry to server.json ({"type": "streamable-http", "url": "https://<host>/mcp"}) and republish to the MCP Registry.
Crawlable web pages for AI search engines (npm run build:web)
AI answer engines (ChatGPT Search, Perplexity, Google AI Overviews, Copilot) don't run JavaScript, so they can only cite pages that exist as real HTML. This command generates them from the same data:
npm run build:web # -> ./web-kitOutput | What it is |
| National, state and city directories (ItemList + FAQPage JSON-LD) |
| One page per church (schema.org |
| llms.txt summary and full index for LLMs |
| Welcomes GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot, Google-Extended and others; lists every page |
The FaithFinder web app copies web-kit/ into dist/ during its build (scripts/copy_web_kit.js). The MCP server's profile links point at these pages.
Links
Website: https://faithfinder.armornglory.com
Church directory: https://faithfinder.armornglory.com/us/
Soul Signature quiz: https://faithfinder.armornglory.com/quiz
MCP Registry name:
io.github.ArmorNGlory/faithfinder-mcp-server
Privacy & security
Queries are processed in memory; nothing is logged off-machine and no telemetry is sent.
All outbound links are HTTPS-upgraded and screened against risky TLDs and blocked domains.
Listings are for discovery. Service times and details can change, so please confirm with the church.
Changelog
2.1.1
Synced all 36 live curated metro/regional church guides (with state-aware city disambiguation),
/styles/*guides (liturgical,young-adults,church-plant),/map/,/service-times/, and canonical trailing-slash URLs across MCP tools, resources, andbuild:web.
2.1.0
Expanded directory from 9,060 to 22,693 US Christian churches across all 50 states + DC while reducing package download size via compact review summaries.
Improved natural-language city parsing (
"St. Paul Lutheran Church in Austin TX"no longer collides with St. Paul, MN), unified"New York City"/"New York"records, normalized regional city labels by ZIP code, and mappedModern↔Contemporaryin structured worship-style filters.Upgraded
@modelcontextprotocol/sdk(^1.32.1) andzod(^4.6.7), added automated unit tests, and added Dependabot configuration.
2.0.0
Breaking change: tools renamed for discoverability.
search_faith_finder_churches→find_churches,get_faith_finder_church_details→get_church_details,get_soul_signature_quiz→church_match_quiz. Addedlist_church_coverage,searchandfetch.All links now go to
faithfinder.armornglory.com. The oldfaithfinder.applinks pointed to an unrelated site.Natural-language search (city/state/ZIP extraction, nearby-ZIP fallback). Fixed state matching: "CA" no longer matches North Carolina, and "TX" now matches rows stored as "Texas".
Fixed HTTP mode, which failed after the first request. Now a stateless Streamable HTTP endpoint plus a REST API.
Added MCP Registry
server.json, tool annotations, server instructions, and thebuild:webcrawlable-pages generator.
License
MIT © ArmorNGlory
Available Tools
1 toolsearch_faith_finder_churchesA
Use this tool to find local churches, faith-based community events, and volunteer opportunities for users looking to connect with a faith community. Covers 70+ curated churches across major US cities including Dallas, Nashville, Atlanta, Houston, Orange County, and Washington DC. Returns church details plus a link to FaithFinder's free Soul Signature quiz for personalized matching.
Inputs: searchQuery.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no risk of confusion or overlap. The tool's purpose is clearly defined.
A single tool means no naming inconsistency. The name 'search_faith_finder_churches' follows a clear verb_noun pattern.
A single tool is borderline appropriate for a search-focused server. While it covers the core function, additional tools for filtering or details could enhance utility.
The tool covers search for churches and events, but lacks other operations (e.g., saving favorites, managing profiles). However, for a simple query service, it may be sufficient.
Maintenance
Related MCP Connectors
Find garage sales and publish seller-verified listings directly from AI assistants.
Discover and book businesses via AI agents.
Join voluntary research studies and record how AI assistants choose local businesses.
Find local businesses with real emails and run AI-written outreach to them, from your AI chat.
Related MCP Servers
- FlicenseAqualityCmaintenanceEnables AI assistants to retrieve Bible passages from multiple translations (ESV, NIV, KJV, NASB, NKJV, NLT, AMP, MSG). Supports querying single or multiple passages and provides both MCP protocol integration and REST API endpoints.113-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to look up Bible verses, search across translations, and compare different versions locally without API keys.1-
- AlicenseNot gradedqualityDmaintenanceProvides guided prayers, semantic search, and pastoral care tools (encouragement, condolence, advice) via a read-only database without authentication.MIT
- AlicenseNot gradedqualityCmaintenanceFaith tools for AI agents: cited public-domain (KJV) Scripture verification, ORA Bible Q&A, sermon search, a church directory, and consent-gated prayer requests and giving. Free read tools need no key.MIT