@vedika-io/mcp-server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@vedika-io/mcp-server Get my Vedic birth chart for March 14, 1990, 7:45 AM in Mumbai"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@vedika-io/mcp-server
MCP server for the Vedika Intelligence API — astrology, divination and Vastu capabilities across Vedic, Western, KP, Chinese, Tarot, I Ching, Human Design, Numerology, and Ayurvedic domains, exposed as semantic tools for AI agents.
The server calls the documented Vedika API operations. Calculation and interpretation coverage varies by tool and account plan.
Discovery metadata
The server.json descriptor identifies this package as io.github.vedika-io/vedika-mcp-server and uses standard input/output transport. It declares VEDIKA_API_KEY as a required secret environment variable. Supply your key in your MCP client's private environment settings; the descriptor contains no key value.
Related MCP server: domain-expertise-mcp
Quick Start
npm install -g @vedika-io/mcp-serverGet your API key at vedika.io/pricing (starts at $12/mo). No free tier — every query costs money.
Configuration
Where the key goes matters more than which client you use.
Put it in the gitignored local settings file for your client, never the shared one. A key in a committed config is a key you have published.
Pin the version. The examples below pin
@2.0.9.npx -y @vedika-io/mcp-serverwith no version resolves whatever npm currently tagslateston every start, so a bad or hijacked release runs the moment it is published, with nothing recording which version you were on.Versions before 2.0.4 send your key to whatever
VEDIKA_BASE_URLnames and follow a redirect while carrying it. Do not pin below 2.0.4.The key is a payment credential: every query costs money. Treat it like a card number, not like a setting.
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"vedika": {
"command": "npx",
"args": ["-y", "@vedika-io/mcp-server@2.0.9"],
"env": {
"VEDIKA_API_KEY": "vk_live_your_key_here"
}
}
}
}Claude Code
Add to .claude/settings.local.json:
Not
.claude/settings.json. That file is the shared, checked-in one — a key put there is committed, pushed, and in your history for good.settings.local.jsonis gitignored and stays on your machine. This README saidsettings.jsonuntil 2026-09-07, and the published 2.0.3 package still does.
{
"mcpServers": {
"vedika": {
"command": "npx",
"args": ["-y", "@vedika-io/mcp-server@2.0.9"],
"env": {
"VEDIKA_API_KEY": "vk_live_your_key_here"
}
}
}
}Cursor
Add to Cursor Settings > MCP Servers:
{
"vedika": {
"command": "npx",
"args": ["-y", "@vedika-io/mcp-server@2.0.9"],
"env": {
"VEDIKA_API_KEY": "vk_live_your_key_here"
}
}
}Windsurf
Add to ~/.windsurf/mcp_config.json:
{
"mcpServers": {
"vedika": {
"command": "npx",
"args": ["-y", "@vedika-io/mcp-server@2.0.9"],
"env": {
"VEDIKA_API_KEY": "vk_live_your_key_here"
}
}
}
}Environment Variables
Variable | Required | Default | Description |
| Yes | — | Your API key (format: |
| No |
| Only |
Tools
Core
Tool | Description | Cost |
| Natural-language questions with Vedic, Western or KP selection and follow-up conversations. Operation and language availability depend on the route and account plan. | |
| List, get, delete, or extend multi-turn conversations. | Free |
Vedic Computation
Tool | Types | Cost |
| kundli, birth-chart, planetary-positions, house-cusps, ascendant, birth-details | $0.016-0.028 |
| vimshottari, mahadasha, antardasha, pratyantardasha, yogini | $0.016-0.028 |
| mangal, kaal-sarp, pitru, nadi, all, sade-sati, sade-sati-advanced | $0.016-0.040 |
| guna-milan, kundali, nakshatra-porutham, thirumana-porutham | $0.040-0.048 |
| full, tithi, nakshatra, yoga, karana | $0.012 |
| choghadiya, hora, rahu-kaal, gulika-kaal, yamaghanta, abhijit, brahma, durmuhurta, combined, auspicious | $0.012-0.020 |
| D2-D60 (15 charts: Hora, Drekkana, Chaturthamsa, Saptamsa, Navamsa, Dashamsa, Dwadashamsa, Shodasamsa, Vimsamsa, Chaturvimsamsa, Bhamsa, Trimsamsa, Khavedamsa, Akshavedamsa, Shashtiamsa) | $0.005 |
| daily, weekly, monthly, quarterly, yearly | $0.020-0.088 |
| planet (Bhinnashtakavarga), sarva (Sarvashtakavarga) | $0.025 |
Western Astrology
Tool | Types | Cost |
| chart, positions, aspects | $0.064 |
| chart, positions, aspects | $0.092 |
| chart, positions, aspects | $0.120 |
| synastry, synastry-aspects, composite, composite-aspects | $0.148 |
Cross-System (3 tools)
Tool | Types | Cost |
| Vedic daily/weekly/monthly; Western daily or advanced daily | Verify current API pricing |
| life-path, destiny, personality, soul-urge, personal-year, complete, compatibility | $0.003-0.010 |
| Vedic annual solar return (Tajaka system) | $0.006 |
Supplementary
Tool | Types | Cost |
| chandra-bala, tara-bala, upagraha, planet-relationship, shadbala | $0.020 |
| ritu, solstice, anandadi-yoga, auspicious-yoga, auspicious-period, inauspicious-period, gowri-nalla-neram, disha-shool, planet-transit, chandrashtama, chandrashtama-periods | $0.016-0.020 |
Tarot & Divination
Tool | Description | Cost |
| Draw tarot cards in single, three-card, celtic-cross, horseshoe, relationship, or career spreads. Rider-Waite, Thoth, or Marseille decks. | $0.020-0.048 |
| Card of the day with meanings, keywords, and daily guidance. Cached per day. | $0.008 |
| Cast an I Ching hexagram (yarrow or coin method). Primary hexagram + changing lines + transformed hexagram. | $0.012 |
Chinese Astrology
Tool | Description | Cost |
| Chinese zodiac animal, element, yin/yang, lucky numbers/colors, compatible/incompatible animals. Accounts for Chinese New Year dates. | $0.003 |
| Basic Ba Zi chart from a timezone-free datetime: Year/Month/Day/Hour pillars, Day Master, dominant element, and Five Element balance. Timezone-bearing input is held while accepted civil, zoned, or solar-time semantics remain unresolved. | Verify current API pricing |
Alternative Systems
Tool | Description | Cost |
| Human Design BodyGraph: Type, Strategy, Authority, Profile, defined/undefined Centers, Channels, Gates. | $0.040 |
| Crystal and gemstone recommendations by zodiac sign, planet, or need. Vedic ratna-shastra + modern crystal healing. | $0.012 |
Vedic Extended
Tool | Description | Cost |
| Kundali matching: 36-point Ashtakoota, Dashakoot summary, dosha cancellations and overall verdict. | Verify current API pricing |
| Ashtottari 108-year dasha cycle (alternative to Vimshottari). 8 planets, Mahadasha/Antardasha/Pratyantardasha depth. | $0.020 |
| Lal Kitab remedies for afflicted planets. Unique totkas (practical remedies) distinct from classical BPHS. Optional debt (rina) analysis. | $0.020 |
| Personalized mantra recommendations from classical texts. Sanskrit + IAST transliteration, japa count, muhurta, mala material. | $0.016 |
Spiritual & Wellness
Tool | Description | Cost |
| Ishta Devata (personal deity) from Atmakaraka in Navamsa. Also Dharma, Palana, and Guru Devata. Per BPHS Ch.33. | $0.020 |
| Ayurvedic Prakriti (constitution) analysis from birth chart. Vata/Pitta/Kapha balance, diet, herbs, seasonal recommendations. | $0.024 |
Bundles
Tool | Description | Cost |
| The day's general content in one call: tarot card, angel number, crystal, mantra, moon phase, rune and I Ching. Not a per-sign horoscope. | Verify current API pricing |
| Full numerology report: Life Path, Destiny, Soul Urge, Personality, Maturity, Pinnacles, Challenges, Karmic Debt/Lessons. Pythagorean or Chaldean. | $0.010 |
Utility
Tool | Description | Cost |
| Check wallet balance, usage history, summary, model breakdown | Free |
Vastu
Tool | Description |
| Static Vastu reference tables (mandala grids, directions, defects, remedies, colours, materials, gate obstructions) |
| Audit a room list against the compass zones it occupies |
| Placement guidance for one room type in one zone |
| Project a Vastu Purusha Mandala grid onto a plot polygon |
| Generate a Vastu-compliant plan from a plot and room programme |
| Coarse magnetic-declination reference estimate |
| Call any other Vastu operation by path suffix. |
| Bulk Vastu jobs and artifacts (see below) |
Input Patterns
Birth Details (required by most Vedic/Western tools)
{
"datetime": "1990-06-15T14:30:00",
"latitude": 28.6139,
"longitude": 77.2090,
"timezone": "+05:30",
"ayanamsa": "lahiri"
}Field | Type | Required | Notes |
| string | Yes | ISO 8601 format. Time is required for accurate house/ascendant. |
| number | Yes | -90 to 90. Polar latitudes >66.5 are rejected (unreliable houses). |
| number | Yes | -180 to 180. |
| string | Yes | UTC offset preferred ( |
| string | No | Default: |
Vedic Compatibility (male/female)
{
"type": "guna-milan",
"male": { "datetime": "1992-03-15T10:30:00", "latitude": 28.61, "longitude": 77.20, "timezone": "+05:30" },
"female": { "datetime": "1994-07-22T08:15:00", "latitude": 19.07, "longitude": 72.87, "timezone": "+05:30" }
}Western Relationship (person1/person2 -- gender-neutral)
{
"type": "synastry",
"person1": { "datetime": "1990-01-15T14:30:00", "latitude": 40.71, "longitude": -74.00, "timezone": "-05:00" },
"person2": { "datetime": "1992-08-22T09:45:00", "latitude": 34.05, "longitude": -118.24, "timezone": "-08:00" }
}Location-Only (panchang, muhurta)
{
"type": "choghadiya",
"latitude": 28.6139,
"longitude": 77.2090,
"timezone": "+05:30"
}All location fields are optional -- defaults to Delhi (28.6139, 77.2090, +05:30).
Zodiac Signs (predictions, horoscope)
Accepts both English and Hindi (Roman transliteration):
English | Hindi |
aries | mesha |
taurus | vrishabha |
gemini | mithuna |
cancer | karka |
leo | simha |
virgo | kanya |
libra | tula |
scorpio | vrishchika |
sagittarius | dhanu |
capricorn | makara |
aquarius | kumbha |
pisces | meena |
Tarot Spreads
{
"spread": "celtic-cross",
"question": "What should I focus on this month?",
"deck": "rider-waite"
}Chinese Ba Zi
{
"datetime": "1990-06-15T14:30:00"
}Matrimony Match (bride/groom)
{
"bride": { "datetime": "1994-07-22T08:15:00", "latitude": 19.07, "longitude": 72.87, "timezone": "+05:30", "gender": "female" },
"groom": { "datetime": "1992-03-15T10:30:00", "latitude": 28.61, "longitude": 77.20, "timezone": "+05:30", "gender": "male" }
}Output Examples
vedika_birth_chart (type: "kundli")
{
"ascendant": { "sign": "Virgo", "degree": 14.23, "nakshatra": "Hasta", "pada": 2 },
"planets": [
{ "name": "Sun", "sign": "Taurus", "house": 9, "degree": 0.85, "nakshatra": "Krittika", "pada": 4, "retrograde": false, "dignity": "Neutral" },
{ "name": "Moon", "sign": "Cancer", "house": 11, "degree": 22.14, "nakshatra": "Ashlesha", "pada": 3, "retrograde": false, "dignity": "Own" },
{ "name": "Mars", "sign": "Pisces", "house": 7, "degree": 6.52, "nakshatra": "Uttara Bhadrapada", "pada": 2, "retrograde": false, "dignity": "Neutral" }
],
"houses": [
{ "house": 1, "sign": "Virgo", "degree": 14.23, "lord": "Mercury" },
{ "house": 2, "sign": "Libra", "degree": 12.15, "lord": "Venus" }
]
}vedika_dasha (system: "vimshottari")
{
"currentDasha": {
"mahadasha": { "planet": "Jupiter", "start": "2020-03-15", "end": "2036-03-15" },
"antardasha": { "planet": "Saturn", "start": "2024-09-01", "end": "2027-03-15" },
"pratyantar": { "planet": "Mercury", "start": "2025-11-20", "end": "2026-04-30" }
},
"dashaTimeline": [
{ "planet": "Ketu", "start": "1990-06-15", "end": "1997-06-15", "years": 7 },
{ "planet": "Venus", "start": "1997-06-15", "end": "2017-06-15", "years": 20 },
{ "planet": "Sun", "start": "2017-06-15", "end": "2023-06-15", "years": 6 }
]
}vedika_tarot_draw (spread: "three-card")
{
"spread": "three-card",
"cards": [
{ "position": "past", "card": "The Tower", "number": 16, "suit": "major", "reversed": false, "meaning": "Sudden upheaval, revelation, awakening" },
{ "position": "present", "card": "Two of Cups", "number": 2, "suit": "cups", "reversed": false, "meaning": "Partnership, harmony, mutual attraction" },
{ "position": "future", "card": "The Star", "number": 17, "suit": "major", "reversed": false, "meaning": "Hope, renewal, inspiration, serenity" }
],
"deck": "rider-waite"
}vedika_chinese_bazi
{
"system": "chinese",
"chart": {
"yearPillar": { "stem": { "name": "Geng", "chinese": "庚", "element": "Metal", "polarity": "Yang" }, "branch": { "name": "Wu", "chinese": "午", "animal": "Horse", "element": "Fire", "polarity": "Yang" }, "label": "Geng Wu" },
"monthPillar": { "stem": { "name": "Ren", "chinese": "壬", "element": "Water", "polarity": "Yang" }, "branch": { "name": "Wu", "chinese": "午", "animal": "Horse", "element": "Fire", "polarity": "Yang" }, "label": "Ren Wu" },
"dayPillar": { "stem": { "name": "Xin", "chinese": "辛", "element": "Metal", "polarity": "Yin" }, "branch": { "name": "Hai", "chinese": "亥", "animal": "Pig", "element": "Water", "polarity": "Yin" }, "label": "Xin Hai" },
"hourPillar": { "stem": { "name": "Yi", "chinese": "乙", "element": "Wood", "polarity": "Yin" }, "branch": { "name": "Wei", "chinese": "未", "animal": "Goat", "element": "Earth", "polarity": "Yin" }, "label": "Yi Wei" },
"dayMaster": { "name": "Xin", "chinese": "辛", "element": "Metal", "polarity": "Yin" },
"dominantElement": "Water",
"elementBalance": { "Wood": 1, "Fire": 2, "Earth": 1, "Metal": 2, "Water": 2 }
}
}vedika_compatibility (type: "guna-milan")
{
"totalScore": 26,
"maxScore": 36,
"recommendation": "Good match",
"factors": [
{ "name": "Varna", "score": 1, "maxScore": 1, "description": "Spiritual compatibility" },
{ "name": "Vashya", "score": 2, "maxScore": 2, "description": "Mutual attraction" },
{ "name": "Tara", "score": 3, "maxScore": 3, "description": "Birth star compatibility" },
{ "name": "Yoni", "score": 3, "maxScore": 4, "description": "Physical compatibility" },
{ "name": "Graha Maitri", "score": 5, "maxScore": 5, "description": "Mental compatibility" },
{ "name": "Gana", "score": 5, "maxScore": 6, "description": "Temperament" },
{ "name": "Bhakoot", "score": 7, "maxScore": 7, "description": "Health & wealth" },
{ "name": "Nadi", "score": 0, "maxScore": 8, "description": "Genetic compatibility" }
],
"mangalDosha": { "male": false, "female": true, "compatible": true }
}vedika_panchang (element: "full")
{
"date": "2026-03-13",
"vara": { "name": "Friday", "deity": "Shukra" },
"tithi": { "name": "Krishna Chaturdashi", "deity": "Shiva", "endTime": "2026-03-13T18:45:00+05:30" },
"nakshatra": { "name": "Purva Bhadrapada", "lord": "Jupiter", "endTime": "2026-03-13T22:10:00+05:30" },
"yoga": { "name": "Siddha", "endTime": "2026-03-13T15:30:00+05:30" },
"karana": { "name": "Vanija", "endTime": "2026-03-13T18:45:00+05:30" },
"sunrise": "06:28:00+05:30",
"sunset": "18:22:00+05:30"
}vedika_ai_chat
{
"response": "Based on your birth chart, Jupiter is currently transiting your 7th house...",
"conversationId": "conv_abc123",
"tokens": { "input": 1250, "output": 480 },
"cost": 0.012,
"system": "vedic"
}vedika_predictions (period: "daily")
{
"sign": "aries",
"period": "daily",
"date": "2026-03-13",
"prediction": {
"overall": "A favorable day for career decisions...",
"career": "Professional growth opportunities emerge...",
"love": "Venus influence brings harmony...",
"health": "Focus on physical activity...",
"finance": "Avoid impulsive spending..."
},
"luckyNumber": 7,
"luckyColor": "Red"
}vedika_western_transits (type: "aspects")
{
"transitAspects": [
{
"transitPlanet": "Saturn",
"transitSign": "Pisces",
"transitDegree": 22.5,
"natalPlanet": "Moon",
"natalSign": "Gemini",
"natalDegree": 24.1,
"aspect": "Square",
"orb": 1.6,
"applying": true,
"influence": "challenging"
}
]
}vedika_usage (action: "wallet")
{
"walletBalance": 5456,
"currency": "USD",
"displayBalance": "$54.56",
"plan": "professional",
"subscriptionEndDate": "2026-04-01T00:00:00Z"
}Note:
walletBalanceis in USD cents. Divide by 100 to display as dollars.
Error Handling
All errors are returned as MCP tool errors with descriptive messages:
Status | Meaning | Message Example |
400 | Invalid input |
|
401 | Bad API key |
|
402 | No balance |
|
403 | Inactive sub |
|
429 | Rate limited | Classified by the response body |
422 | Idempotency key refused |
|
5xx | Server error | GET requests and POSTs that carry a caller |
Timeout | Too slow |
|
Timeout Configuration
Request Type | Timeout | Retries |
AI chat ( | 90s | No retry (already long) |
POST computation endpoints | 30s | 1 retry on 5xx only with an |
GET endpoints | 15s | 1 retry on 5xx |
Pricing
No free tier. Every query costs money. Free sandbox with mock data: set VEDIKA_BASE_URL=https://api.vedika.io/sandbox. See also vedika.io/sandbox.
Plan | Price | Wallet Credits/mo | Rate Limit |
Starter | $12/mo | $12 | 60 req/min |
Professional | $60/mo | $60 | 120 req/min |
Business | $120/mo | $120 | 300 req/min |
Enterprise | $240/mo | $240 | 600 req/min |
Get your API key at vedika.io/pricing.
Technical Details
Runtime: Node.js 20+
Transport: stdio (MCP standard)
Dependencies:
@modelcontextprotocol/sdk,zod(zero other runtime deps)HTTP: Native
fetch(no axios)Idempotency: No idempotency or request-id header is sent unless a tool takes an explicit
idempotencyKey(Vastu batch, jobs andvastu_operation). The API reads a caller-sentx-request-idon/v2as an idempotency claim and refuses it with 422 on endpoints that are not certified for idempotency.Retry: One retry with 1s backoff on 5xx for GET requests and for POSTs that carry an
idempotencyKey. A billed POST without a key is never retried. 4xx responses, including 402 and 429, are never retried.Timeouts: AI chat 90s, POST computation 30s, GET endpoints 15s
Module format: This package is ESM-only (
"type": "module"). Running it vianpx/thevedika-mcp-serverbin (the normal MCP-client setup above) works regardless of your own project's module format. If you instead import it as a library from a CommonJS project, plainrequire('@vedika-io/mcp-server')will throw — use a dynamic import instead:const { VedikaApiClient } = await import('@vedika-io/mcp-server');
Links
License
MIT
Vastu jobs and artifacts
Call vastu_job_submit with request.operation set to assessments, plan-analyze or plan-report, request.items containing unique {id, input} objects, and a caller-retained idempotencyKey. For a report handoff, use input.format: "html"; JSON reports and plan analyses expose JSON artifacts. Submission returns a stable jobId and maxCharge quote. Each successful item uses the existing single-item price, with no extra job fee; invalid items do not charge.
Use vastu_job_status to poll counts and charges, vastu_job_results to read pages (nextCursor: null ends pagination), and vastu_job_artifact with jobId and itemId to retrieve the exact deliverable and receipt. The same artifact is a read-only resource at vedika://vastu/jobs/{jobId}/items/{itemId}; URL-encode the item ID. Results and artifacts expire after seven days. vastu_job_cancel stops unstarted items; an in-flight item can complete and charge. Use package version 2.0.7 or later for these tools, and confirm that jobs are available on your account. The keyless sandbox returns stateless previews; it cannot retain a job for status or artifact retrieval.
Available Tools
48 toolsvastu_audit_floor_planA
Audit an entire floor plan for Vastu compliance in one call — pass every room in the building with the compass zone it actually occupies, and get back a per-room compliance verdict, severity, and remedy for anything misplaced, plus an overall score. Use vastu_room_placement instead if you only need guidance for a single room.
Inputs: rooms (required).
vastu_declinationA
Look up a coarse magnetic-declination reference estimate for India. The result is unverified and is not field calibration; do not treat it as a verified compass correction.
Inputs: lat (required), lon (required), date.
vastu_generate_planA
Generate a Vastu-compliant floor plan from a high-level brief instead of an explicit room list — give it plot dimensions plus a room programme (BHK, bathrooms, parking, pooja room, etc.) and it infers and places the rooms. Returns up to 3 ranked variants.
Inputs: plot (required), requirements (required).
vastu_job_artifactARead-only
Fetch the exact completed item artifact and original receipt by stable job and item IDs. HTML reports use format:html at submit. No arbitrary URLs are fetched; reads do not charge.
Inputs: jobId (required), itemId (required). Returns: data, success
vastu_job_cancelA
Cancel unstarted job items. An item already in flight can finish and charge. This call does not charge.
Inputs: jobId (required). Returns: data, success
vastu_job_resultsARead-only
Read one results page with per-item response, receipts and artifacts. Pass nextCursor verbatim; null ends pagination. Results expire after 7 days.
Inputs: jobId (required), cursor. Returns: data, success
vastu_job_statusBRead-only
Read job status, counts and billing. Read-only; does not charge.
Inputs: jobId (required). Returns: data, success
vastu_job_submitB
Submit 1-1000 assessment, plan analysis or report inputs. Retain the Idempotency-Key. Quote is maxCharge; only successful items charge the existing operation price. No job fee.
Inputs: request (required), idempotencyKey (required). Returns: data, success
vastu_mandala_projectA
Project a Vastu Purusha Mandala grid onto a plot polygon. "9-zone" = the coarse 9-sector grid. "81-pada" = the 81-square plan of Brihat Samhita 53.43-48: each cell carries its verse square number and, where the verse names one, the devata it seats there (28 squares have none). Fitting that grid to YOUR polygon is a computed layout convention, not a classical measurement. "brahmasthan" = just the central sacred zone that must stay unbuilt. Returns which mandala cell/devata falls where on the plot.
Inputs: scheme (required), plotPolygon (required), bearingDeg.
vastu_operationA
Call any Vastu Shastra operation directly by its path suffix under /v2/astrology/vastu/ — for the long tail of the 143-operation surface not covered by the dedicated vastu_* tools. Examples: "entrance/recommend", "entrance/pada", "entrance/obstruction-check", "placement/borewell", "placement/main-gate", "score/overall", "score/zone-wise", "specialized/temple", "timing/grihapravesh", "timing/bhumi-pujan", "plot/shape", "plot/slope", "compound/wall-analysis", "elements/distribution", "plan/analyze", "plan/optimize", "direction/sun-path", "ar/true-north-calibrate". Prefer a dedicated vastu_* tool when your need matches one.
Inputs: op (required), params, idempotencyKey.
vastu_referenceA
Look up a static Vastu Shastra reference table — no calculation, no building input required. mandala-9-zone/mandala-45-devatas/mandala-64-pada = the Vastu Purusha Mandala grids and their presiding devatas. directions-8/16/32 = the compass direction system at increasing resolution. defects-catalog/remedies-catalog = known Vastu doshas (defects) and their corresponding remedies. colors-by-zone/materials-by-zone = recommended colors/materials per compass zone. gate-obstructions = the Brihat Samhita 53.76-81 table of features (road/tree/well/pillar/etc.) opposite the main gate and their verdicts. Billed reference operation.
Inputs: table (required).
vastu_room_placementA
Get Vastu Shastra placement guidance for ONE room type in a specific (or proposed) compass zone — whether it is compliant, the severity if not, the recommended zone, and the remedy. One dedicated backend endpoint per room type. Use vastu_audit_floor_plan instead to check a whole building at once.
Inputs: zone (required), roomType (required).
vedika_ai_chatB
Send natural-language astrology questions to the Vedika API, with birth details when the operation requires them. Select Vedic, Western or KP through the documented system field; use conversationId for follow-up questions. Operation and language availability depend on the route and account plan. Response time depends on request complexity, answer length and selected tier. Review current billing terms at https://vedika.io/pricing before production use.
Inputs: question (required), speed, system, category, +6 more.
vedika_ashtakavargaA
Calculate Ashtakavarga — the 8-fold division system scoring each planet strength across 12 signs (0-8 points per sign). "planet" returns Bhinnashtakavarga (individual planet table). "sarva" returns Sarvashtakavarga (combined all 7 planets per sign, max 337 total). Signs scoring 28+ in SAV are strong for transits. Used for timing events. Cost: $0.025/call.
Inputs: type (required), datetime (required), latitude (required), timezone (required), +3 more.
vedika_birth_chartA
Generate a Vedic birth chart (Kundli) with planetary positions, house cusps, ascendant, nakshatras, and dignities. All calculations use Vedika Ephemeris (sidereal, Lahiri ayanamsa default). "kundli" returns the full chart. "planetary-positions" returns all 9 planets + Rahu/Ketu with sign, degree, house, nakshatra, retrograde status. "house-cusps" returns all 12 house boundaries. "ascendant" returns lagna details. Cost: $0.016-0.028/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +2 more.
vedika_calendarB
Vedic calendar calculations and timing. Ritu = Hindu 6-season system. Solstice = equinox/solstice dates. Anandadi Yoga = 27 yogas from tithi+weekday. Auspicious/Inauspicious Yoga = daily favorable combos. Auspicious/Inauspicious Period = time windows for activities. Gowri Nalla Neram = South Indian Choghadiya. Disha Shool = inauspicious directions per weekday. Planet Transit = current transit positions. Chandrashtama = Moon in 8th from natal Moon (avoid important work). Cost: $0.016-0.020/call.
Inputs: type (required), datetime (required), latitude (required), timezone (required), +2 more.
vedika_chinese_baziA
Calculate the current basic Ba Zi (Four Pillars) chart from a timezone-free birth datetime. Returns Year, Month, Day, and Hour pillars, Day Master, dominant element, and element balance. This route does not provide Da Yun, annual luck pillars, or favorable/unfavorable elements. Timezone-bearing input is temporarily rejected while accepted civil, zoned, or solar-time semantics remain unresolved. Consult current Vedika API pricing before use.
Inputs: datetime (required).
vedika_chinese_zodiacA
Get Chinese zodiac animal sign and element for a birth year. Returns the animal (Rat through Pig in 12-year cycle), element (Wood, Fire, Earth, Metal, Water in 60-year cycle), yin/yang polarity, lucky numbers, lucky colors, compatible animals, and incompatible animals. Accounts for Chinese New Year date (animal year starts late Jan/early Feb, not Jan 1). Cost: $0.003/call.
Inputs: year (required), birthDate.
vedika_compatibilityA
Vedic marriage/relationship compatibility matching. Requires birth details for BOTH male and female. Guna Milan uses 36-point Ashtakoot system (North Indian) scoring 8 factors: Varna, Vashya, Tara, Yoni, Graha Maitri, Gana, Bhakoot, Nadi. 18+/36 is acceptable. Kundali adds Mangal Dosha cross-check. Nakshatra Porutham is 10-factor South Indian. Thirumana Porutham is Tamil marriage matching. Cost: $0.040-0.048/call.
Inputs: male (required), female (required), type.
vedika_conversationA
Manage multi-turn AI conversations. List recent active conversations (default 10, maximum 100, ordered by last activity). Pass data.nextCursor to continue, even after an empty page; stop at null. data.paginationAvailable=false means continuation is unavailable. Activity can change between calls; this is not a snapshot. Get a specific conversation with stored messages, delete one, or extend its TTL. Conversations are created automatically when you use vedika_ai_chat and persist for context continuity. Free.
Inputs: action (required), limit, cursor, conversationId.
vedika_crystals_recommendA
Get crystal and gemstone recommendations based on zodiac sign, ruling planet, or specific need. Returns recommended crystals with properties, chakra association, cleansing method, and how to use them. Combines Vedic ratna-shastra (gemstone science from Garuda Purana and BPHS) with modern crystal healing correspondences. Accepts zodiac sign (Vedic or Western) or a specific planet to strengthen. Cost: $0.012/call.
Inputs: need, sign, planet.
vedika_daily_bundleA
Get the day's general content in one call: tarot card, angel number, crystal, mantra, moon phase, rune and I Ching. It is not a personal or per-sign reading. For a sign horoscope use vedika_horoscope, and for panchang use vedika_panchang. Consult current Vedika API pricing before use.
Inputs: date, lang.
vedika_dashaA
Calculate planetary period timelines (Dasha). Vimshottari is the primary 120-year cycle used in Vedic astrology — shows current Mahadasha (major period), Antardasha (sub-period), and Pratyantar (sub-sub-period) with exact start/end dates. Based on Moon nakshatra at birth. Yogini is an alternative 8-year cycle. Cost: $0.016-0.028/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +2 more.
vedika_dasha_ashtottariA
Calculate the Ashtottari Dasha (108-year cycle). An alternative to Vimshottari (120-year) used when Rahu is in a Kendra or Trikona from the Lagna lord, or when the birth is at night in Krishna Paksha / day in Shukla Paksha. Uses 8 planets (excludes Ketu) with periods: Sun 6y, Moon 15y, Mars 8y, Mercury 17y, Saturn 10y, Jupiter 19y, Rahu 12y, Venus 21y = 108 total. Returns current Mahadasha, Antardasha, and full timeline with start/end dates. Cost: $0.020/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +2 more.
vedika_divisional_chartsA
Calculate Vedic divisional charts (Vargas). Each division reveals a specific life area: D2 Hora (wealth), D3 Drekkana (siblings), D4 Chaturthamsa (property), D7 Saptamsa (children), D9 Navamsa (marriage/dharma — most important after Rashi), D10 Dashamsa (career), D12 Dwadashamsa (parents), D16 Shodasamsa (vehicles), D20 Vimsamsa (spiritual), D24 Chaturvimsamsa (education), D27 Bhamsa (strength), D30 Trimsamsa (evils), D40 Khavedamsa (maternal), D45 Akshavedamsa (paternal), D60 Shashtiamsa (past-life karma). Vedika Ephemeris computed. Cost: $0.005/call.
Inputs: chart (required), datetime (required), latitude (required), timezone (required), +2 more.
vedika_doshasA
Detect unfavorable planetary combinations (doshas) in a birth chart. Mangal Dosha checks Mars in houses 1,2,4,7,8,12 (affects marriage — BPHS Ch. 80 vv. 47-49 / Stri Jataka). Kaal Sarp detects all planets enclosed between Rahu-Ketu axis. Sade Sati tracks Saturn 7.5-year transit over natal Moon (3 phases). Pitru checks ancestral karma. Nadi checks pulse compatibility. "all" runs Mangal+Kaal Sarp+Pitru together. Cost: $0.016-0.040/call.
Inputs: type (required), datetime (required), latitude (required), timezone (required), +2 more.
vedika_health_ayurvedicB
Ayurvedic constitution (Prakriti) analysis derived from birth chart. Maps planetary positions to the three doshas: Vata (air+ether, governed by Saturn and Rahu), Pitta (fire+water, governed by Sun and Mars), and Kapha (earth+water, governed by Moon and Jupiter). Returns dominant dosha, sub-dosha balance, vulnerable body areas based on 6th/8th house lords, recommended diet type, lifestyle adjustments, favorable seasons, and Ayurvedic herbs aligned with the chart. Based on Brihat Samhita and Charaka Samhita cross-references. Cost: $0.024/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +3 more.
vedika_horoscopeA
Get a daily, weekly, or monthly Vedic horoscope, or a daily Western horoscope, for a zodiac sign. Western with advanced=true uses the advanced registered route. Unsupported Western weekly/monthly requests fail before any API call. Accepts English (aries-pisces) and Hindi (mesha-meena) sign names. Consult current Vedika API pricing before use.
Inputs: sign (required), period, system, advanced.
vedika_human_design_chartA
Generate a Human Design BodyGraph chart from birth details. Human Design synthesizes the I Ching, Kabbalah Tree of Life, Hindu-Brahmin chakra system, and quantum physics. Returns your Type (Generator, Manifestor, Projector, Reflector, Manifesting Generator), Strategy, Authority (Emotional, Sacral, Splenic, etc.), Profile (e.g., 1/3, 4/6), defined/undefined Centers (9 centers), Channels, and Gates. The BodyGraph is calculated from precise birth time using planetary positions at birth and 88 degrees of the Sun before birth. Cost: $0.040/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +1 more.
vedika_iching_castA
Cast an I Ching (Book of Changes) hexagram for divination. Uses the traditional yarrow stalk or three-coin method simulation. Returns the primary hexagram (1-64), its name, judgment, image, and line texts. If any changing lines exist, also returns the transformed hexagram. Each hexagram includes the upper and lower trigrams with their attributes. The I Ching is the oldest Chinese divination system (~3000 years). Cost: $0.012/call.
Inputs: method, question.
vedika_lalkitab_remediesA
Get Lal Kitab remedies for afflicted planets based on their house placement. Lal Kitab (Red Book) is a 20th-century Urdu text offering unique remedies distinct from classical BPHS — simple, actionable totkas (remedies) involving donations, wearing specific items, keeping objects at home, or performing actions on specific days. Returns planet-by-planet analysis with house placement, whether the planet is exalted/debilitated in Lal Kitab terms (different from Parashari), the affliction description, and 2-3 specific remedies per afflicted planet. Cost: $0.020/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +3 more.
vedika_matrimony_matchA
Comprehensive Kundali matching for marriage. The default report combines the 36-point Ashtakoota Guna Milan, a Dashakoot summary, dosha cancellation analysis (Mangal, Nadi, Bhakoot) and an overall compatibility verdict. Set southIndian=true for the South Indian Porutham system instead. Consult current Vedika API pricing before use.
Inputs: bride (required), groom (required), southIndian.
vedika_muhurtaA
Calculate auspicious and inauspicious time periods for today or a specific date. Choghadiya divides the day into ~90-minute slots. Hora assigns planetary rulers to each hour. Rahu Kaal, Gulika Kaal, Yamaghanta are inauspicious periods to avoid. Abhijit Muhurta is the most auspicious midday window. Brahma Muhurta is the pre-dawn spiritual window. "combined" returns choghadiya+hora+rahu-kaal. "auspicious" returns only good periods. Location defaults to Delhi. Cost: $0.012-0.020/call.
Inputs: type (required), date, latitude, timezone, +1 more.
vedika_numerologyA
Numerology calculations using Pythagorean or Chaldean systems. Life Path (birth date) = life purpose. Destiny/Expression (full name) = talents. Personality (consonants) = how others see you. Soul Urge (vowels) = inner desires. Personal Year = current year theme. Complete = all core numbers + pinnacle cycles. Compatibility = two-person comparison. Cost: $0.003-0.010/call.
Inputs: type (required), name, year, system, +3 more.
vedika_numerology_completeA
Full numerology report combining all core numbers in a single call. Returns Life Path number (from birth date), Destiny/Expression number (from full name), Soul Urge/Heart Desire number (from vowels), Personality number (from consonants), Maturity number (Life Path + Destiny), Personal Year/Month/Day cycles, Pinnacle cycles (4 life phases), Challenge numbers, Karmic Debt numbers (13, 14, 16, 19), Karmic Lessons (missing digits in name), Hidden Passion (most frequent digit), and Lucky Day/Color. Supports both Pythagorean and Chaldean systems. Cost: $0.010/call.
Inputs: name (required), birthDate (required), system, currentName.
vedika_panchangA
Hindu calendar (Panchang) for today or a specific date/time. Returns the 5 limbs: Tithi (lunar day), Nakshatra (lunar mansion), Yoga (luni-solar combination), Karana (half-tithi), and Vara (weekday). Also includes sunrise/sunset/moonrise times. Location defaults to Delhi if not specified. Cost: $0.012/call.
Inputs: date, time, element, latitude, +2 more.
vedika_predictionsA
Get Vedic astrology predictions for a zodiac sign or from birth details. Daily, weekly, monthly, quarterly, or yearly. If rashi (zodiac sign) is provided, returns sign-based prediction. If birth datetime is provided, Moon sign is derived automatically. First call per sign per day is charged; subsequent calls same sign+day are cached (free). Accepts English (aries-pisces) and Hindi (mesha-meena) sign names. Cost: $0.020-0.088/call.
Inputs: period (required), rashi, datetime, latitude, +2 more.
vedika_spiritual_deityA
Determine the Ishta Devata (personal deity) from the birth chart. Uses the Atmakaraka (soul planet) and its Navamsa (D9) placement to identify the deity most aligned with the native per BPHS Ch.33. Also returns Dharma Devata (from 9th lord in D9), Palana Devata (sustenance deity from Amatya Karaka in D9), and Guru Devata (spiritual guide from Bhratri Karaka in D9). Each deity includes associated mantras, temples, worship day, and offerings. Cost: $0.020/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +2 more.
vedika_spiritual_mantraA
Get personalized mantra recommendations based on birth chart analysis. Identifies weak or afflicted planets and recommends Vedic mantras from classical texts (Mantra Mahodadhi, BPHS remedies chapter). Returns the mantra in Sanskrit (Devanagari + IAST transliteration), the specific planet or deity it addresses, recommended repetition count (japa sankhya), best time to chant (muhurta), direction to face, and associated rosary (mala) material. Can also return mantras for specific purposes like career, health, or relationships. Cost: $0.016/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +3 more.
vedika_strengthB
Calculate planetary strength and relationships. Chandra Bala = Moon strength (8 types for muhurta timing). Tara Bala = nakshatra compatibility (9 Tara groups). Upagraha = sub-planet positions (Dhuma, Vyatipata, Parivesha, Chapa, Upaketu, Gulika, Mandi). Planet Relationship = Naisargika Maitri friendship table per BPHS. Shadbala = the 6-fold strength system (Sthana, Dig, Kala, Cheshta, Naisargika, Drik bala), normalized 0-100. Cost: $0.020/call.
Inputs: type (required), datetime (required), latitude (required), timezone (required), +2 more.
vedika_tarot_dailyA
Get the tarot card of the day. Returns a single card with its upright meaning, reversed meaning, keywords, element, suit, and daily guidance. Cached per day — repeated calls return the same card. Cost: $0.008/call.
Inputs: date, deck.
vedika_tarot_drawA
Draw tarot cards in a chosen spread layout. Single = 1 card quick answer. Three-card = past/present/future or situation/action/outcome. Celtic Cross = 10-card comprehensive reading covering situation, challenges, past, future, above, below, advice, environment, hopes, and outcome. Horseshoe = 7-card arc. Relationship and Career spreads are themed 5-card layouts. Each card includes upright/reversed orientation, suit, and position meaning. Cost: $0.020-0.048/call.
Inputs: deck, spread, question.
vedika_usageA
Check your Vedika API usage, wallet balance, and billing history. Wallet balance is in USD cents (divide by 100 for dollars). History returns recent transactions (default 50, maximum 500) from at most 1000 latest records. No page or cursor is available. Summary and models aggregate at most 1000 records; check the returned truncated and scanLimit fields. Models groups by public service tier. Free — no cost to check.
Inputs: limit, action.
vedika_varshaphalA
Vedic annual horoscope (Varshaphal / Tajaka Solar Return). Cast for the exact moment the Sun returns to its natal sidereal position each year. Uses Tajaka system with Sahams (sensitive points), Muntha (progressed ascendant), and Tajaka yogas. Different from Western Solar Return — uses sidereal zodiac. Cost: $0.006/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +2 more.
vedika_western_progressionsA
Western secondary progressions — "a day for a year" technique. Shows how natal chart evolves over time. Progressed Moon moves ~1 degree/month (changes sign every 2.5 years). Progressed Sun moves ~1 degree/year. "chart" returns full progressed chart. "positions" returns progressed planets. "aspects" returns progressed-to-natal aspects. Tropical zodiac. Cost: $0.092/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +2 more.
vedika_western_relationshipA
Western relationship astrology — synastry and composite charts for two people. Synastry overlays charts to find inter-aspects (how planets interact between two people). Composite creates a midpoint chart representing the relationship itself. Uses person1/person2 (gender-neutral). Tropical zodiac. Cost: $0.148/call.
Inputs: person1 (required), person2 (required), type.
vedika_western_solar_returnB
Western solar return chart — cast for the exact moment the transiting Sun returns to its natal position each year (your "solar birthday"). Reveals themes for the coming year. "chart" returns full solar return chart. "positions" returns planets at solar return moment. "aspects" returns solar return chart aspects. Tropical zodiac. Cost: $0.120/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +2 more.
vedika_western_transitsA
Western astrology current transits against a natal chart. Tropical zodiac (no ayanamsa). "chart" returns the full transit chart overlay. "positions" returns current planetary positions in tropical signs. "aspects" returns current transit aspects (conjunction, opposition, trine, square, sextile) to natal planets with orbs. Vedika Ephemeris computed. Cost: $0.064/call.
Inputs: datetime (required), latitude (required), timezone (required), longitude (required), +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 48 tools
The vastu_* / vedika_* prefix split gives a useful first cut, but several pairs are hard to tell apart: vedika_compatibility vs vedika_matrimony_match (both Ashtakoot Guna Milan), vedika_numerology vs vedika_numerology_complete, and vedika_predictions vs vedika_horoscope all read as near-duplicates. vastu_operation is an explicit catch-all over the same 143-operation surface as the dedicated vastu_* tools, and vastu_job_status overlaps with vastu_job_results.
Names are uniformly snake_case and consistently namespaced by domain (vastu_* / vedika_*) with a readable verb_noun pattern (audit_floor_plan, cast, draw, recommend). The only inconsistency is that many tools are bare nouns (vedika_dasha, vedika_panchang, vedika_doshas) while siblings use verbs. No camelCase or style chaos.
48 tools is well past the heavy threshold and forces the agent to scan a long list for every request. The count is inflated by obvious consolidation candidates (numerology vs numerology_complete, two compatibility tools, several job-management tools) and by a catch-all vastu_operation that duplicates part of the dedicated surface.
Coverage of the astrology/vastu domain is genuinely broad — natal charts, dashas, doshas, compatibility, panchang, muhurta, vargas, western techniques, numerology, tarot/I Ching/Ba Zi, remedies, and a full Vastu lifecycle with jobs, artifacts and static references. Minor gaps remain (KP system only reachable via vedika_ai_chat, no update/edit operations for stored conversations beyond TTL extension), but nothing that blocks core workflows.
Maintenance
Related MCP Connectors
Vedic and Western astrology for AI agents: charts, dasha, matchmaking, panchanga, numerology, tarot.
Professional Vedic astrology tools for AI agents via MCP.
Real astrology for AI agents: cosmic weather, synastry, timing, astrocartography, and divination.
Vedic astrology readings for AI agents: life areas, compatibility, business timing, gems, ephemeris.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents with persistent semantic memory, including semantic recall, knowledge graphs, and instant domain expertise via pre-built Intelligence Packs.1052 npmMIT
- AlicenseNot gradedqualityDmaintenanceInjects structured professional domain expertise into AI agents, providing access to decision frameworks, workflows, terminology, and regulatory context across 24 professional domains.71 npmMIT

Hormonaly MCP Serverofficial
FlicenseNot gradedqualityDmaintenanceEnables AI agents to access 24 clinical tools for evidence synthesis, protocol lookup, and decision support in peptide, hormone, and longevity medicine.2-- AlicenseNot gradedqualityCmaintenanceExposes 20 deterministic tools for finance, data, content, and lifestyle tasks via MCP, A2A, and REST interfaces, enabling automation and multi-agent workflows.MIT