Birthstar Vedic Astrology MCP

io.github.amarpathak由 GitHub 账号 amarpathak 发布v1.29.1更新于 Oct 28, 2026

30 Vedic Jyotish tools: natal charts, dashas, yogas, nakshatras. Swiss Ephemeris.

已验证Streamable HTTP可网页运行位置与生活数据与分析

概览

AI 生成的概览

远程 MCP 服务器,提供 30 个吠陀占星工具,可根据出生数据计算本命盘、大运、瑜伽与月宿。

可以做什么
  • 创建与查看星盘:计算本命盘并以 chart_id 缓存,再读取其元数据与内容清单
  • 读取盘面细节:行星位置、宫位、盘角与特殊拉格纳、分盘、五要素历、瑜伽、相位、指示星、状态、力量与八分法点数
  • 时间推演:当前大运、完整大运序列、转折点时间线与当前行运
  • 关系与审查:两张盘的 36 分合婚、古典煞星检查、恒星合相、数字命理与一次性出生月宿查询
  • 账户与诊断:账户方案与星盘额度、引擎健康检查、会话用量指标与建议问题提示库
适用场景
适合让助手根据出生信息生成并解释吠陀占星分析,包括大运时间、合婚与煞星问题,而无需在本地运行占星引擎。
运行要求
需要远程 streamable HTTP 端点;未声明任何包、环境变量或请求头。星盘工具需要出生日期、时间与地点。部分工具受账户方案与星盘额度限制。
安装前请注意
服务器会报告方案与剩余星盘额度,使用可能计费或受限。当事人及合婚中第二人的出生信息会发送至第三方服务。寿命输出被标注为实验性,不可用于预测。创建星盘会在服务器端缓存数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Birthstar Vedic Astrology MCP,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.amarpathak%2Fbirthstar/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "birthstar-vedic-astrology": {
      "type": "http",
      "url": "https://mcp.birthstar.ai/mcp"
    }
  }
}

工具

30

create_chart

Compute a full Vedic natal chart and cache it, returning a short handle. Call this FIRST. It returns a `chart_id` plus a small summary. Pass that chart_id to the other tools (get_grahas, get_houses, get_current_dasha, get_panchanga, get_yogas) to read specific parts of the chart without recomputing it. Args: dob: Date of birth, YYYY-MM-DD (proleptic Gregorian). tob: Time of birth, HH:MM or HH:MM:SS, 24-hour, local to `tz`. tz: IANA timezone name (e.g. "Asia/Kolkata") or fixed offset "+05:30". lat: Latitude in decimal degrees, North positive. lon: Longitude in decimal degrees, East positive. ayanamsha: Sidereal zero-point — lahiri, raman, kp, true_chitra, yukteshwar, or fagan_bradley. house_system: whole_sign, sripati, equal, placidus, or kp. node_type: "true" or "mean" lunar nodes. transit_date: YYYY-MM-DD the "now" questions are answered against — which dasha is running, where the transits are, whether Sade Sati is active. Defaults to today *in `tz`*, not in UTC, so a caller in Asia/Kolkata at 01:00 local gets their own date rather than the previous one. Set it to ask about another date; a chart made yesterday still answers as of yesterday. Returns the chart_id and the headline placements (birth star, moon sign, ascendant) — not the full document, which is far too large to return.

输入参数tz必填dob必填lat必填lon必填tob必填ayanamshanode_typehouse_systemtransit_date

get_grahas

Get planetary positions for a cached chart. Args: chart_id: Handle returned by create_chart. planets: Optional list of names to fetch (e.g. ["Moon", "Saturn"]). Defaults to the 9 classical grahas. Also accepts the outer bodies Uranus, Neptune, Pluto, Ceres, Pallas, Juno, Vesta, Chiron. detail: "basic" (default) or "full". Full adds the KP sub-lord and sub-sub-lord, navamsa sign, compound friendships, avasthas, gandanta/pushkara flags, natural karaka and daily motion. Per planet: sign, degrees, nakshatra + pada + lord, house (whole-sign), retrograde flag, and dignity state (exalted/debilitated/own/friend/etc).

