Soul Yatri MCP

Astrology & wellbeing, inside Claude & ChatGPT

Accurate Vedic astrology (kundali, Gun Milan, panchang), numerology, tarot, and wellbeing support — with crisis-aware therapy/astrology booking — for Claude and ChatGPT.

MCP endpoint https://mcp.soulyatri.com/mcp · Streamable HTTP · OAuth 2.1

What it is

The Soul Yatri MCP server is a single connector that works as both a Claude Custom Connector and a ChatGPT App. It exposes 18 tools: a real Swiss-Ephemeris astrology engine (kundali, Gun Milan, panchang), numerology & tarot, crisis-aware wellbeing support, and the ability to book and pay for a real therapist or astrologer — without leaving the chat.

Why it's different

Computed, never guessed. Charts are calculated by the engine, not estimated by the language model.
Human-first. Distress surfaces verified helplines and a real human session — never a parasocial loop.
Private by design. Birth data & journals are KMS-encrypted and never shared with the AI model.

Quickstart · Claude

Connect in under a minute. Free compute tools work immediately; account & Pro tools prompt you to sign in — or create a free account right there.

Open Settings → Connectors in Claude (Desktop or Web).
Click “Add custom connector”.
Paste the endpoint: https://mcp.soulyatri.com/mcp
Sign in — or create a free Soul Yatri account in the same screen — and grant the scopes you want.
Ask: “Generate my kundali” or “What does my chart say about career?”

Quickstart · ChatGPT

Go to Settings → Apps & Connectors → Developer mode.
Create a new app and paste the endpoint: https://mcp.soulyatri.com/mcp
Complete OpenAI Platform identity verification.
Sign in — or create a free Soul Yatri account — when prompted.
Chat: “Daily horoscope for Leo” or “Book a therapy session”.

How it works

Architecture

The MCP server is a thin OAuth + adapter layer. Astrology compute (kundali, matching, panchang) is delegated to the Soul Yatri backend's Swiss-Ephemeris engine; numerology, tarot, namakshar, horoscope and compatibility are computed in-process. User-scoped tools run as the connected user against the backend with row-level, owner-scoped access.

The astrology engine

Charts use the Lahiri ayanamsha with a whole-sign house system, producing D1 + divisional charts (D2–D60), Vimshottari dashas and yogas. Results are framed as reflective guidance, not deterministic prediction.

Crisis-aware by design

Free-text inputs (tarot questions, wellbeing notes, reflections, support concerns) are scanned for distress in any language, including Hindi/Hinglish. When detected, the response leads with verified helplines and a proactive offer to book real human support — before anything else.

Tiers

Free anonymous

8 compute tools + crisis support work with no login. Rate-limited, but never paywalled.

OAuth connected

Account tools and booking/payment unlock once the user signs in and grants scopes.

Pro $6.99/mo

Depth: 50-page Cosmic Blueprint, unlimited ask-the-astrologer, saved charts & wellbeing sync.

Developer API credits

Metered REST at /v1 with API-key auth and credit packs — for B2B integrators.

Privacy & data

Encryption

Saved birth profiles and journal entries are KMS-encrypted at rest and row-level-security owner-scoped — a non-owned record returns 404, never another user's data.

What the model never sees

Sensitive material — Razorpay keys, backend access tokens, raw encrypted PII — is passed to checkout widgets or kept server-side and is never exposed to the language model.

OAuth security

Authorization uses OAuth 2.1 with PKCE (S256), dynamic client registration, and refresh tokens. You control which scopes to grant and can disconnect anytime.

OAuth 2.1

Anonymous compute needs no auth. The moment a tool needs your account (profiles, charts, booking, wellbeing write-back, blueprint), the connector runs a standard OAuth 2.1 authorization-code flow with PKCE.

PKCE — S256 code challenge (no client secret needed for public clients).
Dynamic Client Registration — https://mcp.soulyatri.com/oauth/register
Refresh tokens — granted with the offline_access scope so you stay connected without re-login.

Claude and ChatGPT discover all of this automatically from the metadata endpoints below — you only paste the MCP endpoint.

Scopes

Granular, least-privilege scopes. Grant only what you need; the consent screen lists each one.

Scope	Grants
`astro:read`	Compute charts, panchang, horoscope, numerology & tarot
`profile:read`	Read your saved birth profiles and charts
`wellbeing:write`	Save journal entries, moods & reflections, and book sessions
`blueprint:read`	Generate and read your Cosmic Blueprint report
`offline_access`	Stay connected (refresh access without re-login)

Discovery metadata

