For agents and developers
Satsang is an open, citable directory of the wisdom traditions. Ask ChatGPT, Claude or your own agent about traditions, teachers, lineages, retreats and free texts, and get answers that link back to a page here and to the original source.
Connector URL
https://mcp.tantrafiles.xyz/mcp
No sign-in. Read-only. Streamable HTTP (MCP 2025-06-18, 2025-03-26, 2024-11-05); legacy SSE at https://mcp.tantrafiles.xyz/sse.
Add it to ChatGPT
- Settings → Apps & Connectors → Advanced → turn on Developer mode (Plus, Pro, Business, Enterprise or Edu).
- Connectors → Create: name Satsang, URL
https://mcp.tantrafiles.xyz/mcp, Authentication No authentication. - In a chat, open the tools menu, enable Satsang, and ask e.g. “Find residential Theravada retreats in the UK with contact pages”. Deep research can use its
searchandfetchtools.
Custom GPT instead: Configure → Actions → Import from URL https://mcp.tantrafiles.xyz/openapi.json, authentication None.
Add it to Claude
- Claude.ai or Claude Desktop: Settings → Connectors → Add custom connector → URL
https://mcp.tantrafiles.xyz/mcp. - Claude Code:
claude mcp add --transport http satsang https://mcp.tantrafiles.xyz/mcp - Other clients (Cursor, VS Code, MCP Inspector): server type HTTP/streamable, same URL.
Tools
search | Search the Satsang directory: teachers, scholars and figures, traditions and schools, topics, practices, texts and books, collections, places to practise and talks. |
get_topic | A topic seen across traditions: intro, sub-questions, one-line takes per tradition, the best talks chosen for diversity across traditions (MMR), practices, texts, teachers and related topics. |
get_teacher | A person profile: bio, years, traditions, works, their best talks, talks about them, lineage neighbours and places tied to them. |
get_lineage | Walk teacher-student (dharma) and/or academic lineage edges up and down from a person or tradition. |
list_practices | Practices (meditation, visualisation, enquiry, chant, ritual, movement) with steps in plain words, sources and cautions. |
get_collection | A curated set, journey, meditation series, visualisation cycle or syllabus with its ordered units and items. |
list_courses | Series (called mini-courses before 2026-10-25): short editorial series of sessions inside a topic: gold talks in a teaching order, practices (with cautions; orientation-only ones say so), free readings, an optional complete Dharma Seed retreat to go deeper, and places. |
get_course | One series (mini-course) session by session: each session with its one-line purpose and items resolved (talk with YouTube link, length and why it is worth it; practice with steps or the orientation-only note and its cautions; reading with its free link), the complete retreat to go deeper (linked whole, credited) and places. |
list_series | Series (called mini-courses before 2026-10-25): short editorial series of sessions inside a topic: gold talks in a teaching order, practices (with cautions; orientation-only ones say so), free readings, an optional complete Dharma Seed retreat to go deeper, and places. |
get_series | One series (mini-course) session by session: each session with its one-line purpose and items resolved (talk with YouTube link, length and why it is worth it; practice with steps or the orientation-only note and its cautions; reading with its free link), the complete retreat to go deeper (linked whole, credited) and places. |
recommend | Stateless recommendations. |
fetch | Fetch one Satsang record by the id returned from search (e.g. |
find_places | Monasteries, retreat centres, ashrams, temples, study centres and sacred sites. |
get_place | One place with contacts exactly as the place publishes them (each with its source page and check date), programmes with an as-of date and schedule links, founders/tied teachers, sister monasteries, events, free resources, coordinates, website, source_url, verified_on, confidence and the canonical tantrafiles.xyz URL. |
search_places | The full place search: free-text query plus tradition (includes its schools), school (exact), country, near {lat, lng, km} (results carry distance_km, nearest first), residential (can stay: residential programmes, retreats or a monastery/ashram), online (online or hybrid programmes or events), language (code or name, e.g. |
list_events | Dated upcoming events (next 90 days) read weekly from each place’s own public iCal feed or schema.org Event markup (no aggregator, no LLM). |
find_teachers | People in Satsang filtered by tradition (includes schools), school (exact), living (true = living or likely living; status and its basis are returned), country/region (via places they founded or are tied to), role (teacher, scholar, figure) and on_video. |
get_resources | Texts, books and libraries per tradition, person or topic. |
get_lineage_path | Shortest documented chain between two people (or traditions) over teacher-student, ordination, transmission, academic supervision and influence edges. |
what_to_study | A study path for one tradition or school: orientation, then free online resources (texts, practices with cautions, journeys, best talks), then teachers (living first), then places to go (active, residential first, with verified contacts first). |
guide_me | Walk the golden path for a tradition or a teacher: living teachers, each one’s methods (practices with cautions and needsTeacher; never initiated detail), the syllabuses that contain them, and the places tied to them with contacts exactly as published. |
find_retreats | Retreats and courses by country, tradition, length or format: the recurring programmes places publish (name, typical length, format, cost model, recurrence) with the official schedule link and the date Satsang last confirmed it. |
get_schedule | One place’s schedule: its recurring programmes, its yearly events (usual month), and the official schedule page, which is canonical for dates (always cite it). |
plan_retreat | Plan a personal (home) retreat from an intent: topic, days, strictness (gentle | standard | strict), optional tradition or teacher. |
compose_booking | Draft a booking or enquiry email to a place for a programme and dates, using only the contacts and booking route the place publishes. |
site_health | Satsang’s own health from its keeper (GitHub Actions checks): uptime over 30 days per probe (site, API, MCP, sitemap, llms.txt, openapi), what is down now, open maintenance findings by severity and check, dead clips/links, and the re-verify queue size. |
list_findings | Open keeper findings (broken links, dead YouTube embeds, sitemap/JSON-LD problems, stale or unsourced records, data conflicts, leak guards), highest priority first. |
next_maintenance_task | The highest-priority unclaimed keeper finding with how to fix it and how to claim it (keeper/claims.json in a PR to github.com/prx0r/satsang). |
REST and data
- OpenAPI 3.1: https://mcp.tantrafiles.xyz/openapi.json · e.g. /api/places?tradition=theravada&country=GB&offers=residential, /api/study/thai-forest, /api/lineage/path
- Bulk data: /data/index.json (JSON, JSONL, JSON-LD per kind, with checksums) and JSON Schemas
- Summaries for language models: /llms.txt, /llms-full.txt; server card: /.well-known/mcp.json
What is in it
178 traditions and schools · 727 people · 1,122 lineage links · 875 places in 51 countries · 407 texts and books (115 free) · 85 practices · 68 topics · 9,986 talks. Built 2026-10-24.
Every answer carries url (the page to cite), source_url, verified_on and confidence. Contacts are shown only as each place publishes them; please do not use them for bulk mail. Programme dates change: follow the place’s schedule link.
Licence
Satsang’s curation (topic intros, takes, practice summaries, tags, lineage edges, collections) is CC BY 4.0: credit “Satsang, tantrafiles.xyz”. Third-party records are metadata pointing at their sources, under those sources’ terms. Code is MIT. Transcripts are never published.