For developers and AI agents

Read the directory as markdown, through a free JSON API, or through an MCP server. No key needed.

Last updated November 15, 2026

Everything public on this site can be read by software: as markdown, through a JSON API, and through an MCP server for AI assistants. It is free, read-only, and needs no key. Host emails, phone numbers, and home addresses are not in any of it.

Markdown for any page

Add index.md to a page address, or send the header Accept: text/markdown, to get a clean markdown copy of that page. A site summary is at /llms.txt and the full guide text is at /llms-full.txt.

JSON API

Base address: https://housechurchesnearme.com/api/v1. The full description is an OpenAPI 3.1 document.

GET /api/v1/groups?near=45402&radius=50 finds groups within 50 miles of a ZIP code, nearest first. near also accepts Raleigh, NC, a state name, lat,lng, or online.
GET /api/v1/groups?state=OH&city=Dayton&type=house_church filters by state, city, and type.
GET /api/v1/groups/{slug} returns one group.
GET /api/v1/states and GET /api/v1/cities?state=OH return counts.

MCP server

Streamable HTTP endpoint: https://housechurchesnearme.com/mcp. No sign-in. Tools: search_house_churches, get_group, list_states, list_cities, and request_visit. The server card lists each tool and its inputs.

request_visit is the only tool that does anything beyond reading. It emails a confirmation link to the person asking. Nothing reaches a host until that person confirms from their own inbox, and the tool is limited to a few requests a day.

Other discovery files

API catalog (RFC 9727)
A2A agent card, with a JSON-RPC endpoint at /a2a
Agent skills index
AI catalog
auth.md: no authentication is required

Reading the data

Coordinates are approximate areas, moved one to two kilometers, and are never a meeting address. Most entries come from public sources and are unconfirmed until a host claims them, which the host_confirmed field shows. Please cache responses for a few minutes, link back to the group page, and tell people to confirm details with the host before they visit. Questions: contact Buddy.