Skip to content

Astrology Forecast MCP Server by RoxyAPI

by roxyapi.com · remote · no sign-in to list tools · v1.0.1 · published by com.roxyapi

Astrology transit forecasts, timelines and significant-date feeds for AI agents.

Changes · 5

5 tools: 5 change things.

Scanned Oct 21, 2026

5 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http forecast https://roxyapi.com/mcp/forecast --header 'X-API-Key: <your-x-api-key>'

Findings

Matches of fixed checks, with the text they matched.

5 warn
  • The server marks "post_forecast_timeline" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_timeline" says "post": a word for a change.

    What this check looks for
  • The server marks "post_forecast_transits" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_transits" says "post": a word for a change.

    What this check looks for
  • The server marks "post_forecast_significant_dates" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_significant_dates" says "post": a word for a change.

    What this check looks for
  • The server marks "post_forecast_digest" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_digest" says "post": a word for a change.

    What this check looks for
  • The server marks "post_forecast_solar_return" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_solar_return" says "post": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

5 tools

Changes things 5Claude Code: ask
  • post_forecast_digestRoll the cross-domain forecast for a single birth subject into four pre-summarized windows: the next 24 hours, 7 days, 30 days, and 90 days from the start date.1 finding

    Why it is in this group

    • The name "post_forecast_digest" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "post_forecast_digest" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_digest" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Roll the cross-domain forecast for a single birth subject into four pre-summarized windows: the next 24 hours, 7 days, 30 days, and 90 days from the start date. Each window returns its event count, a per-domain count breakdown, a per-type count breakdown, and the top highest-significance events. Built for a glanceable what-is-coming strip so a caller can render the upcoming highlights without scanning the full event list.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • post_forecast_significant_datesReturn only the high-significance dates from the merged cross-domain forecast for a single birth subject: the rare outer-planet exact transit aspects, slow-planet sign ingresses, r…1 finding

    Why it is in this group

    • The name "post_forecast_significant_dates" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "post_forecast_significant_dates" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_significant_dates" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Return only the high-significance dates from the merged cross-domain forecast for a single birth subject: the rare outer-planet exact transit aspects, slow-planet sign ingresses, retrograde stations, and Vimshottari mahadasha and antardasha changes that mark genuine turning points. Defaults to a significance floor of 70 so the response is a short list of the most meaningful upcoming dates. Built for what-is-coming highlights, timing alerts, and at-a-glance forecast strips.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • post_forecast_solar_returnCast the solar return chart for one subject and year: the chart erected for the exact moment the transiting Sun returns to its natal ecliptic longitude, the foundational technique …1 finding

    Why it is in this group

    • The name "post_forecast_solar_return" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "post_forecast_solar_return" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_solar_return" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Cast the solar return chart for one subject and year: the chart erected for the exact moment the transiting Sun returns to its natal ecliptic longitude, the foundational technique for annual astrological forecasting. Returns the full tropical chart with planetary positions, house cusps, aspects, Ascendant, and Midheaven. Location-sensitive: pass the birthplace to anchor the chart to natal geography, or the current city for a relocated solar return where the houses and Ascendant shift to where you are on your birthday. Built for year-ahead forecast tools, birthday charts, and annual horoscope features.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • post_forecast_timelineBuild one time-ordered forecast for a single birth subject by merging upcoming events across three domains: western transit-to-natal aspects, sign ingresses, retrograde stations, e…1 finding

    Why it is in this group

    • The name "post_forecast_timeline" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "post_forecast_timeline" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_timeline" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Build one time-ordered forecast for a single birth subject by merging upcoming events across three domains: western transit-to-natal aspects, sign ingresses, retrograde stations, eclipses, and new and full moons; biorhythm critical days; and vedic Vimshottari mahadasha, antardasha, and pratyantardasha boundaries. The window is clamped to 90 days and events are capped and scored by significance. Built for what-is-coming dashboards, daily and weekly forecast feeds, and timing tools.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • post_forecast_transitsForecast the western astrology events for a single birth chart over a window up to 90 days: every transit-to-natal major aspect refined to its exact instant, every transiting plane…1 finding

    Why it is in this group

    • The name "post_forecast_transits" says "post": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "post_forecast_transits" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false}; The name "post_forecast_transits" says "post": a word for a change.

      What this check looks for
    Description, as the server wrote it
    Forecast the western astrology events for a single birth chart over a window up to 90 days: every transit-to-natal major aspect refined to its exact instant, every transiting planet sign ingress, every retrograde or direct station, every solar and lunar eclipse, and every New and Full Moon. Returns a time-ordered, significance-scored timeline. Built for astrology forecast feeds, transit alerts, and timing tools.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http forecast https://roxyapi.com/mcp/forecast --header 'X-API-Key: <your-x-api-key>'

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [],
    "ask": [
      "mcp__forecast__post_forecast_timeline",
      "mcp__forecast__post_forecast_transits",
      "mcp__forecast__post_forecast_significant_dates",
      "mcp__forecast__post_forecast_digest",
      "mcp__forecast__post_forecast_solar_return"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as forecast. Review it before you use it.