Skip to main content
Glama
@vedika-io/mcp-server

@vedika-io/mcp-server

Official
by vedika-io

@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-server

Get 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-server with no version resolves whatever npm currently tags latest on 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_URL names 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.json is gitignored and stays on your machine. This README said settings.json until 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

VEDIKA_API_KEY

Yes

—

Your API key (format: vk_live_*). Sent as Authorization: Bearer.

VEDIKA_BASE_URL

No

https://api.vedika.io

Only https://api.vedika.io and the free sandbox https://api.vedika.io/sandbox are accepted. Any other value stops the server at startup, so a key cannot be routed to another host.


Tools

Core

Tool

Description

Cost

vedika_ai_chat

Natural-language questions with Vedic, Western or KP selection and follow-up conversations. Operation and language availability depend on the route and account plan.

Current billing terms

vedika_conversation

List, get, delete, or extend multi-turn conversations.

Free

Vedic Computation

Tool

Types

Cost

vedika_birth_chart

kundli, birth-chart, planetary-positions, house-cusps, ascendant, birth-details

$0.016-0.028

vedika_dasha

vimshottari, mahadasha, antardasha, pratyantardasha, yogini

$0.016-0.028

vedika_doshas

mangal, kaal-sarp, pitru, nadi, all, sade-sati, sade-sati-advanced

$0.016-0.040

vedika_compatibility

guna-milan, kundali, nakshatra-porutham, thirumana-porutham

$0.040-0.048

vedika_panchang

full, tithi, nakshatra, yoga, karana

$0.012

vedika_muhurta

choghadiya, hora, rahu-kaal, gulika-kaal, yamaghanta, abhijit, brahma, durmuhurta, combined, auspicious

$0.012-0.020

vedika_divisional_charts

D2-D60 (15 charts: Hora, Drekkana, Chaturthamsa, Saptamsa, Navamsa, Dashamsa, Dwadashamsa, Shodasamsa, Vimsamsa, Chaturvimsamsa, Bhamsa, Trimsamsa, Khavedamsa, Akshavedamsa, Shashtiamsa)

$0.005

vedika_predictions

daily, weekly, monthly, quarterly, yearly

$0.020-0.088

vedika_ashtakavarga

planet (Bhinnashtakavarga), sarva (Sarvashtakavarga)

$0.025

Western Astrology

Tool

Types

Cost

vedika_western_transits

chart, positions, aspects

$0.064

vedika_western_progressions

chart, positions, aspects

$0.092

vedika_western_solar_return

chart, positions, aspects

$0.120

vedika_western_relationship

synastry, synastry-aspects, composite, composite-aspects

$0.148

Cross-System (3 tools)

Tool

Types

Cost

vedika_horoscope

Vedic daily/weekly/monthly; Western daily or advanced daily

Verify current API pricing

vedika_numerology

life-path, destiny, personality, soul-urge, personal-year, complete, compatibility

$0.003-0.010

vedika_varshaphal

Vedic annual solar return (Tajaka system)

$0.006

Supplementary

Tool

Types

Cost

vedika_strength

chandra-bala, tara-bala, upagraha, planet-relationship, shadbala

$0.020

vedika_calendar

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

vedika_tarot_draw

Draw tarot cards in single, three-card, celtic-cross, horseshoe, relationship, or career spreads. Rider-Waite, Thoth, or Marseille decks.

$0.020-0.048

vedika_tarot_daily

Card of the day with meanings, keywords, and daily guidance. Cached per day.

$0.008

vedika_iching_cast

Cast an I Ching hexagram (yarrow or coin method). Primary hexagram + changing lines + transformed hexagram.

$0.012

Chinese Astrology

Tool

Description

Cost

vedika_chinese_zodiac

Chinese zodiac animal, element, yin/yang, lucky numbers/colors, compatible/incompatible animals. Accounts for Chinese New Year dates.

$0.003

vedika_chinese_bazi

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

vedika_human_design_chart

Human Design BodyGraph: Type, Strategy, Authority, Profile, defined/undefined Centers, Channels, Gates.

$0.040

vedika_crystals_recommend

Crystal and gemstone recommendations by zodiac sign, planet, or need. Vedic ratna-shastra + modern crystal healing.

$0.012

Vedic Extended

Tool

Description

Cost

vedika_matrimony_match

Kundali matching: 36-point Ashtakoota, Dashakoot summary, dosha cancellations and overall verdict. southIndian: true for Porutham.

Verify current API pricing