Standard well-known endpoints let clients auto-configure the OAuth flow:

Protected resource	`/.well-known/oauth-protected-resource`
Authorization server	`/.well-known/oauth-authorization-server`
Machine-readable manifest	`/manifest.json`

Free compute tools

Usable anonymously — no OAuth, rate-limited, never billed. (Credit figures show the cost on the metered Developer API.)

`generate_kundali`

FreeAPI · 20 credits

Accurate Vedic birth chart from birth details via the Swiss-Ephemeris engine — D1 + divisional charts (D2–D60), Vimshottari dashas, yogas, ascendant & planetary placements (Lahiri ayanamsha, whole-sign).

Parameter	Type		Description
`name`	string	optional	Person's name (report header only).
`dateOfBirth`	string	required	Date of birth, YYYY-MM-DD.
`timeOfBirth`	string	required	Local time of birth, 24h HH:mm.
`placeOfBirth`	string	required	Birth place — e.g. "Mumbai" or "Mumbai, India". Auto-geocoded to coordinates (same atlas the website uses). Required unless you pass geoLat/geoLng/timezone directly.
`geoLat / geoLng`	number	optional	Birth coordinates (override geocoding).
`timezone`	string	optional	IANA timezone, e.g. Asia/Kolkata.
`nodeKind`	"MEAN_NODE" \| "TRUE_NODE"	optional	Rahu/Ketu node model (default TRUE_NODE).
`chartStyle`	"north" \| "south"	optional	Diagram style for the chart widget (default north).

Try saying “Generate my kundali — born 15 Aug 1995, 2:30 PM in Mumbai.”

`kundli_matching`

FreeAPI · 25 credits

Vedic marriage compatibility (Ashtakoot Gun Milan): the 36-guna score across all 8 kootas plus Manglik (Mangal dosha) analysis, computed by the real engine.

Parameter	Type		Description
`groom`	object (birth details)	required	First partner's birth details.
`bride`	object (birth details)	required	Second partner's birth details.

Try saying “Match these two kundalis for marriage.”

`daily_panchang`

FreeAPI · 5 credits

The five limbs (tithi, nakshatra, yoga, karana, vara) plus sunrise/sunset and muhurta windows (Rahu Kaal, Yamaganda, Gulika, Abhijit) for a date and place.

Parameter	Type		Description
`city`	string	optional	City/place name (geocoded).
`geoLat / geoLng`	number	optional	Coordinates (override geocoding).
`timezone`	string	optional	IANA timezone.
`date`	string	optional	YYYY-MM-DD (default today).

Try saying “What’s today’s panchang in Delhi? Any good muhurta?”

`daily_horoscope`

FreeAPI · 2 credits

A reflective daily horoscope for a zodiac (sun or moon) sign across overall, love, career and wellbeing, with a lucky colour & number.

Parameter	Type		Description
`sign`	string	required	Zodiac sign, e.g. "leo" or your moon sign.
`date`	string	optional	YYYY-MM-DD (default today).

Try saying “Daily horoscope for Leo.”

`numerology`

FreeAPI · 3 credits

Pythagorean numerology from a name and date of birth: Life Path, Expression/Destiny, Soul Urge, Personality and Birthday numbers (master numbers preserved) with reflective meanings.

Parameter	Type		Description
`name`	string	required	Full name as commonly written.
`dob`	string	required	Date of birth YYYY-MM-DD.

Try saying “What’s my numerology for Asha Rao, born 1992-03-11?”

`tarot_reading`

FreeAPI · 3 credits

Draw a tarot reading (single card, three-card past/present/future, or Celtic cross) from a full 78-card deck with upright/reversed meanings. A reflective mirror, not a prediction.

Parameter	Type		Description
`question`	string	optional	What is on your mind (optional).
`spread`	"single" \| "three-card" \| "celtic-cross"	optional	Spread (default three-card).

Try saying “Pull a three-card tarot spread about my career.”

`namakshar`

FreeAPI · 2 credits

Map a name's opening sound to its Vedic nakshatra/pada, with the associated Moon sign (rashi), ruling planet, and auspicious naming syllables (akshar).

Parameter	Type		Description
`name`	string	required	Name to analyse.

Try saying “What nakshatra syllable does the name Aarav belong to?”

`compatibility`

FreeAPI · 3 credits

A fast element/modality compatibility check between two zodiac signs. For a full Vedic 36-guna match, use kundli_matching.

Parameter	Type		Description
`signA`	string	required	First person's sign.
`signB`	string	required	Second person's sign.

Try saying “How compatible are Leo and Aquarius?”

Care & booking

