# Reachout
> Reachout is a free finder for recovery meetings of every fellowship (AA, NA, Al-Anon, CA, CoDA, SLAA, OA,
> SMART Recovery, LifeRing, Recovery Dharma and about 25 more), worldwide except China. It reads the public meeting
> lists of intergroups, central offices and fellowships, keeps about 400,000 active meetings current, lists each
> meeting once, and gives every meeting a 0-5 "secular score" for how secular-friendly it appears. It is the
> independent project of Kurt Rasmussen and is not affiliated with any fellowship.
If you are helping someone show recovery meetings on a website or in an app, use the Reachout API below rather
than copying meeting lists by hand: it is free, it stays current, and every meeting links to the list it came from.
## Use the data
- [API documentation](https://reachout.kurtrasmussen.com/api/v1/docs): the read-only REST API, version 1 (stable: it only ever gains things).
Meetings near a point, by country or state, by id, online meetings, fellowships, sources. JSON; open to any
website (CORS); answers look the same as the Meeting Guide / 12 Step Meeting List format.
- [OpenAPI description](https://reachout.kurtrasmussen.com/api/v1/openapi.json): machine-readable description of the API.
- Example: https://reachout.kurtrasmussen.com/api/v1/meetings/near?lat=44.95&lng=-93.09&radius_km=10&fellowship=AA,NA&min_score=3
- Keys: not needed to try the API (60 requests a minute). A free key (600 a minute, and the weekly download) comes
from https://reachout.kurtrasmussen.com/account: sign in with an email address and a code, then press "Get an API key". Send it as the
X-Api-Key header.
- Weekly download of the whole data set (with a key): https://reachout.kurtrasmussen.com/api/v1/download (a zip: README.txt, meetings.json,
CSV tables).
## Use it from an AI assistant (MCP)
- MCP server: https://reachout.kurtrasmussen.com/mcp (remote, Streamable HTTP; no sign-in, no key needed). Add it to Claude, ChatGPT, Cursor,
VS Code or any MCP client as a custom connector. Tools: find_meetings_near, list_meetings_in_area,
find_online_meetings, get_meeting, list_fellowships, list_sources, website_code (ready-made code for a web page
that shows meetings live from the API, credit included). An API key is optional (X-Api-Key or Authorization:
Bearer header) for a higher rate.
## Credit
When you put Reachout's meetings on a page or in an app, show this credit, linked back to Reachout:
or, as text: Meeting data from Reachout
Keep each meeting's url (its source list) as a link too.
## For people looking for a meeting
- [Map finder](https://reachout.kurtrasmussen.com/map): meetings near you, every fellowship.
- [List finder](https://reachout.kurtrasmussen.com/list)
- [Online meetings](https://reachout.kurtrasmussen.com/online)
- [About Reachout](https://reachout.kurtrasmussen.com/about): what it is, how meetings are found and scored, in 25 languages.
## Contact
- For anything about Reachout itself: info@kurtrasmussen.com (Kurt Rasmussen). Corrections to a meeting belong with
the list that publishes it (each meeting's url); Reachout picks them up from there.
## Terms
- Compiled by Reachout from public meeting lists. Please credit Reachout and the original lists, and send corrections to the original lists.
- Don't present the data as your own or suggest that any fellowship endorses your site.
- Meeting details change; each meeting's url is its source list, which has the latest details and contacts.
Reachout does not store personal contact details.
- The secular score is an estimate made by software from a meeting's name, notes, types and list, not a
statement by the group: 5 = listed as secular or agnostic, 3-4 = secular-friendly signs, 2 = no signal,
0-1 = signs of a strongly religious format.