---
title: "For developers and AI agents"
description: "Read the directory as markdown, through a free JSON API, or through an MCP server. No key needed."
url: https://housechurchesnearme.com/developers/
site: House Churches Near Me
---

# 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](https://housechurchesnearme.com/llms.txt) and the full guide text is at [/llms-full.txt](https://housechurchesnearme.com/llms-full.txt).

## JSON API

Base address: `https://housechurchesnearme.com/api/v1`. The full description is an [OpenAPI 3.1 document](https://housechurchesnearme.com/api/v1/openapi.json).

- `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](https://housechurchesnearme.com/.well-known/mcp/server-card.json) 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](https://housechurchesnearme.com/.well-known/api-catalog) (RFC 9727)
- [A2A agent card](https://housechurchesnearme.com/.well-known/agent-card.json), with a JSON-RPC endpoint at `/a2a`
- [Agent skills index](https://housechurchesnearme.com/.well-known/agent-skills/index.json)
- [AI catalog](https://housechurchesnearme.com/.well-known/ai-catalog.json)
- [auth.md](https://housechurchesnearme.com/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](https://housechurchesnearme.com/contact/).