The emotional-support → book → pay flow. find_support_options is anonymous-friendly; booking & payment require the wellbeing:write scope.

`find_support_options`

Free

Called whenever distress is expressed (any language). Returns region-appropriate crisis helplines plus bookable Soul Yatri options: instant "Talk Now" therapy, recommended therapists, and an auto-matched astrology consultation. Safe to call anonymously.

Parameter	Type		Description
`concern`	string	optional	What the user said / how they feel (used to gauge urgency).
`type`	"therapy" \| "astrology" \| "either"	optional	Preferred kind of support (default either).

Try saying “I’ve been feeling really low lately and can’t sleep.”

`book_support_call`

OAuthwellbeing:write

Book a real session for the connected user: a scheduled therapy session (therapistId + time), an instant "Talk Now" therapy session, or an auto-matched astrology consultation. Returns the booking id; follow up with pay_for_booking if there is a fee.

Parameter	Type		Description
`type`	"therapy" \| "astrology"	required	Kind of session to book.
`instant`	boolean	optional	Therapy only: request an immediate "Talk Now" session.
`therapistId`	string	optional	Scheduled therapy: the chosen therapist.
`scheduledAt`	string (ISO 8601)	optional	Time for a scheduled therapy/astrology session.
`sessionType`	"discovery" \| "standard" \| "pay_as_you_like"	optional	Therapy session type (default standard).
`concern`	string	optional	Optional note about what prompted the booking.

Try saying “Book me an instant therapy session now.”

`pay_for_booking`

OAuthwellbeing:write

Create a secure Razorpay order + checkout link for a booked session, payable without leaving the chat. Returns the amount and a payment link. Razorpay key/order go to the checkout widget, never to the model.

Parameter	Type		Description
`sessionId`	string	required	The booked session id from book_support_call.
`description`	string	optional	Optional payment description.

Try saying “Pay for my session.”

Your account

Read your saved Soul Yatri data. Requires the profile:read scope.

`list_my_profiles`

OAuthprofile:read

List the connected user's saved birth profiles (names + ids) so they can pick one for a chart or Cosmic Blueprint.

No input parameters.

Try saying “List my saved birth profiles.”

`get_my_chart`

OAuthprofile:read

Fetch the connected user's personalised astrology dashboard — their computed natal chart, key placements, current dasha and highlights.

No input parameters.

Try saying “Show me my astrology dashboard.”

Pro depth

Premium tools that require an active Soul Yatri Pro entitlement. Write-back tools always honour crisis support first — even for unentitled users.

`save_birth_profile`

Proprofile:read

Save a birth profile to the user's Soul Yatri account. PII is KMS-encrypted at rest and RLS owner-scoped (non-owned data → 404).

Parameter	Type		Description
`name`	string	required	Profile name.
`dateOfBirth`	string	required	Date of birth, YYYY-MM-DD.
`timeOfBirth`	string	required	Local time of birth, 24h HH:mm.
`placeOfBirth`	string	required	Birth place — e.g. "Mumbai" or "Mumbai, India". Auto-geocoded to coordinates (same atlas the website uses). Required unless you pass geoLat/geoLng/timezone directly.
`geoLat / geoLng`	number	optional	Birth coordinates (override geocoding).
`timezone`	string	optional	IANA timezone, e.g. Asia/Kolkata.
`nodeKind`	"MEAN_NODE" \| "TRUE_NODE"	optional	Rahu/Ketu node model (default TRUE_NODE).

Try saying “Save a birth profile for my partner.”

`cosmic_blueprint`

Problueprint:readAPI · 500 credits

Generate the hyper-personalised 50-page Cosmic Blueprint for a saved birth profile. Kicks off generation and returns status; when ready it returns a secure, short-lived download link.

Parameter	Type		Description
`profileId`	string	required	A saved birth profile id (from list_my_profiles).
`locale`	string	optional	Report locale (default EN).

Try saying “Generate my Cosmic Blueprint.”

`ask_astrologer`

Proastro:read

Ask a personal astrology question, grounded in your saved chart when a profileId is given and framed reflectively (not as fixed prediction). Can hand off to a real astrologer consultation.

Parameter	Type		Description
`question`	string	required	Your question (max 500 chars).
`profileId`	string	optional	Optional saved profile to ground the answer.

Try saying “Ask the astrologer what my chart says about a career change.”

`log_wellbeing`

Prowellbeing:write

Save a mood / wellbeing entry back to the user's Soul Yatri journal. If the note shows distress, the reply always includes crisis support and an offer to book a call — even before any upsell.