输入参数detailplanetschart_id必填

get_houses

Get the 12 houses (bhavas) for a cached chart. Args: chart_id: Handle returned by create_chart. method: "whole_sign" (default) — sign, lord, lord placement, karaka, occupants. "bhava_chalit" — Sripati/Porphyry cusps with degree spans, which can place a planet in a different house than whole-sign does. "kp_cusps" — Placidus cusps with sub-lords. Always includes an `analysis` block: each planet's functional nature for this ascendant (benefic/malefic/mixed by the houses it rules), plus the Baadhaka and Maraka houses and lords.

输入参数methodchart_id必填

get_current_dasha

Get the currently-running dasha periods for a cached chart. Returns the active lord at every nested level (Maha -> Antar -> Pratyantar -> Sukshma -> Prana) for each dasha system the engine computed, with the ISO start/end dates of each period. NOTE: "current" is evaluated against the transit date baked into the chart when it was computed, not against today's date at call time.

输入参数chart_id必填

get_dasha_periods

Walk the dasha tree — list periods at any level, past or future. Use this for "when does my next antardasha start", "what runs after this mahadasha", "when was I in Jupiter". get_current_dasha only tells you what is running now; this gives you the whole sequence. Args: chart_id: Handle returned by create_chart. system: vimshottari (default), yogini, ashtottari, or chara_jaimini. within: Drill down by naming the enclosing lords, outermost first. None (default) lists the mahadashas. ["Sun"] lists the antardashas inside the Sun mahadasha. ["Sun", "Mercury"] lists the pratyantardashas inside that antardasha. Chara Jaimini is keyed by rashi name rather than graha. Each period carries lord, ISO start/end, duration in years, and whether it is the one currently running.

输入参数systemwithinchart_id必填

get_timeline

Get the turning points between two dates — dasha changes and slow-planet ingresses. This is the two-clocks view: the dasha sequence counted from birth (which theme is switched on) against gochara, the real sky on that date (the trigger). Use it for "what happens in the next five years", "when does this period change", "when does Saturn cross my Moon". get_dasha_periods answers when one clock changes; this answers when both point at the same thing. Every date is exact, bisected against the ephemeris to the day — not a sampled approximation. Args: chart_id: Handle returned by create_chart. The birth data is reused; the range below is independent of the chart's transit_date. start_date: YYYY-MM-DD, inclusive. end_date: YYYY-MM-DD, after start_date. systems: Dasha systems to include — vimshottari, yogini, ashtottari, chara_jaimini. Defaults to all four. Antardasha changes are reported for vimshottari only; the rest give mahadashas. types: Restrict to dasha_change, ingress and/or sade_sati. Defaults to all three. include_samples: Add a periodic strip showing the running dasha chain and Saturn/Jupiter position between the events. Off by default and capped at 13 rows, one year of months — for one date in full detail use get_transits. The event list is shorter when it is on. step: Spacing of that strip — month, quarter or year. Ignored unless include_samples is set. Returns the events, the natal anchors they are counted from, and the standing Sade Sati state at start_date. A range with more turning points than fit in one response is truncated **explicitly**, with the date to resume from — it is never silently shortened.

输入参数steptypessystemschart_id必填end_date必填start_date必填include_samples

get_lagna_points

Get the chart angles, special lagnas, Arudha padas and Bhrigu Bindu. Beyond the ascendant: MC/IC/Descendant/Vertex, the time-based special lagnas (Bhava/Hora/Ghati/Sree/Indu), the Jaimini Arudha padas (AL, A2-A12, Upapada) and Bhrigu Bindu. Special lagnas whose rate is school-divergent are reported under `not_computed` with a reason rather than guessed.

输入参数chart_id必填

get_panchanga

Get the birth panchanga (the five limbs of the Vedic calendar). Returns tithi (lunar day + paksha), vara (weekday), nakshatra, yoga, and karana at the moment of birth, plus the lunar month and season.

