GospelChannel Church Finder
RemoteAbout GospelChannel Church Finder
GospelChannel Church Finder is a church discovery guide for people choosing where to attend. It supports comparisons by location, tradition, language, worship style, and service details, with music and video on church pages.
Key features
- 01Compare churches by location and tradition
- 02Filter by language and worship style
- 03Review service details
- 04Browse curated music and gospel
- 05View Spotify and YouTube embeds
Use cases
- 01Find churches before a first visit
- 02Compare local options by worship style
- 03Explore music linked to church profiles
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://gospelchannel.com/mcpclaude mcp add --transport http ac0ai-gospelchannel-church-finder https://gospelchannel.com/mcp{"mcpServers":{"ac0ai-gospelchannel-church-finder":{"type":"http","url":"https://gospelchannel.com/mcp"}}}Open in Cursor{"servers":{"ac0ai-gospelchannel-church-finder":{"type":"http","url":"https://gospelchannel.com/mcp"}}}Open in VS Code{"mcpServers":{"ac0ai-gospelchannel-church-finder":{"type":"http","url":"https://gospelchannel.com/mcp"}}}{"mcpServers":{"ac0ai-gospelchannel-church-finder":{"serverUrl":"https://gospelchannel.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | number | No | Maximum number of churches to return (default 5, max 20). |
| language | string | No | Preferred service language, e.g. English, Spanish. |
| radius_km | number | No | Search radius in kilometers (default 40, max 500). |
| denomination | string | No | Preferred denomination, e.g. non-denominational, Baptist, Pentecostal, Assemblies of God. |
| worship_style | string | No | Preferred worship style, e.g. contemporary, gospel, charismatic, traditional, hillsong. |
Details
From the project READMEGospelChannel — The Church Guide
Find the right church before your first visit.
Free global church guide with worship-aware profiles, built with Next.js 16, OpenNext on Cloudflare Workers, Neon, Spotify, and YouTube.
Solo-maintained project, and my first open source project. This repository is public so people can report bugs, suggest improvements, and send small focused pull requests. I am still learning the open source side of things, so patience and clarity help a lot.
Status
- Production site:
https://gospelchannel.com - Contributor language: English or Swedish is fine
- Project direction is maintainer-led
What the app does
- Find and compare churches by location, tradition, language, worship style, and service details
- Browse curated worship and gospel music connected to church profiles
- Explore church pages with Spotify embeds and YouTube video grids
- Submit church suggestions and ownership claims
- Run scheduled content refresh jobs
- Generate SEO assets such as
sitemap.xml,robots.txt, and structured data
Stack
- Next.js 16 (App Router)
- OpenNext + Cloudflare Workers
- Neon Postgres + Drizzle
- Better Auth
- Spotify Web API
- YouTube Data API
- Cloudflare R2 for media
- PostHog for analytics
Local setup
Prerequisites:
- Node 22.x
- npm
If you use nvm, run:
nvm use
Install and start:
pnpm install
cp .env.example .env.local
pnpm dev
Helpful commands:
pnpm lint
pnpm build
pnpm smoke
pnpm check:env
Database (Neon)
This project uses Neon serverless Postgres with Drizzle ORM.
- Create a free project at neon.tech
- Copy the connection strings into
.env.local:DATABASE_URL- pooled connection stringDATABASE_URL_UNPOOLED- direct connection (used by Drizzle migrations)
- Run migrations:
npx drizzle-kit push
Environment variables
You do not need every external integration to read the code or work on docs and UI.
Typical local development:
NEXT_PUBLIC_SITE_URLNEXT_PUBLIC_MEDIA_BASE_URLBETTER_AUTH_URLBETTER_AUTH_SECRETDATABASE_URL
Needed for specific integrations and production-like flows:
YOUTUBE_API_KEYSPOTIFY_CLIENT_IDSPOTIFY_CLIENT_SECRETAPIFY_TOKENANTHROPIC_API_KEYBREVO_API_KEYCRON_SECRET
Admin access is database-backed. Promote an account to admin with:
pnpm db:seed -- [email protected]
Notes:
pnpm builduses offline mode for the content pipeline.- Full admin, mail, sync, and deployment flows need real service credentials.
- Keep secrets in
.env.local. Do not commit them.
Contributing
Ideas, bug reports, and small PRs are welcome.
If you want to help, the easiest path is:
- open an issue
- keep the idea or fix small
- explain the problem in plain language
Best ways to help:
- Open an issue for bugs or feature ideas
- Send focused PRs that solve one problem at a time
- Include screenshots when changing UI
- Update docs if behavior changes
See CONTRIBUTING.md for the short version of how this repo is run.
Security
Please do not post security issues publicly. See SECURITY.md.
Deployment
The production app is deployed on Cloudflare Workers via OpenNext. Contributors usually do not need deployment access.
Maintainer deploy command:
pnpm deploy
Project notes
- Spotify can require Extended Quota Mode for some external playlist access.
- The app has manual data fallbacks in
src/data/manual/for cases where API data is limited or unavailable.
License
MIT. See LICENSE.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.