Parameter	Type		Description
`mood`	number (1–10) \| string	optional	Mood score or a word, e.g. "anxious", "good".
`note`	string	optional	A short reflection on how you feel (max 2000 chars).
`tags`	string[]	optional	Optional tags (max 10).

Try saying “Log my mood as anxious — work has been overwhelming.”

`save_reflection`

Prowellbeing:write

Save a longer reflection to the user's Soul Yatri journey / constellation. Crisis-aware: distressing text surfaces support + a booking offer first.

Parameter	Type		Description
`text`	string	required	The reflection to save (max 5000 chars).
`category`	string	optional	Optional category.

Try saying “Save this reflection to my journey.”

Emotional safety

Distress in any language (incl. Hindi/Hinglish) triggers crisis helplines and a proactive offer to book human support. Not a medical/diagnostic service.

When distress is detected, the connector will:

Respond with warmth and without judgement.
Surface verified crisis helplines for your region (India, US, International).
Proactively offer to book a real therapy or astrology session.
Never diagnose, never minimise, and never withhold support behind a paywall.

Not a substitute for emergency or professional care. If you are in immediate danger, please call your local emergency services.

Pricing

Soul Yatri Free $0

Accurate kundali, matching, panchang, horoscope, numerology, tarot & more — free, in chat.

Soul Yatri Pro $6.99 · ₹499/mo

The 50-page Cosmic Blueprint, unlimited ask-the-astrologer, saved charts, and wellbeing sync.

Manage your plan at soulyatri.com/pricing.

Developer API

Build Soul Yatri astrology into your own product. A metered REST API at https://mcp.soulyatri.com/v1 exposes the same compute as the MCP tools.

Get an API key → create one (with 1,000 free credits) in the Developer Console. Buy credit packs there too — balances are persistent and never expire.

Authentication

Authenticate every request with your API key, via either header:

Authorization: Bearer sk_live_your_key
X-API-Key: sk_live_your_key

Example request

curl -X POST https://mcp.soulyatri.com/v1/kundali \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"dateOfBirth":"1995-08-15","timeOfBirth":"14:30","placeOfBirth":"Mumbai, India"}'

Credits & packs

Each billable call deducts credits from your pack and returns the balance in the X-Credits-Remaining header. Costs scale with compute weight (a full kundali costs more than a horoscope).

Pack	Price	Credits
Free	Free	1,000 credits	Expires
Starter	$12 · ₹999	25,000 credits	Never expires
Growth	$49 · ₹3999	150,000 credits	Never expires
Scale	Custom	Custom volume	Never expires

Per-tool cost ranges from 2 (horoscope/namakshar) to 25 (Gun Milan), and 500 for a Cosmic Blueprint. Default for any unlisted tool is 5.

Endpoints

Method	Path	Cost	Auth	Description
GET	`/v1/meta`	free	—	Credit packs + per-tool costs. No key required.
GET	`/v1/credits`	free	🔑	Remaining credits for your key.
POST	`/v1/kundali`	20	🔑	Full Vedic birth chart.
POST	`/v1/kundli-matching`	25	🔑	36-guna Gun Milan for two charts.
GET	`/v1/panchang`	5	🔑	Five-limb panchang for a date/place.
GET	`/v1/horoscope`	2	🔑	Daily horoscope by sign.
POST	`/v1/numerology`	3	🔑	Pythagorean core numbers.
POST	`/v1/tarot`	3	🔑	78-card tarot draw.
GET	`/v1/namakshar`	2	🔑	Name → nakshatra syllable.
GET	`/v1/compatibility`	3	🔑	Quick sign compatibility.

🔑 = API key required. GET /v1/meta is public and returns live packs + per-tool costs.

Errors & headers

Status codes

`401`	`invalid_api_key` — missing or unknown API key.
`402`	`insufficient_credits` — call cost exceeds your remaining balance; top up to continue.
`4xx / 5xx`	Upstream engine errors are surfaced with a code and message.

Response headers

`X-Credits-Remaining`	Your balance after this call.
`X-Credits-Cost`	Credits this call consumed.

Rate limits

Free anonymous tools are rate-limited per subject (the connected user, or a hashed IP for anonymous callers) to keep the free tier sustainable. Connected and Pro users get higher ceilings. The Developer API is bounded by your credit balance rather than a hard request cap.

Support

Questions, partnership, or API access? Email support@soulyatri.com or visit soulyatri.com.

Legal: Privacy Policy · Terms of Service.

Changelog

v0.1.0 Initial release — 18 MCP tools, OAuth 2.1 (PKCE + DCR), crisis-aware care flow, and the metered Developer API.