输入参数chart_id必填

get_yogas

Get the yogas (classical planetary combinations) present in a chart. Only yogas whose rule actually tested true are listed, each with the rule that matched. An empty list is a real result — it means none of the implemented yogas are present in this chart, not that the check was skipped.

输入参数chart_id必填

get_varga

Get one divisional chart (varga) from a cached chart. Args: chart_id: Handle returned by create_chart. varga: Which divisional chart, e.g. "D9" (navamsa), "D10" (dashamsa), "D11", "D60". See describe_chart -> varga_coverage for the full list of what this engine computes and what it deliberately does not. Returns the varga ascendant and each planet's sign in that chart. Where a varga's counting scheme diverges between schools, the scheme actually used is reported in `method` — do not assume it matches your tradition.

输入参数vargachart_id必填

get_vimsopaka

Get Vimsopaka bala — each planet's dignity-weighted strength across the 16 vargas. Use this to answer "which planets are strong across the divisional charts?" A planet in its own or exalted sign in all sixteen scores the full 20. Returns the score, the ceiling actually applicable, and an interpretive band. The score is the classical quantity; the band labels are a convention laid over it and are tagged as such.

输入参数chart_id必填

get_strengths

Get Shadbala, Bhava Bala and Ishta/Kashta phala — how strong each planet and house is. Call this for "which planet is strongest", "is Saturn strong enough", or "which houses are weak". Shadbala is the six-fold Parasari strength; a planet meets expectation when `ratio` >= 1. Read `ratio` (>= 1 means the planet clears its own bar) and `rank_by_ratio` when saying a planet is strong or weak; the summary's `meets_requirement` lists every planet that qualifies. Each planet has its own `required_rupa`, so plain `rank` (absolute `total_rupa`) frequently disagrees: a planet can clear its own bar and still rank low overall. Use `strongest_by_ratio` / `weakest_by_ratio` for interpretation; the bare `strongest` / `weakest` keys are absolute-rupa based and kept only for backward compatibility. Args: chart_id: Handle returned by create_chart. detail: "summary" (default) gives totals, both ranks, ratio and Ishta/Kashta per planet. "full" adds the six sub-bala breakdowns and is several times larger — ask for it only when the components matter. Ishta phala is benefic capacity, Kashta phala malefic; they are derived from Shadbala, not independent measurements.

输入参数detailchart_id必填

get_ashtakavarga

Get Ashtakavarga bindus — the point-score each sign carries, used for transit strength. Call this for "is this a good sign for Saturn to transit" or "which signs are strongest overall". Sarvashtakavarga (SAV) sums the seven planetary charts; the classical pre-reduction total is always 337. Args: chart_id: Handle returned by create_chart. planet: Restrict the per-planet (Bhinna) charts to one graha. include_sodhana: Add the trikona/ekadhipatya reductions and Shodhya Pinda. Off by default — it roughly triples the response.

输入参数planetchart_id必填include_sodhana

get_aspects

Get planetary and sign aspects — who is looking at which house. Graha drishti is the Parasari planetary aspect (everything aspects the 7th; Mars, Jupiter, Saturn and the nodes have special aspects). Rasi drishti is the Jaimini sign aspect, a different system — do not merge the two. Args: chart_id: Handle returned by create_chart. planet: Restrict graha drishti to one graha. include_argala: Add Argala and Virodhargala (Jaimini intervention). Off by default — it roughly doubles the response.

输入参数planetchart_id必填include_argala

get_karakas

Get the Chara (Jaimini) karakas plus Karakamsa and Swamsa. The Atmakaraka — the planet at the highest degree in its sign — is the single most-used significator in Jaimini analysis. Returns the whole ladder in descending degree order, plus the natural (naisargika) karakas. Note Rahu's degrees are counted in reverse, so its `effective_degrees` will differ from its actual position.

输入参数chart_id必填

get_transits

