{
  "markdown": "# @vedika-io/mcp-server\n\nMCP server for the [Vedika Intelligence API](https://vedika.io) — 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.\n\nThe server calls the documented Vedika API operations. Calculation and interpretation coverage varies by tool and account plan.\n\n## Discovery metadata\n\nThe `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.\n\n## Quick Start\n\n```bash\nnpm install -g @vedika-io/mcp-server\n```\n\nGet your API key at [vedika.io/pricing](https://vedika.io/pricing) (starts at $12/mo). No free tier — every query costs money.\n\n## Configuration\n\n> **Where the key goes matters more than which client you use.**\n>\n> - Put it in the **gitignored** local settings file for your client, never the\n>   shared one. A key in a committed config is a key you have published.\n> - **Pin the version.** The examples below pin `@2.0.9`. `npx -y @vedika-io/mcp-server`\n>   with no version resolves whatever npm currently tags `latest` on *every start*, so\n>   a bad or hijacked release runs the moment it is published, with nothing recording\n>   which version you were on.\n> - Versions **before 2.0.4** send your key to whatever `VEDIKA_BASE_URL` names and\n>   follow a redirect while carrying it. Do not pin below 2.0.4.\n> - The key is a payment credential: every query costs money. Treat it like a card\n>   number, not like a setting.\n\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vedika\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@vedika-io/mcp-server@2.0.9\"],\n      \"env\": {\n        \"VEDIKA_API_KEY\": \"vk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd to `.claude/settings.local.json`:\n\n> **Not `.claude/settings.json`.** That file is the shared, checked-in one — a key\n> put there is committed, pushed, and in your history for good. `settings.local.json`\n> is gitignored and stays on your machine. This README said `settings.json` until\n> 2026-09-07, and the published 2.0.3 package still does.\n\n```json\n{\n  \"mcpServers\": {\n    \"vedika\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@vedika-io/mcp-server@2.0.9\"],\n      \"env\": {\n        \"VEDIKA_API_KEY\": \"vk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to Cursor Settings > MCP Servers:\n\n```json\n{\n  \"vedika\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@vedika-io/mcp-server@2.0.9\"],\n    \"env\": {\n      \"VEDIKA_API_KEY\": \"vk_live_your_key_here\"\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vedika\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@vedika-io/mcp-server@2.0.9\"],\n      \"env\": {\n        \"VEDIKA_API_KEY\": \"vk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `VEDIKA_API_KEY` | Yes | — | Your API key (format: `vk_live_*`). Sent as `Authorization: Bearer`. |\n| `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. |\n\n---\n\n## Tools\n\n### Core\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `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](https://vedika.io/pricing) |\n| `vedika_conversation` | List, get, delete, or extend multi-turn conversations. | Free |\n\n### Vedic Computation\n\n| Tool | Types | Cost |\n|------|-------|------|\n| `vedika_birth_chart` | kundli, birth-chart, planetary-positions, house-cusps, ascendant, birth-details | $0.016-0.028 |\n| `vedika_dasha` | vimshottari, mahadasha, antardasha, pratyantardasha, yogini | $0.016-0.028 |\n| `vedika_doshas` | mangal, kaal-sarp, pitru, nadi, all, sade-sati, sade-sati-advanced | $0.016-0.040 |\n| `vedika_compatibility` | guna-milan, kundali, nakshatra-porutham, thirumana-porutham | $0.040-0.048 |\n| `vedika_panchang` | full, tithi, nakshatra, yoga, karana | $0.012 |\n| `vedika_muhurta` | choghadiya, hora, rahu-kaal, gulika-kaal, yamaghanta, abhijit, brahma, durmuhurta, combined, auspicious | $0.012-0.020 |\n| `vedika_divisional_charts` | D2-D60 (15 charts: Hora, Drekkana, Chaturthamsa, Saptamsa, Navamsa, Dashamsa, Dwadashamsa, Shodasamsa, Vimsamsa, Chaturvimsamsa, Bhamsa, Trimsamsa, Khavedamsa, Akshavedamsa, Shashtiamsa) | $0.005 |\n| `vedika_predictions` | daily, weekly, monthly, quarterly, yearly | $0.020-0.088 |\n| `vedika_ashtakavarga` | planet (Bhinnashtakavarga), sarva (Sarvashtakavarga) | $0.025 |\n\n### Western Astrology\n\n| Tool | Types | Cost |\n|------|-------|------|\n| `vedika_western_transits` | chart, positions, aspects | $0.064 |\n| `vedika_western_progressions` | chart, positions, aspects | $0.092 |\n| `vedika_western_solar_return` | chart, positions, aspects | $0.120 |\n| `vedika_western_relationship` | synastry, synastry-aspects, composite, composite-aspects | $0.148 |\n\n### Cross-System (3 tools)\n\n| Tool | Types | Cost |\n|------|-------|------|\n| `vedika_horoscope` | Vedic daily/weekly/monthly; Western daily or advanced daily | Verify current API pricing |\n| `vedika_numerology` | life-path, destiny, personality, soul-urge, personal-year, complete, compatibility | $0.003-0.010 |\n| `vedika_varshaphal` | Vedic annual solar return (Tajaka system) | $0.006 |\n\n### Supplementary\n\n| Tool | Types | Cost |\n|------|-------|------|\n| `vedika_strength` | chandra-bala, tara-bala, upagraha, planet-relationship, shadbala | $0.020 |\n| `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 |\n\n### Tarot & Divination\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `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 |\n| `vedika_tarot_daily` | Card of the day with meanings, keywords, and daily guidance. Cached per day. | $0.008 |\n| `vedika_iching_cast` | Cast an I Ching hexagram (yarrow or coin method). Primary hexagram + changing lines + transformed hexagram. | $0.012 |\n\n### Chinese Astrology\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `vedika_chinese_zodiac` | Chinese zodiac animal, element, yin/yang, lucky numbers/colors, compatible/incompatible animals. Accounts for Chinese New Year dates. | $0.003 |\n| `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 |\n\n### Alternative Systems\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `vedika_human_design_chart` | Human Design BodyGraph: Type, Strategy, Authority, Profile, defined/undefined Centers, Channels, Gates. | $0.040 |\n| `vedika_crystals_recommend` | Crystal and gemstone recommendations by zodiac sign, planet, or need. Vedic ratna-shastra + modern crystal healing. | $0.012 |\n\n### Vedic Extended\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `vedika_matrimony_match` | Kundali matching: 36-point Ashtakoota, Dashakoot summary, dosha cancellations and overall verdict. `southIndian: true` for Porutham. | Verify current API pricing |\n| `vedika_dasha_ashtottari` | Ashtottari 108-year dasha cycle (alternative to Vimshottari). 8 planets, Mahadasha/Antardasha/Pratyantardasha depth. | $0.020 |\n| `vedika_lalkitab_remedies` | Lal Kitab remedies for afflicted planets. Unique totkas (practical remedies) distinct from classical BPHS. Optional debt (rina) analysis. | $0.020 |\n| `vedika_spiritual_mantra` | Personalized mantra recommendations from classical texts. Sanskrit + IAST transliteration, japa count, muhurta, mala material. | $0.016 |\n\n### Spiritual & Wellness\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `vedika_spiritual_deity` | Ishta Devata (personal deity) from Atmakaraka in Navamsa. Also Dharma, Palana, and Guru Devata. Per BPHS Ch.33. | $0.020 |\n| `vedika_health_ayurvedic` | Ayurvedic Prakriti (constitution) analysis from birth chart. Vata/Pitta/Kapha balance, diet, herbs, seasonal recommendations. | $0.024 |\n\n### Bundles\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `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 |\n| `vedika_numerology_complete` | Full numerology report: Life Path, Destiny, Soul Urge, Personality, Maturity, Pinnacles, Challenges, Karmic Debt/Lessons. Pythagorean or Chaldean. | $0.010 |\n\n### Utility\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `vedika_usage` | Check wallet balance, usage history, summary, model breakdown | Free |\n\n### Vastu\n\n| Tool | Description |\n|------|-------------|\n| `vastu_reference` | Static Vastu reference tables (mandala grids, directions, defects, remedies, colours, materials, gate obstructions) |\n| `vastu_audit_floor_plan` | Audit a room list against the compass zones it occupies |\n| `vastu_room_placement` | Placement guidance for one room type in one zone |\n| `vastu_mandala_project` | Project a Vastu Purusha Mandala grid onto a plot polygon |\n| `vastu_generate_plan` | Generate a Vastu-compliant plan from a plot and room programme |\n| `vastu_declination` | Coarse magnetic-declination reference estimate |\n| `vastu_operation` | Call any other Vastu operation by path suffix. `assessments/batch` requires a retained `idempotencyKey` |\n| `vastu_job_submit`, `vastu_job_status`, `vastu_job_results`, `vastu_job_cancel`, `vastu_job_artifact` | Bulk Vastu jobs and artifacts (see below) |\n\n---\n\n## Input Patterns\n\n### Birth Details (required by most Vedic/Western tools)\n\n```json\n{\n  \"datetime\": \"1990-06-15T14:30:00\",\n  \"latitude\": 28.6139,\n  \"longitude\": 77.2090,\n  \"timezone\": \"+05:30\",\n  \"ayanamsa\": \"lahiri\"\n}\n```\n\n| Field | Type | Required | Notes |\n|-------|------|----------|-------|\n| `datetime` | string | Yes | ISO 8601 format. Time is required for accurate house/ascendant. |\n| `latitude` | number | Yes | -90 to 90. Polar latitudes >66.5 are rejected (unreliable houses). |\n| `longitude` | number | Yes | -180 to 180. |\n| `timezone` | string | Yes | UTC offset preferred (`+05:30`). IANA names also accepted (`Asia/Kolkata`). |\n| `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. |\n\n### Vedic Compatibility (male/female)\n\n```json\n{\n  \"type\": \"guna-milan\",\n  \"male\": { \"datetime\": \"1992-03-15T10:30:00\", \"latitude\": 28.61, \"longitude\": 77.20, \"timezone\": \"+05:30\" },\n  \"female\": { \"datetime\": \"1994-07-22T08:15:00\", \"latitude\": 19.07, \"longitude\": 72.87, \"timezone\": \"+05:30\" }\n}\n```\n\n### Western Relationship (person1/person2 -- gender-neutral)\n\n```json\n{\n  \"type\": \"synastry\",\n  \"person1\": { \"datetime\": \"1990-01-15T14:30:00\", \"latitude\": 40.71, \"longitude\": -74.00, \"timezone\": \"-05:00\" },\n  \"person2\": { \"datetime\": \"1992-08-22T09:45:00\", \"latitude\": 34.05, \"longitude\": -118.24, \"timezone\": \"-08:00\" }\n}\n```\n\n### Location-Only (panchang, muhurta)\n\n```json\n{\n  \"type\": \"choghadiya\",\n  \"latitude\": 28.6139,\n  \"longitude\": 77.2090,\n  \"timezone\": \"+05:30\"\n}\n```\n\nAll location fields are optional -- defaults to Delhi (28.6139, 77.2090, +05:30).\n\n### Zodiac Signs (predictions, horoscope)\n\nAccepts both English and Hindi (Roman transliteration):\n\n| English | Hindi |\n|---------|-------|\n| aries | mesha |\n| taurus | vrishabha |\n| gemini | mithuna |\n| cancer | karka |\n| leo | simha |\n| virgo | kanya |\n| libra | tula |\n| scorpio | vrishchika |\n| sagittarius | dhanu |\n| capricorn | makara |\n| aquarius | kumbha |\n| pisces | meena |\n\n### Tarot Spreads\n\n```json\n{\n  \"spread\": \"celtic-cross\",\n  \"question\": \"What should I focus on this month?\",\n  \"deck\": \"rider-waite\"\n}\n```\n\n### Chinese Ba Zi\n\n```json\n{\n  \"datetime\": \"1990-06-15T14:30:00\"\n}\n```\n\n### Matrimony Match (bride/groom)\n\n```json\n{\n  \"bride\": { \"datetime\": \"1994-07-22T08:15:00\", \"latitude\": 19.07, \"longitude\": 72.87, \"timezone\": \"+05:30\", \"gender\": \"female\" },\n  \"groom\": { \"datetime\": \"1992-03-15T10:30:00\", \"latitude\": 28.61, \"longitude\": 77.20, \"timezone\": \"+05:30\", \"gender\": \"male\" }\n}\n```\n\n---\n\n## Output Examples\n\n### vedika_birth_chart (type: \"kundli\")\n\n```json\n{\n  \"ascendant\": { \"sign\": \"Virgo\", \"degree\": 14.23, \"nakshatra\": \"Hasta\", \"pada\": 2 },\n  \"planets\": [\n    { \"name\": \"Sun\", \"sign\": \"Taurus\", \"house\": 9, \"degree\": 0.85, \"nakshatra\": \"Krittika\", \"pada\": 4, \"retrograde\": false, \"dignity\": \"Neutral\" },\n    { \"name\": \"Moon\", \"sign\": \"Cancer\", \"house\": 11, \"degree\": 22.14, \"nakshatra\": \"Ashlesha\", \"pada\": 3, \"retrograde\": false, \"dignity\": \"Own\" },\n    { \"name\": \"Mars\", \"sign\": \"Pisces\", \"house\": 7, \"degree\": 6.52, \"nakshatra\": \"Uttara Bhadrapada\", \"pada\": 2, \"retrograde\": false, \"dignity\": \"Neutral\" }\n  ],\n  \"houses\": [\n    { \"house\": 1, \"sign\": \"Virgo\", \"degree\": 14.23, \"lord\": \"Mercury\" },\n    { \"house\": 2, \"sign\": \"Libra\", \"degree\": 12.15, \"lord\": \"Venus\" }\n  ]\n}\n```\n\n### vedika_dasha (system: \"vimshottari\")\n\n```json\n{\n  \"currentDasha\": {\n    \"mahadasha\": { \"planet\": \"Jupiter\", \"start\": \"2020-03-15\", \"end\": \"2036-03-15\" },\n    \"antardasha\": { \"planet\": \"Saturn\", \"start\": \"2024-09-01\", \"end\": \"2027-03-15\" },\n    \"pratyantar\": { \"planet\": \"Mercury\", \"start\": \"2025-11-20\", \"end\": \"2026-04-30\" }\n  },\n  \"dashaTimeline\": [\n    { \"planet\": \"Ketu\", \"start\": \"1990-06-15\", \"end\": \"1997-06-15\", \"years\": 7 },\n    { \"planet\": \"Venus\", \"start\": \"1997-06-15\", \"end\": \"2017-06-15\", \"years\": 20 },\n    { \"planet\": \"Sun\", \"start\": \"2017-06-15\", \"end\": \"2023-06-15\", \"years\": 6 }\n  ]\n}\n```\n\n### vedika_tarot_draw (spread: \"three-card\")\n\n```json\n{\n  \"spread\": \"three-card\",\n  \"cards\": [\n    { \"position\": \"past\", \"card\": \"The Tower\", \"number\": 16, \"suit\": \"major\", \"reversed\": false, \"meaning\": \"Sudden upheaval, revelation, awakening\" },\n    { \"position\": \"present\", \"card\": \"Two of Cups\", \"number\": 2, \"suit\": \"cups\", \"reversed\": false, \"meaning\": \"Partnership, harmony, mutual attraction\" },\n    { \"position\": \"future\", \"card\": \"The Star\", \"number\": 17, \"suit\": \"major\", \"reversed\": false, \"meaning\": \"Hope, renewal, inspiration, serenity\" }\n  ],\n  \"deck\": \"rider-waite\"\n}\n```\n\n### vedika_chinese_bazi\n\n```json\n{\n  \"system\": \"chinese\",\n  \"chart\": {\n    \"yearPillar\": { \"stem\": { \"name\": \"Geng\", \"chinese\": \"庚\", \"element\": \"Metal\", \"polarity\": \"Yang\" }, \"branch\": { \"name\": \"Wu\", \"chinese\": \"午\", \"animal\": \"Horse\", \"element\": \"Fire\", \"polarity\": \"Yang\" }, \"label\": \"Geng Wu\" },\n    \"monthPillar\": { \"stem\": { \"name\": \"Ren\", \"chinese\": \"壬\", \"element\": \"Water\", \"polarity\": \"Yang\" }, \"branch\": { \"name\": \"Wu\", \"chinese\": \"午\", \"animal\": \"Horse\", \"element\": \"Fire\", \"polarity\": \"Yang\" }, \"label\": \"Ren Wu\" },\n    \"dayPillar\": { \"stem\": { \"name\": \"Xin\", \"chinese\": \"辛\", \"element\": \"Metal\", \"polarity\": \"Yin\" }, \"branch\": { \"name\": \"Hai\", \"chinese\": \"亥\", \"animal\": \"Pig\", \"element\": \"Water\", \"polarity\": \"Yin\" }, \"label\": \"Xin Hai\" },\n    \"hourPillar\": { \"stem\": { \"name\": \"Yi\", \"chinese\": \"乙\", \"element\": \"Wood\", \"polarity\": \"Yin\" }, \"branch\": { \"name\": \"Wei\", \"chinese\": \"未\", \"animal\": \"Goat\", \"element\": \"Earth\", \"polarity\": \"Yin\" }, \"label\": \"Yi Wei\" },\n    \"dayMaster\": { \"name\": \"Xin\", \"chinese\": \"辛\", \"element\": \"Metal\", \"polarity\": \"Yin\" },\n    \"dominantElement\": \"Water\",\n    \"elementBalance\": { \"Wood\": 1, \"Fire\": 2, \"Earth\": 1, \"Metal\": 2, \"Water\": 2 }\n  }\n}\n```\n\n### vedika_compatibility (type: \"guna-milan\")\n\n```json\n{\n  \"totalScore\": 26,\n  \"maxScore\": 36,\n  \"recommendation\": \"Good match\",\n  \"factors\": [\n    { \"name\": \"Varna\", \"score\": 1, \"maxScore\": 1, \"description\": \"Spiritual compatibility\" },\n    { \"name\": \"Vashya\", \"score\": 2, \"maxScore\": 2, \"description\": \"Mutual attraction\" },\n    { \"name\": \"Tara\", \"score\": 3, \"maxScore\": 3, \"description\": \"Birth star compatibility\" },\n    { \"name\": \"Yoni\", \"score\": 3, \"maxScore\": 4, \"description\": \"Physical compatibility\" },\n    { \"name\": \"Graha Maitri\", \"score\": 5, \"maxScore\": 5, \"description\": \"Mental compatibility\" },\n    { \"name\": \"Gana\", \"score\": 5, \"maxScore\": 6, \"description\": \"Temperament\" },\n    { \"name\": \"Bhakoot\", \"score\": 7, \"maxScore\": 7, \"description\": \"Health & wealth\" },\n    { \"name\": \"Nadi\", \"score\": 0, \"maxScore\": 8, \"description\": \"Genetic compatibility\" }\n  ],\n  \"mangalDosha\": { \"male\": false, \"female\": true, \"compatible\": true }\n}\n```\n\n### vedika_panchang (element: \"full\")\n\n```json\n{\n  \"date\": \"2026-03-13\",\n  \"vara\": { \"name\": \"Friday\", \"deity\": \"Shukra\" },\n  \"tithi\": { \"name\": \"Krishna Chaturdashi\", \"deity\": \"Shiva\", \"endTime\": \"2026-03-13T18:45:00+05:30\" },\n  \"nakshatra\": { \"name\": \"Purva Bhadrapada\", \"lord\": \"Jupiter\", \"endTime\": \"2026-03-13T22:10:00+05:30\" },\n  \"yoga\": { \"name\": \"Siddha\", \"endTime\": \"2026-03-13T15:30:00+05:30\" },\n  \"karana\": { \"name\": \"Vanija\", \"endTime\": \"2026-03-13T18:45:00+05:30\" },\n  \"sunrise\": \"06:28:00+05:30\",\n  \"sunset\": \"18:22:00+05:30\"\n}\n```\n\n### vedika_ai_chat\n\n```json\n{\n  \"response\": \"Based on your birth chart, Jupiter is currently transiting your 7th house...\",\n  \"conversationId\": \"conv_abc123\",\n  \"tokens\": { \"input\": 1250, \"output\": 480 },\n  \"cost\": 0.012,\n  \"system\": \"vedic\"\n}\n```\n\n### vedika_predictions (period: \"daily\")\n\n```json\n{\n  \"sign\": \"aries\",\n  \"period\": \"daily\",\n  \"date\": \"2026-03-13\",\n  \"prediction\": {\n    \"overall\": \"A favorable day for career decisions...\",\n    \"career\": \"Professional growth opportunities emerge...\",\n    \"love\": \"Venus influence brings harmony...\",\n    \"health\": \"Focus on physical activity...\",\n    \"finance\": \"Avoid impulsive spending...\"\n  },\n  \"luckyNumber\": 7,\n  \"luckyColor\": \"Red\"\n}\n```\n\n### vedika_western_transits (type: \"aspects\")\n\n```json\n{\n  \"transitAspects\": [\n    {\n      \"transitPlanet\": \"Saturn\",\n      \"transitSign\": \"Pisces\",\n      \"transitDegree\": 22.5,\n      \"natalPlanet\": \"Moon\",\n      \"natalSign\": \"Gemini\",\n      \"natalDegree\": 24.1,\n      \"aspect\": \"Square\",\n      \"orb\": 1.6,\n      \"applying\": true,\n      \"influence\": \"challenging\"\n    }\n  ]\n}\n```\n\n### vedika_usage (action: \"wallet\")\n\n```json\n{\n  \"walletBalance\": 5456,\n  \"currency\": \"USD\",\n  \"displayBalance\": \"$54.56\",\n  \"plan\": \"professional\",\n  \"subscriptionEndDate\": \"2026-04-01T00:00:00Z\"\n}\n```\n\n> **Note:** `walletBalance` is in USD cents. Divide by 100 to display as dollars.\n\n---\n\n## Error Handling\n\nAll errors are returned as MCP tool errors with descriptive messages:\n\n| Status | Meaning | Message Example |\n|--------|---------|-----------------|\n| 400 | Invalid input | `Bad Request: datetime is required` |\n| 401 | Bad API key | `Invalid API key. Get one at https://vedika.io/pricing -- format: vk_live_*` |\n| 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. |\n| 403 | Inactive sub | `Subscription inactive or endpoint not included in your plan.` |\n| 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. |\n| 422 | Idempotency key refused | `IDEMPOTENCY_NOT_SUPPORTED`: the endpoint does not take a key and no charge was attempted; send again without `idempotencyKey`. |\n| 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. |\n| Timeout | Too slow | `Request timed out after 30s -- /v2/astrology/kundli` |\n\n### Timeout Configuration\n\n| Request Type | Timeout | Retries |\n|-------------|---------|---------|\n| AI chat (`vedika_ai_chat`) | 90s | No retry (already long) |\n| POST computation endpoints | 30s | 1 retry on 5xx only with an `idempotencyKey`; none otherwise |\n| GET endpoints | 15s | 1 retry on 5xx |\n\n---\n\n## Pricing\n\nNo 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](https://vedika.io/sandbox).\n\n| Plan | Price | Wallet Credits/mo | Rate Limit |\n|------|-------|-------------------|------------|\n| Starter | $12/mo | $12 | 60 req/min |\n| Professional | $60/mo | $60 | 120 req/min |\n| Business | $120/mo | $120 | 300 req/min |\n| Enterprise | $240/mo | $240 | 600 req/min |\n\nGet your API key at [vedika.io/pricing](https://vedika.io/pricing).\n\n---\n\n## Technical Details\n\n- **Runtime**: Node.js 20+\n- **Transport**: stdio (MCP standard)\n- **Dependencies**: `@modelcontextprotocol/sdk`, `zod` (zero other runtime deps)\n- **HTTP**: Native `fetch` (no axios)\n- **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.\n- **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.\n- **Timeouts**: AI chat 90s, POST computation 30s, GET endpoints 15s\n- **Module format**: This package is ESM-only (`\"type\": \"module\"`). Running it\n  via `npx`/the `vedika-mcp-server` bin (the normal MCP-client setup above)\n  works regardless of your own project's module format. If you instead import\n  it as a library from a CommonJS project, plain `require('@vedika-io/mcp-server')`\n  will throw — use a dynamic import instead:\n  ```js\n  const { VedikaApiClient } = await import('@vedika-io/mcp-server');\n  ```\n\n## Links\n\n- [API Documentation](https://vedika.io/docs)\n- [API Reference](https://vedika.io/api-reference)\n- [Pricing](https://vedika.io/pricing)\n- [Dashboard](https://vedika.io/dashboard)\n- [MCP Server Page](https://vedika.io/mcp)\n- [Support](mailto:support@vedika.io)\n\n## License\n\nMIT\n\n### Vastu jobs and artifacts\n\nCall `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.\n\nUse `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.\n",
  "bytes": 23982,
  "sha": "29900cc0bdd0bd8af9835bfb376b60142f8f2c0139cb6462f70bd5f519c169c5",
  "repo_slug": "vedika-io/vedika-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/mcp_io_github_vedika_io_vedika_mcp_server_a9ebb3c5/readme"
}