How do I install GospelChannel Church Finder?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does GospelChannel Church Finder need an API key?

No required environment variable is listed on this record.

What transport does GospelChannel Church Finder use?

GospelChannel Church Finder is reached over HTTP.

When was GospelChannel Church Finder last checked?

Last checked 2026-11-08. Find a Christian church by worship style, denomination, language, and location. Read-only.

GospelChannel Church Finder MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://gospelchannel.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.ac0ai-gospelchannel-church-finder https://gospelchannel.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.ac0ai-gospelchannel-church-finder": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://gospelchannel.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

GospelChannel — 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 string
- DATABASE_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_URL
NEXT_PUBLIC_MEDIA_BASE_URL
BETTER_AUTH_URL
BETTER_AUTH_SECRET
DATABASE_URL

Needed for specific integrations and production-like flows:

YOUTUBE_API_KEY
SPOTIFY_CLIENT_ID
SPOTIFY_CLIENT_SECRET
APIFY_TOKEN
ANTHROPIC_API_KEY
BREVO_API_KEY
CRON_SECRET

Admin access is database-backed. Promote an account to admin with:

pnpm db:seed -- [email protected]

Notes:

pnpm build uses 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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install GospelChannel Church Finder?

Does GospelChannel Church Finder need an API key?

What transport does GospelChannel Church Finder use?

When was GospelChannel Church Finder last checked?

Documentation

GospelChannel — The Church Guide

Status

What the app does

Stack

Local setup

Database (Neon)

Environment variables

Contributing

Security

Deployment

Project notes

License