Get gochara — where the planets are now relative to the natal chart. Answers "is Sade Sati running", "is Jupiter transiting well", "is today favourable". Houses are counted from BOTH the natal Moon (the classical reference for gochara) and the natal Lagna. IMPORTANT: transits are computed for the chart's `as_of` date, which is the transit_date it was created with — not today unless the chart was created today. Pass transit_date to create_chart to ask about another date.

输入参数chart_id必填

get_day_periods

Get sunrise/sunset and the auspicious/inauspicious windows of the BIRTH day. Rahu kala, Yamaganda, Gulika kala, Abhijit and Brahma muhurta, plus true sunrise/sunset, day length and whether the birth was by day. IMPORTANT: these are the windows for the DATE OF BIRTH, not for today. This tool cannot answer "when is Rahu kala today" — that needs a chart created for today's date.

输入参数chart_id必填

get_avasthas

Get planetary avasthas — the maturity, alertness and mood states of each graha. Baladi is the age state (infant..dead) and scales a planet's ability to deliver. Jagradadi is awake/dreaming/sleeping. Deeptadi is the mood from exaltation down to combustion. Two further ladders, lajjitadi and sayanadi, are deliberately NOT computed — their conditions are school-divergent — and are reported as deferred rather than guessed.

输入参数planetschart_id必填

get_fixed_stars

Get conjunctions between the grahas and named prominent fixed stars. Returns only real conjunctions within the configured orb, plus what was scanned. An empty `conjunctions` list is a provable negative, not a skipped check — `planets_scanned` and `stars_scanned` show the search that ran.

输入参数chart_id必填

get_longevity

Get Ayurdaya (longevity) estimates — EXPERIMENTAL, not for predictive use. The engine computes Pindayu and Nisargayu, but flags the whole section experimental: the classical methods are textually divergent and the reduction rules are only partially applied. The disclaimer is returned with the numbers and must be passed on to the reader, not dropped. Do not present these as a lifespan prediction.

输入参数chart_id必填

get_compatibility

Calculate 36-point Ashta-Kuta Guna Milan compatibility between two charts. Evaluates all 8 classical Parashari Kutas (Varna, Vashya, Tara, Yoni animal intimacy, Graha Maitri, Gana, Bhakoot, and Nadi) plus a Kuja Dosha (Manglik) mutual cross-audit between Person 1 and Person 2.

输入参数chart_id_1必填chart_id_2必填

get_doshas

Audit classical Vedic doshas: Kuja Dosha (Manglik), Kaal Sarp, Gandanta, Pitre. Evaluates Mars placements from Lagna, Moon, and Venus with 8 classical cancellation exceptions, 12 Kaal Sarp variants, Gandanta junctions, and Pitre dosha indicators.

输入参数chart_id必填

get_numerology

Calculate Chaldean Name Numerology and Vedic Date of Birth numbers. Calculates Name Number (compound + root), Birth Number (Mulank), Destiny Number (Bhagyank), ruling planetary archetypes (Swami Grahas), and harmonic resonance.

输入参数dobname必填

get_prompt_library

Fetch curated high-value prompt templates and multi-tool question workflows. Call this tool whenever you want to suggest high-value questions to the user, or when the user asks "what can you do?", "what should I ask?", or wants guided astrology workflows (e.g. Sade Sati analysis, timeline forecast, dasha transitions, chart strength, school comparisons, timing windows). Args: category: Optional category filter. One of 'all', 'Core Reading', 'Timing & Transits', 'Career & Wealth', 'Strengths & Accuracy', 'Relationships', 'Daily & Remedies'. Names are matched case-insensitively; an unrecognised one is an error listing the valid names, never a silent empty result. include_full_templates: Set to True to retrieve the full expanded prompt text. Defaults to False for compact workflow titles and tool chains. Returns a structured catalog of prompt templates with their titles, descriptions, required arguments, and which underlying tools they chain.

输入参数categoryinclude_full_templates

describe_chart

Get metadata and an inventory of what a cached chart contains. Useful for orienting before drilling in: returns the birth data and config it was computed with, the top-level sections available in the document, and how many fields the engine honestly marked as deferred or uncomputable.

