# Satsang > Satsang (tantrafiles.xyz) is an open, citable directory of the world's wisdom traditions: 178 traditions and schools, 727 teachers, scholars and historical figures with 1,122 documented lineage and influence links, 875 places to practise in 51 countries (contacts exactly as each place publishes them, 298 checked against the place's own site), 407 texts and books (115 free from their publishers), 85 practices with cautions, 68 topics compared across traditions and 9,986 talks from official uploads. Metadata only; videos play on YouTube; transcripts are never published. Data built 2026-10-24. Licence: Satsang's curation is CC BY 4.0 (credit "Satsang, tantrafiles.xyz"); code is MIT. Third-party records (places, texts, talks) are metadata pointing at their sources, under those sources' terms. Wikidata ids are CC0. ## Connect (no sign-in) - [MCP server, Streamable HTTP](https://mcp.tantrafiles.xyz/mcp): add as a custom connector in ChatGPT (Settings > Connectors, developer mode) or Claude (Settings > Connectors > Add custom connector). Legacy SSE transport: https://mcp.tantrafiles.xyz/sse - [OpenAPI 3.1 / REST](https://mcp.tantrafiles.xyz/openapi.json): the same tools as GET endpoints under https://mcp.tantrafiles.xyz/api/ (CORS open, rate-limited); import as a Custom GPT Action - [Server card](https://tantrafiles.xyz/.well-known/mcp.json) - [Data dump manifest](https://tantrafiles.xyz/data/index.json): JSON, JSONL and JSON-LD per kind with checksums; [JSON Schemas](https://tantrafiles.xyz/schema/) - [Docs for agents and developers](https://tantrafiles.xyz/agents) - [Full summary for LLMs](https://tantrafiles.xyz/llms-full.txt) ## 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). ## Canonical URLs (cite these) - https://tantrafiles.xyz/person/, /tradition/, /topic/, /practice/, /collection/, /place/, /resource/, /clip/ - Every API/MCP record carries `url` (canonical page), `source_url` (where the fact comes from), `verified_on` (YYYY-MM-DD) and `confidence` (high, medium, low). ## Places (plain HTML pages, crawlable, schema.org JSON-LD) - [All places](https://tantrafiles.xyz/places): every place grouped by country, with links by tradition and country - https://tantrafiles.xyz/place/: one place: name, tradition, school and lineage, address and map point (GeoCoordinates), website, contacts exactly as published (each with its source page and check date), languages when known, offerings, programmes, upcoming events (next 90 days, read weekly from the place's own iCal feed or schema.org Event data, with source and fetch date) and when it was last checked. JSON-LD: PlaceOfWorship or Place + Organization, PostalAddress, GeoCoordinates, Event. - https://tantrafiles.xyz/places/ (e.g. https://tantrafiles.xyz/places/thai-forest, https://tantrafiles.xyz/places/sufism) and https://tantrafiles.xyz/places/country/ (e.g. https://tantrafiles.xyz/places/country/gb) - Filters (MCP `search_places`): free-text query, tradition (includes its schools), school (exact), country, near {lat, lng, km}, residential, online, language, has_upcoming_events, has_email, limit. `get_place` returns contacts + events + sources; `list_events` lists upcoming events by place, tradition, country and date range. - [Places sitemap](https://tantrafiles.xyz/sitemap-places.xml) ## Open data (CC BY 4.0, credit "Satsang, tantrafiles.xyz") - [Places as JSON](https://tantrafiles.xyz/data/places.json) and [as NDJSON](https://tantrafiles.xyz/data/places.ndjson) (one place per line; same records the MCP serves) - [Upcoming events](https://tantrafiles.xyz/data/events.json): per place, with `source` (the feed or page read), `source_type` (ical | jsonld) and `fetched_at`; a place not re-read for 14 days is marked `stale` - [Slim place index](https://tantrafiles.xyz/data/wisegraph/places-index.json) and one full record per place at https://tantrafiles.xyz/data/wisegraph/place/.json - Contacts are the organisations' own published details: use them to help a person get in touch, never for bulk mail. ## Start here - [Topic flash](https://tantrafiles.xyz/): one question, teachers from different traditions - [Rebirth across traditions](https://tantrafiles.xyz/topic/rebirth) - [Places to practise](https://tantrafiles.xyz/places) ([map](https://tantrafiles.xyz/#places)) - [Journeys and practices](https://tantrafiles.xyz/#collections) ## Rules for agents - Cite the `url` of every record you use; give `source_url` for contacts, dates and programmes. - Contacts are only those a place publishes on its own site; programme dates change, so send people to `scheduleUrl` and say when the record was verified. - Events come from the place's own feed; give the event `url` or `source` and its `fetched_at`, and say "confirm on the source page". - Some teachers carry a dated, sourced public safety note (`safety`); mention it when recommending them or places tied to them, without adding to it. - Do not invent what a teacher said; quote talk titles. Satsang's one-line "takes" are its own summaries. - Practices are summaries: respect `contraindications` and `needsTeacher`, and link the `sources`. - "likely-living" is an inference (teaches on video, no death year recorded); say so when it matters.