vedika_dasha_ashtottari

Ashtottari 108-year dasha cycle (alternative to Vimshottari). 8 planets, Mahadasha/Antardasha/Pratyantardasha depth.

$0.020

vedika_lalkitab_remedies

Lal Kitab remedies for afflicted planets. Unique totkas (practical remedies) distinct from classical BPHS. Optional debt (rina) analysis.

$0.020

vedika_spiritual_mantra

Personalized mantra recommendations from classical texts. Sanskrit + IAST transliteration, japa count, muhurta, mala material.

$0.016

Spiritual & Wellness

Tool

Description

Cost

vedika_spiritual_deity

Ishta Devata (personal deity) from Atmakaraka in Navamsa. Also Dharma, Palana, and Guru Devata. Per BPHS Ch.33.

$0.020

vedika_health_ayurvedic

Ayurvedic Prakriti (constitution) analysis from birth chart. Vata/Pitta/Kapha balance, diet, herbs, seasonal recommendations.

$0.024

Bundles

Tool

Description

Cost

vedika_daily_bundle

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

vedika_numerology_complete

Full numerology report: Life Path, Destiny, Soul Urge, Personality, Maturity, Pinnacles, Challenges, Karmic Debt/Lessons. Pythagorean or Chaldean.

$0.010

Utility

Tool

Description

Cost

vedika_usage

Check wallet balance, usage history, summary, model breakdown

Free

Vastu

Tool

Description

vastu_reference

Static Vastu reference tables (mandala grids, directions, defects, remedies, colours, materials, gate obstructions)

vastu_audit_floor_plan

Audit a room list against the compass zones it occupies

vastu_room_placement

Placement guidance for one room type in one zone

vastu_mandala_project

Project a Vastu Purusha Mandala grid onto a plot polygon

vastu_generate_plan

Generate a Vastu-compliant plan from a plot and room programme

vastu_declination

Coarse magnetic-declination reference estimate

vastu_operation

Call any other Vastu operation by path suffix. assessments/batch requires a retained idempotencyKey

vastu_job_submit, vastu_job_status, vastu_job_results, vastu_job_cancel, vastu_job_artifact

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

datetime

string

Yes

ISO 8601 format. Time is required for accurate house/ascendant.

latitude

number

Yes

-90 to 90. Polar latitudes >66.5 are rejected (unreliable houses).

longitude

number

Yes

-180 to 180.

timezone

string

Yes

UTC offset preferred (+05:30). IANA names also accepted (Asia/Kolkata).

ayanamsa

string

No

Default: lahiri. Options: lahiri, kp, raman, yukteshwar, fagan-bradley, true-chitra, true-revati, ss-citra. Only for Vedic -- Western tools ignore this.

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: walletBalance is 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

Bad Request: datetime is required

401

Bad API key

Invalid API key. Get one at https://vedika.io/pricing -- format: vk_live_*

402

No balance

Insufficient wallet balance (required $0.016, available $0.005, deficit $0.011). Add funds at https://vedika.io/dashboard. Do not retry until the wallet is topped up. Never retried.

403

Inactive sub

Subscription inactive or endpoint not included in your plan.

429

Rate limited

Classified by the response body code. RATE_LIMIT_EXCEEDED: Rate limited. Retry after 5s. DAILY_LIMIT_EXCEEDED: Daily call limit reached. Do not retry until the limit resets... Never retried automatically.

422

Idempotency key refused

IDEMPOTENCY_NOT_SUPPORTED: the endpoint does not take a key and no charge was attempted; send again without idempotencyKey.

5xx

Server error

GET requests and POSTs that carry a caller idempotencyKey are retried once with 1s backoff. Other POSTs are not retried, so a failed billed call cannot charge twice.

Timeout

Too slow

Request timed out after 30s -- /v2/astrology/kundli

Timeout Configuration

Request Type

Timeout

Retries

AI chat (vedika_ai_chat)

90s

No retry (already long)

POST computation endpoints

30s

1 retry on 5xx only with an idempotencyKey; none otherwise

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 and vastu_operation). The API reads a caller-sent x-request-id on /v2 as 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 via npx/the vedika-mcp-server bin (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, plain require('@vedika-io/mcp-server') will throw — use a dynamic import instead:

    const { VedikaApiClient } = await import('@vedika-io/mcp-server');

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 tools
vastu_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_artifactA
Read-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_resultsA
Read-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_statusB
Read-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

    A3.5/5.0

    Scored across 48 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers