Skip to main content
Glama
HellenicStar Astrology MCP Server

HellenicStar Astrology MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
AMAP_KEYNo可选高德查询由部署者提供自己的 AMAP_KEY
MCP_SOURCE_URLNo公开部署须设置的源码地址
MCP_ALLOWED_HOSTSNo默认只允许 localhost / 127.0.0.1
MCP_LOCATION_DB_PATHNo选择离线地名库的路径

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Use the current tool schemas. Call a clearly requested tool directly with the user's supported parameters; get_capabilities and recommend_workflow are optional discovery aids, not prerequisites. Read get_agent_protocol when you need selection, verification or output-scope rules. Answer conceptual questions without chart calls. For unclear life questions, clarify the actual topic and missing data in everyday language. Interpret negation and background context before choosing tools; carry out all explicitly requested techniques. recommend_workflow is a keyword-based technique directory, not a general language interpreter: use a known goal key or an unambiguous supported technique, and keep the user's time scope and data/image requirements. Resolve its candidates from the conversation when possible; ask only about remaining ambiguity, rather than presenting the entire directory. For focused relationship discussion, select needed top-level fields with include (for initial contact inspection: contacts and counts), then fetch further context as needed. Full research requests retain detail_level=full with include omitted; preserve every explicitly chosen method and orb. Check output completeness from concrete evidence: explicit client truncation notices, omitted_array_items or missing requested data. Generic verification guidance mentioning truncation is not such a notice. Report the scope actually received; status=ok alone does not establish complete receipt. Only calculate a natal chart when the user supplies an exact birth date and time. Search for the birthplace, or call resolve_birth_coordinates for WGS84 coordinates. Use the returned location_id for all chart tools. Follow search next_action: use_location_id proceeds; ask_user requires a choice unless that exact ID was already confirmed. Never guess a missing time or a daylight-saving fold. When required_fields or clarification is returned, ask the user for those values and retry; never invent missing minutes or a solar-return location. If no house system is specified, use Placidus and disclose it; preserve any explicit supported choice. Offer a different supported system without blocking calculation. Fixed method rules, including whole-sign annual profections, remain explicit. Reuse choices already explicitly supplied by the user, without asking again. For natal interpretations, first call calculate_natal_chart and keep its fact_reference unchanged. Before presenting the interpretation, submit its natal sign, house, retrograde and aspect assertions as structured claims with exact draft quotes to verify_natal_claims. Correct contradicted claims and identify unverified claims. The verifier checks only the submitted structured facts, not the wording, omitted claims or psychological interpretation; never describe a whole report as verified. For all other data interpretations, keep calculation_reference unchanged and call verify_calculation_claims with the draft facts and exact source paths. Correct conflicts and reverify. Never use validation_failed results. Present the returned data as astronomical chart data, not predictions. Use render_natal_chart for a full wheel, or render_jones_pattern for the Jones distribution ring, only when requested. Timing tools return period tables for one reference date (as_of, YYYY-MM-DD); describe them as traditional time-lord techniques, never as guaranteed events.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_birthplaceA

Search birthplace candidates and return canonical location IDs, regions and timezones. If supplied by the user, include country/state as City, Country or City, State, Country. One exact database-name match within an explicitly supplied verified region uses next_action=use_location_id; use it and state the selected city without asking again. next_action=ask_user means unresolved candidates: ask for the missing region or city/district choice, unless that exact location_id was already confirmed. Never choose by population or list order. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

resolve_birth_coordinatesA

Resolve WGS84 decimal latitude and longitude into a reusable location_id and IANA timezone. Use this when the user gives coordinates instead of a city; then pass location_id to any natal, timing, relationship or chart tool. Daylight-saving offset is calculated later from the birth date and local time. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_natal_chartA

Calculate a tropical natal chart data table from an exact local birth date and time and a selected location_id. Choose placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus houses. If a repeated civil time is ambiguous, ask the user to choose fold 0 or 1 and call again. Do not guess an unknown birth time. For any natal interpretation, REQUIRED NEXT STEP before the final answer: call verify_natal_claims with this result's unchanged fact_reference and the draft's sign, house, retrograde and aspect claims. Correct contradicted claims and identify unverified ones before presenting the interpretation. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_natal_structure_graphA

Calculate a deterministic natal structure graph from an exact civil birth time and selected location_id. Includes traditional and modern dispositor paths with ten origins, cycles, receptions, aspects, motifs, both house systems, conditions and dependencies. No ranking. For configurable classical-seven attention candidates call calculate_natal_salience. Partial graphs explicitly mark unavailable houses and axes. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_natal_salienceA

Extract rule-based natal priorities when the user needs candidate focus groups with source evidence. Use calculate_natal_structure_graph for the complete unselected relationship graph, or calculate_natal_chart for positions and houses. Requires exact local birth date/time and a confirmed location_id. Returns focus_selection, all ten planet_profiles, relationship_views separating dignity dependencies from direct aspects, state evidence, reading groups and source_graph; jones_view and view_comparison retain Jones as a separate perspective that does not select natal priorities. Missing house/axis layers remain explicit as partial availability. Broad selections are allowed: no global importance score, forced single core, psychological inference or remedy verdict. Reception criteria and bounded aspect dynamics describe calculated conditions, not efficacy or unlimited perfection. Scope, rulers and orbs are explained in the input fields. Detailed selection rules and version history: docs/natal-salience.md. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

render_natal_chartA

Render the existing natal chart wheel as a 720px PNG shown to the user. Requires an exact birth date, local time and selected location_id; supports placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. Ask about ambiguous civil time instead of guessing fold. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate.

render_jones_patternA

Render a 720px PNG Jones distribution ring: ten planetary glyphs, occupied fans, true-longitude dots, gap, angles and focus points, with pattern and boundary status. Use for the whole-chart distribution visual; use render_natal_chart for a standard natal wheel or calculate_classical_factors for Jones classification alongside classical factors. Requires exact local birth date/time and confirmed birthplace location_id. Boundary cases are not a unique psychological diagnosis. Returns an inline MCP PNG after calculating and validating its source; no prior calculation call is required. stdio has no public image URL and the client must support image content. Missing inputs return needs_clarification without an image; invalid inputs or unavailable rendering return an error without an image.

calculate_classical_factorsA

Calculate natal sect, essential dignities and condition tags, sect-light triplicity lords, Fortune/Spirit, lunar phase and Jones classification. Use for classical factors; use calculate_natal_chart for positions/houses, calculate_natal_structure_graph for dispositor and aspect relationships, calculate_natal_salience for candidate focus groups, or calculate_lots for selected lot formulas. Requires exact local birth date/time, confirmed birthplace location_id with optional house_system (default placidus); missing birth inputs return needs_clarification. Returns structured factors, not interpretation. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_zodiacal_releasingA

Zodiacal releasing (Valens, 360-day years) from the Lot of Fortune and Lot of Spirit. Returns all level-1 periods, the level-2 periods inside the level-1 period containing as_of, and the level-3 periods inside the current level-2 period, with peak and loosing-of-the-bond markers. as_of defaults to today. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_time_lordsA

Calculate Firdaria and annual profections for as_of: major periods through the configured age-100 horizon, sub-periods within the active major period, and profection years from one year before to three years after the current year, clipped to the available report. Use calculate_zodiacal_releasing for releasing from Fortune/Spirit instead. Requires exact local birth date/time, confirmed birthplace location_id with optional house_system (default placidus); missing birth prerequisites return needs_clarification. Annual profections always advance one whole sign per year; house_system selects natal placement of the year lord, not a different time-lord sequence. Firdaria periods are independent of house system. Returns timing tables and lords, not event predictions. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_solar_arcA

Calculate true solar-arc directions over an age interval: directed-point/axis contacts, the hard-aspect matrix with exact dates, and directed positions at wheel_age. Use for solar-arc timing; choose calculate_secondary_progressions for day-for-year progressions, calculate_transits_to_natal for actual transits, or render_solar_arc_biwheel for an image. Requires exact local birth date/time and a confirmed birthplace location_id; omitted prerequisites return needs_clarification. Defaults to a five-year window on either side of the selected wheel age, clipped to ages 0-80. Returns calculation data, not event predictions. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_transits_to_natalA

Exact transits of Jupiter, Mars, Saturn, Uranus, Neptune and Pluto to the natal chart between from_date and to_date (YYYY-MM-DD, at most 3 years). target_scope: all, axes or points. IMPORTANT: axes include conjunctions (0 degrees) ONLY; other axis aspects are not supported. Points use the listed major aspects. Empty axis events do not mean no other axis aspects. Optional planet: jupiter, mars, saturn, uranus, neptune or pluto. Returns every exact contact in the requested interval, including intermediate retrograde repeats; contact reports the index/total in its contact series. Times are given in UTC and birthplace local time. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_timeline_synthesisA

Data-only multi-technique timeline: choose target_year for calendar years OR start_date (YYYY-MM-DD) for 1–3 rolling years from that birthplace-local date, using span_years (default 1) in either mode. Never send both. For future one year, resolve today to an explicit date in the birthplace timezone and pass start_date; do not substitute a calendar year. End is exclusive on the anniversary; Feb 29 clamps to Feb 28. settings.query_range declares actual local/UTC bounds; progressed background and active periods are computed at that start. Includes active Firdaria and Zodiacal Releasing L1/L2 periods; progressed Sun/Moon sign ingresses and planetary hard aspects to natal planets/axes; Jupiter through Pluto major aspects to ten natal planets and conjunctions only to natal axes. aspect_windows reports transit and progression orb intervals, including active intervals without an exact hit; unknown entry/exit boundaries are null with explicit search limits. progressed_context supplies the phase at query start and progressed lunar phase transitions. Exact transit events retain all repeated contacts and series IDs. reading_windows and exact_contacts deduplicate equivalent axis endpoint records while preserving raw indices; window_overlaps explains same-target or direct natal-aspect links with actual interval intersections. concurrent_segments lists simultaneously active windows without inferring shared themes. natal_context supplies both house systems, traditional/modern direct house rulers and existing ten-planet major natal aspects within 6 degrees. reading_layers gives a project-defined background/window/exact-contact order, not importance scores or a Forrest algorithm. Fast transits are not added. Raw resonances retain their separate legacy rule; use the new views for axis-deduplicated reading. Events have UTC/local timestamps; resonances only group matching points across at least two techniques within 30 days, not psychological themes or window overlaps. No predictive interpretations. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

get_transit_snapshotA

Get calculation data for transiting planets and their active aspects to one natal chart at a single moment, including orb, orb limit and applying status where available. Use calculate_transits_to_natal for exact event dates over a range, render_transit_biwheel for an image, or calculate_sky_chart for a chart without natal comparison. Requires exact local birth date/time and confirmed birthplace location_id; missing birth inputs return needs_clarification. This is a snapshot within configured orbs, not an exact-event search or a prediction. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_saturn_jupiter_cyclesA

Saturn and Jupiter cycles over the natal angles: exact conjunctions with ASC, IC, DSC and MC, Saturn-Jupiter aspects, the quadrant phases of each planet, and the current position in each cycle on as_of (default today). max_age 1-120, default 80. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_house_ingressesA

Find dates when transiting Saturn or Jupiter enters a natal Placidus house, including retrograde re-entries, within birth to age 84. Use for house-boundary crossings; use calculate_saturn_jupiter_cycles for natal-axis cycles, calculate_transits_to_natal for aspects to natal points, or get_transit_snapshot for one moment. Requires exact local birth date/time and confirmed birthplace location_id; missing inputs return needs_clarification. Returns event_count and events with entered/left house, entry type and UTC/local times. Date filters do not extend the lifetime horizon. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_progressed_lunationA

Calculate the secondary progressed Sun-Moon lunation cycle: current and next phase on as_of, eight 45-degree phases, and a timeline through age 100 with progressed positions and transiting Saturn natal-house context. Use for progressed lunar phases; use calculate_secondary_progressions for broader progressed positions and contacts, or get_current_sky for actual sky positions. Requires exact local birth date/time and confirmed birthplace location_id. Missing birth inputs return needs_clarification. Returns calculation data, not life-event predictions. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_solar_returnA

Solar return chart for target_year: exact return moment, chart positions, angles, cusps and aspects, overlay with the natal chart, and monthly progressed return Moon contacts. Explicit residence_location_id (from search_birthplace) is required; use the birthplace ID only when the user chooses it. house_system: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

render_solar_return_chartA

Render a 720px PNG solar-return wheel for target_year. Use for the return chart image; use calculate_solar_return for the exact return moment, chart data and natal overlay, or render_lunar_return_chart for a lunar return. Requires exact local birth date/time, birthplace location_id, target_year, explicit residence_location_id and house_system. The residence is the user-chosen return location; never silently reuse the birthplace. Returns an inline MCP PNG after calculating and validating its source; no prior calculation call is required. stdio has no public image URL and the client must support image content. Missing inputs return needs_clarification without an image; invalid inputs or unavailable rendering return an error without an image. Supported house systems: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate.

calculate_lunar_returnA

Lunar return chart for target_year and target_month in the residence's civil calendar: exact return moment, chart positions, angles, cusps, aspects, and natal overlay. Explicit residence_location_id (from search_birthplace) is required; house_system: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. target_day selects the nearer return if two occur in one month. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

render_lunar_return_chartA

Render the lunar return chart as a 720px PNG wheel shown to the user. Same inputs as calculate_lunar_return. Supported house systems: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate.

calculate_secondary_progressionsA

Secondary progressions (Day-for-a-Year) chart: progressed planets, angles, natal aspects and lunation phase. Specify as_of or age; angle_progression_method defaults to naibod, or choose solar_arc_in_ra. Supported house systems: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

render_secondary_progressions_chartA

Render secondary progressions as a 760px bi-wheel PNG shown to the user (natal inside, progressed outside). Same inputs as calculate_secondary_progressions. Supported house systems: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate.

calculate_relationship_chartsA

Calculate geometric charts for two exact births: synastry aspects, reciprocal selected-system house overlays, midpoint composite, composite-to-natal aspects and shared house patterns. Use for chart data or composite positions; use calculate_relationship_observation for contacts with natal context and observation paths, calculate_davison_chart for a time-space midpoint chart, or render_composite_chart for a composite image. orb_profile: greene (default) or tight. Seven house systems are supported. Composite quadrant cusps use corresponding cusp midpoints; whole-sign/equal houses are constructed from the midpoint Ascendant, with independent midpoint MC. This is not the ARMC/reference-place composite method. No compatibility score. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_relationship_observationA

For a focused question, use include to request needed top-level fields (for initial contact inspection: contacts and counts), then fetch further context as needed. For explicitly requested complete research data, keep detail_level=full and omit include; full remains the default. A successful calculation does not guarantee that a client received an untruncated result. John Green relationship observation v0.14. mode=synastry requires two exact births; mode=natal accepts person_a alone or both people and computes natal profiles without cross-contacts. All natal points remain available, including untriggered points. sort_by=orb (default), relationship_indicators or natal_hard_aspects changes display order only. Human notes use prepare_relationship_observation_note separately. Returns unique cross-contacts, two observation paths per contact, one-hop natal context, supported bounded natal aspect configurations (including Chiron), actual contact links between both natal configurations, static natal priority background under its separately disclosed policy, directed house overlays and factual indicators. Configuration memberships and natal identities never add direct contacts. observation_review provides evidence-backed indicator, inner/outer and tightness reasons with parallel lenses, never a weighted score or inferred client difficulty. structure_display folds contained configurations and bridges while keeping every raw row and partial overlap. natal_observation_candidates records source-backed selection reasons even without partner contacts. review_paths links actual contact endpoints, one-hop natal context, house rulers and overlays without propagating activation. overlay_contexts preserves target ownership; observation_comparisons groups reciprocal contacts and both natal backgrounds without scoring. observation_complexes separately groups conjunction-pair neighborhoods and named-pattern conjunction satellites, including axis endpoint variants, without recursive expansion or whole-complex activation claims. Shared natal planet pairs and exact descendant-sign correspondences are factual comparisons, not semantic matches. Relationship-indicator sorting uses target-point selection roles. scenario_observation_lenses attaches source-backed topics, conditions and actual point/house references to each selected context; this is not a planet whitelist or psychological interpretation. Optional unconfirmed conditions must not be asserted as client facts. Reuse an explicitly stated relationship context; if unknown, ask the user before calling. The legacy love default is not evidence of user confirmation. No composite, scores or psychological flags. Axis endpoint equivalents share one contact. john_green profile uses 10 degrees for conjunction/square/trine/opposition and 5 degrees for tight display. Sextiles are not evaluated unless sextile_orb_degrees (0-10) is supplied; minor aspects require include_minor_aspects=true and explicit minor_orbs_degrees keys 30/45/135/150; overlapping orb windows are rejected. Yod context requires explicit 60 and 150 degree orbs. Optional include_timing=true requires timing with one of at (offset-aware ISO timestamp), date (YYYY-MM-DD), or month (YYYY-MM) with optional month_part (early/middle/late), or event=childbirth with explicit family parent/child roles, plus explicit transit_orbs_degrees and progression_orbs_degrees. Timing provides a selected-instant snapshot. Optional timing.window_start and window_end (offset-aware ISO timestamps) request a numerical interval search, with a duration from one second to 31 days and the snapshot inside [start,end). window_scan returns exact events and clipped orb windows over every supported point pair, including pairs absent at the snapshot. It reuses source engines and root refinement; interval mesh and bounds are engineering rules. Simultaneous synastry endpoint windows require the same transit and actual interval overlap, not merely two hits somewhere in the date range. Non-instant dates are illustrative UTC-noon samples with fast transits excluded; early/middle/late means calendar days 1-10/11-20/21-end and samples day 5/15/25. These boundaries and sample times are engineering conventions, not known meeting times or interval scans. The timing dictionary also accepts angle_progression_method (naibod default or solar_arc_in_ra) and include_progressed_synastry (boolean, default true). When progressed synastry is enabled, progressed_synastry_comparison compares natal geometry with the selected progressed pair under the same progression_orbs_degrees. It distinguishes same/different aspect and presence on only one side; a node-convention mismatch is marked not comparable. Existing wide-orb static contacts are contextual references, not the comparison baseline. This does not infer first appearance, duration, relationship outcome or internal progressed configurations. No inherited 10-degree timing orbs. Childbirth resolves the child birth through the existing timezone/fold resolver and exposes parental contacts as references, not extra evidence. Natal nodes are verified mean nodes despite legacy field names; childbirth uses mean nodes throughout. Explicit-date timing retains its true transit/progressed nodes and discloses the different natal convention in node_conventions. Timing requires synastry mode and preserves static counts, and links existing contacts and bounded natal contexts without predictions. See timing_observations and its availability limits. relationship_context accepts additional_types, caller-supplied a/b roles (parent/child, siblings, supervisor/employee, colleagues), and cohabiting. Roles must match a selected family/work type. Optional creative_project and early_or_sibling_like_friendship accept true/false/null, require work/friendship respectively, and never infer context. Conditional DSC/seventh-house topics retain actual houses. observation_complex_links references each contact once with both owners core/context memberships, including axis/Yod complexes; no pair-product expansion. Parallel traditional/modern ruler backgrounds and special contact lenses do not add contacts or weights. Missing layers remain explicit, including in summary results. See docs/relationship-observation.md. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

prepare_relationship_observation_noteA

Prepare a human observation note for caller-owned storage. Requires an unchanged calculate_relationship_observation calculation_reference, person a/b and an explicitly supplied human statement. Optionally link to a natal point and question ID. Recomputes the source anchor only; does not verify the statement, infer answers, diagnose, persist notes or change calculation facts/counts. Never invent client reports.

render_composite_chartA

Render the midpoint composite chart of two people as a 720px PNG wheel. Use for geometric midpoint positions; use calculate_relationship_charts for structured composite/synastry data or render_davison_chart for a physical time-space midpoint chart. Supply two complete BirthInput objects with exact local birth dates/times and separately confirmed birthplace IDs. This chart does not score compatibility or predict relationship outcomes. Returns an inline MCP PNG after calculating and validating its source; no prior calculation call is required. stdio has no public image URL and the client must support image content. Missing inputs return needs_clarification without an image; invalid inputs or unavailable rendering return an error without an image. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate.

calculate_davison_chartA

Davison relationship chart (time-space midpoint chart) for two people with exact birth data: calculates the real physical midpoint in time (UT) and geographic coordinates, casting an independent chart with its own real axes, houses and planetary positions. Supports placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus; orb_profile: greene (default) or tight. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

render_davison_chartA

Render the Davison relationship chart (time-space midpoint chart) of two people as a 720px PNG wheel shown to the user. Same inputs as calculate_davison_chart. Supported house systems: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate.

calculate_relocation_chartA

Relocation chart: recalculates ascendant, midheaven and house cusps for a new residence location while keeping the exact natal birth moment (UT) and planetary longitudes unchanged. relocation_location_id (from search_birthplace) is required; house_system: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus (default: placidus). House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

render_relocation_chartA

Render the relocation chart as a 720px PNG wheel shown to the user. Same inputs as calculate_relocation_chart. Supported house systems: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate.

get_current_skyA

Sky at one moment, with no birthplace or geographic location required: lunar phase, Moon sign, void-of-course window, lunations/eclipses, retrograde planets, stations and aspects. moment is ISO 8601 with an offset; defaults to now. include=retrograde_planets returns only planets retrograde at that moment and their next direct station; stations_today covers only that Beijing calendar day. This is not a complete annual retrograde calendar. For a yearly request, explain this limit or verify each boundary from actual dated results; do not ask for a city or switch to a house chart merely to get station dates. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_house_rulersA

Calculate house-ruler dispositor chains for all twelve houses, with traditional and modern tracks, chart ruler and angular/succedent/cadent crosses. Use for house-based rulership paths; use calculate_natal_structure_graph for the wider relationship graph or calculate_classical_factors for dignities. Supply exact local birth date/time, a confirmed birthplace location_id with optional house_system (default placidus). Missing birth prerequisites return needs_clarification; do not infer them. Both rulership tracks are returned regardless of house system. Data only; no psychological interpretation. Supported house systems: placidus, whole_sign, equal, koch, regiomontanus, porphyry, campanus. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_zodiacal_releasing_l4A

Level-4 zodiacal releasing periods inside one level-3 period. Call calculate_zodiacal_releasing first, then pass lot (fortune or spirit) plus the exact start date and sign key of the chosen level-3 period, for example parent_start 2026-08-24 and parent_sign GEMINI. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_lifetime_transit_summaryA

Lifetime transit overview from birth to age 84 in twelve seven-year chapters: how many exact transit hits fall in each chapter, split by planet, by slow or fast group, and by axis or planet target. Use calculate_transits_to_natal for the dated events. This scan takes about half a minute. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_aspect_windowsA

Planet-to-planet aspects in orb at one moment, each with how long it stays within orb, how much has elapsed and how much remains. An explicit location_id is required because this result includes the Lot of Fortune and Lot of Spirit. moment is ISO 8601 with a timezone offset; defaults to now. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

calculate_sky_chartA

A full chart cast for any moment and place rather than for a birth: planets, selected-system houses, axes, aspects, aspect patterns, lunar phase and planetary motion including retrograde shadow periods. moment is ISO 8601 with a timezone offset; defaults to now. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

render_sky_chartA

Render a 720px PNG tropical wheel in the selected house system for one moment and selected place, with chart positions calculated to minute precision. No birth data is needed. Use calculate_sky_chart for structured chart data, get_current_sky for sky positions without local houses, or render_transit_biwheel to compare the sky with a natal chart. Requires confirmed location_id; moment defaults to now. Returns an inline MCP PNG after calculating and validating its source; no prior calculation call is required. stdio has no public image URL and the client must support image content. Missing inputs return needs_clarification without an image; invalid inputs or unavailable rendering return an error without an image. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate.

render_transit_biwheelA

Render a PNG biwheel with natal positions inside, transiting planets outside and cross-chart aspects at one moment. Use get_transit_snapshot for structured positions/aspects, calculate_transits_to_natal for exact event dates over a range, or render_sky_chart for a standalone sky wheel. Requires exact local birth date/time and confirmed birthplace location_id; moment selects the transit instant, not a second birth. Returns an inline MCP PNG after calculating and validating its source; no prior calculation call is required. stdio has no public image URL and the client must support image content. Missing inputs return needs_clarification without an image; invalid inputs or unavailable rendering return an error without an image.

render_solar_arc_biwheelA

Render a PNG biwheel with natal positions inside and true solar-arc directed positions outside. Use for a visual at one age; use calculate_solar_arc for event tables or render_transit_biwheel for actual transits. Requires exact local birth date/time and a confirmed birthplace location_id. age takes precedence over the age derived from as_of; the selected age must be 0-80. Returns an inline MCP PNG after calculating and validating its source; no prior calculation call is required. stdio has no public image URL and the client must support image content. Missing inputs return needs_clarification without an image; invalid inputs or unavailable rendering return an error without an image.

render_saturn_jupiter_cyclesA

Render a 1200x660 PNG panorama of lifetime Saturn/Jupiter angle crossings, with event labels and a reference-age indicator. Use this for a visual overview; use calculate_saturn_jupiter_cycles for exact event tables and cycle data, or calculate_house_ingresses for entries into houses. Requires exact local birth date/time and a confirmed location_id; person_name is only a display label. Returns an inline MCP PNG and cycle summary after calculating and checking its source. stdio provides no public image URL; image display requires client support. Missing or invalid birth inputs return an input error without an image; unavailable rendering returns render_failed. The window starts at birth and ends at max_age (default 80, allowed 1-120). Wave height is geometry, not life quality or an event prediction.

verify_natal_claimsA

Verify natal sign, house, retrograde and aspect assertions against a fresh server calculation. Copy fact_reference unchanged from calculate_natal_chart; submit each assertion with its exact draft quote. Returns supported, contradicted or unverified plus source fields. Unsupported facts, other chart types and psychological interpretations are unverified. Quote text is echoed, not parsed: this does not validate an entire report or detect omitted claims. Fix contradicted claims before answering.

verify_calculation_claimsA

Verify source-field claims from any registered calculation: classical/Jones roles, transits, directions, returns, relationship, time lords, releasing, sky and locations. Copy calculation_reference unchanged; submit exact JSON Pointer paths and values from the draft. Use complete flat event/role row objects to preserve planet, time and chart context. Use scalar values, scalar lists, flat row objects or lists of flat rows. For a nested object containing arrays (such as settings), submit separate exact paths for its scalar fields and scalar lists instead of the whole object. Server recomputes and checks the source before comparison. Fix contradicted claims and reverify; mark unverified claims. This checks submitted field values, NOT prose semantics, missing claims, psychological explanations or independent algorithm correctness.

calculate_lotsA

Calculate Hellenistic and Arabic lots on demand. Returns name, longitude, sign, house, formula and day/night reversal info. Seven house systems select placement only; longitude formulas and sect do not change. A noncomputed house_placidus comparison is null. Filter with lots=['fortune', 'spirit', 'eros', 'marriage_male', 'mother', ...]. Data only, no psychological interpretation. House-system policy: reuse an explicitly chosen supported system; otherwise default to placidus. Do not block for an unspecified house system. Disclose house_system_notice to the user and offer recalculation in another supported system if wanted; method-specific rules remain separate. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

scan_planetary_aspectsA

Find exact aspects or orb entry/exit windows between two moving sky bodies across a date range. No birth data or location is needed. Use calculate_transits_to_natal for a moving planet against fixed natal points; use calculate_aspect_windows for all active pairs at one moment, including location-dependent lots. Returns event_count and events, windows or year_summary according to mode/precision. Tropical geocentric apparent Swiss Ephemeris; nodes are mean unless explicitly true. Cycle IDs and hit indices are query-local, not universal numbering. See docs/planetary-aspect-scan.md. Server checks run before successful results are returned. Before interpreting this data, call verify_calculation_claims with its unchanged calculation_reference and draft source-field claims. Correct contradicted facts and reverify before the final answer. Psychological interpretations are not checked. Optional detail_level=summary previews object/nested rows (up to five), preserves complete scalar membership lists, and marks truncation; include selects top-level content fields. Omit both for the original full result. Verification references always identify the complete checked calculation.

get_capabilitiesA

Discover current tools, input schemas, registered algorithm provenance and versions from the live registry. Use when available tools or parameters are unclear. If the needed tool and its current schema are already available, call it directly; this lookup is optional.

get_agent_protocolA

Read the current HellenicStar agent protocol: tool selection, missing-input handling, provenance limits, source-fact verification and interpretation boundaries. The same text is available as an MCP resource and prompt.

recommend_workflowA

Optional keyword-based directory of supported calculation workflows. Skip when the requested tool is clear or the question is conceptual. Interpret the user's language, negations and background first; submit a known goal key such as relationship_observation or an unambiguous technique phrase. Preserve the requested time scope and data/image output. For multiple requested techniques obtain each route separately. Unknown goals return the whole directory, not a requirement to show every option to the user. Resolve candidates from the conversation; ask only if ambiguity remains. status=ok selects a route, not input readiness: check required_information against existing confirmed data. Image-only routes use renderers directly. This tool does not understand arbitrary language, calculate or manage dialogue.

Prompts

Interactive templates invoked by user choice

NameDescription
hellenicstar_agent_protocolUse the current HellenicStar MCP agent protocol.

Resources

Contextual data attached and managed by the client

NameDescription
chart-wheel
agent-protocol

TDQS

A3.9/5.0

Scored across 48 tools

Disambiguation3/5

Most tools target distinct astrological techniques, but several clusters overlap enough to require careful reading: sky tools (calculate_sky_chart, get_current_sky, calculate_aspect_windows, scan_planetary_aspects) and relationship tools (calculate_relationship_charts, calculate_relationship_observation, calculate_davison_chart). The very detailed descriptions and cross-references help, but with 48 tools the boundaries are not always immediately obvious.

Naming Consistency5/5

Tool names consistently use snake_case with an action verb first: calculate_*, render_*, get_*, verify_*, search_*, resolve_*, scan_*, recommend_*, prepare_*. The pattern is predictable throughout despite the large surface.

Tool Count2/5

At 48 tools the surface is very heavy, well above the typical 3-15 range. While the astrology domain is broad and many tools are specialized, the many calculate/render pairs and niche techniques make the set feel overgrown rather than tightly scoped.

Completeness5/5

The server covers natal charts, returns, transits, progressions, solar arc, relationship charts, time lords, zodiacal releasing, lots, classical factors, sky charts, location resolution, rendering, and source verification. No obvious lifecycle or domain gap is apparent for the stated purpose.

Maintenance

ActivityNo data
ResponsivenessOutdated data