输入参数chart_id必填

rectify_birth_time

Test how much a recorded birth time can actually be narrowed, and against what. Two modes: * **No events** — scans the uncertainty window and reports how many genuinely distinct charts it contains, what differs between them, and what does not. Use this FIRST to find out whether rectification is even worth attempting. * **With events** — scores each candidate against dated life events and checks the result against a null model of randomised dates. This tool does NOT return "your real birth time is X", and you should not present it that way. The unit of the answer is the **variant** — a group of minutes producing an identical chart structure. Preferring one minute over its neighbour inside a variant is fitting arithmetic, not evidence. Read `verdict.usable` before quoting anything else. Fewer than three independent, well-dated events fits the events rather than the birth time, and the verdict will say so. Args: dob, tob, tz, lat, lon: Birth data, as for create_chart. `tob` is the centre of the window, not an assertion. events: Dated life events, e.g. [{"date": "2015-06", "type": "job_change"}, {"date": "2019-03", "type": "marriage"}]. Dates may be YYYY-MM or YYYY-MM-DD. See `event_types` in the error response for the accepted vocabulary. half_width_minutes: Half-width of the uncertainty window (max 120). step_minutes: Candidate spacing in minutes. ayanamsha: Sidereal zero-point. Costs one full chart computation per candidate, with a minimum of 20 per call — a 30-minute window at 1-minute steps is 61 charts and takes a few seconds. The floor means a very narrow window is not cheaper than one considered call, which is deliberate: probing repeatedly is the wrong way to use this. On the shared public demo a single call is capped at 61 candidates; the refusal names two smaller

输入参数tz必填dob必填lat必填lon必填tob必填eventsayanamshastep_minuteshalf_width_minutes

get_account_status

Check the calling account's plan, remaining chart credits, and what is gated. Call this BEFORE attempting a tool that might be refused, not after. It is to subscription limits what describe_chart is to chart sections: the index you consult to find out what is reachable, so a paywall is something you can plan around rather than something you discover by hitting it. `credits_remaining` is the number of chart *computations* left this month — reading a chart you already created costs nothing, so the count falls only when new astronomy is calculated. `gated_tools` lists what the current plan cannot reach, and is empty on a paid plan.

无需输入参数。

health_check

Check whether this server is correctly configured and computing accurately. Reports the ephemeris mode actually in use, engine versions, and cache state. Call this when chart positions look wrong or disagree with another source: the usual cause is a missing ephemeris directory, which degrades the engine to an approximation without failing. `status` is "ok" when the Swiss ephemeris is complete, "degraded" when the engine is running on the Moshier fallback.

无需输入参数。

server_stats

Get usage metrics for this server session: calls, latency, errors, payload size. Per tool: call count, p50/p95/max latency, average and peak response size, and how many responses exceeded the payload budget. Plus cache hit rate and a breakdown of errors by type. Counters are per-process and reset when the client restarts the server.

无需输入参数。

calculate_birth_star

Compute just a person's Vedic birth star (nakshatra) and core anchors. A one-shot shortcut: use this when the birth star is the whole question. If you expect follow-up questions about the same person's chart, prefer create_chart, which caches the full chart behind a reusable handle. Args: dob: Date of birth, YYYY-MM-DD (proleptic Gregorian). tob: Time of birth, HH:MM or HH:MM:SS, 24-hour. tz: IANA timezone name (e.g. "Asia/Kolkata") or fixed offset "+05:30". lat: Latitude in decimal degrees, North positive. lon: Longitude in decimal degrees, East positive. ayanamsha: Sidereal zero-point. Default lahiri. Returns the birth star (Moon's nakshatra), its pada and ruling planet, the Moon sign, the ascendant, and the Sun's nakshatra.

输入参数tz必填dob必填lat必填lon必填tob必填ayanamsha

版本历史

1
  1. v1.29.1最新Sep 16, 2026

评分

已满足适用检查项的 83%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证不适用

    托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。