You're viewing a demo portfolio

Join the waitlist
PRSM

post_astrology_transit_aspects

Active

Tool of Western Astrology MCP Server by RoxyAPI

declared in 2.0.0

Calculate all transit-to-natal aspects with detailed interpretations, strength ratings, and timing guidance. Compares current (or future) planetary positions against your natal chart to identify active transits. Returns aspect type, orb, applying/separating status, narrative interpretation, impact rating, and practical guidance for each transit. Supports planet and aspect-type filtering. More detailed than the /transits endpoint — includes AI-friendly interpretation fields. Transit aspects API, transit-to-natal analysis, predictive astrology, personalized transit forecast.

Parameters schema

{
  "type": "object",
  "required": [
    "natalChart"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "tr",
        "de",
        "es",
        "hi",
        "pt",
        "fr",
        "ru"
      ],
      "type": "string",
      "default": "en",
      "example": "en",
      "description": "Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en. Languages without translations yet return English."
    },
    "compact": {
      "type": "boolean",
      "default": false,
      "description": "Set true to receive the exact same data in a token-optimized shape that is cheaper for you to read: whitespace is stripped and every array of same-shaped objects is encoded columnar as {\"__cols\":[field names],\"__rows\":[[values]]}, so each field name is sent once instead of once per row. Fully lossless (no field or value is dropped or changed) and typically 40 to 52 percent fewer tokens on large results. Prefer true whenever token or inference cost matters. Default false returns standard indented JSON."
    },
    "planets": {
      "type": "array",
      "items": {
        "enum": [
          "Sun",
          "Moon",
          "Mercury",
          "Venus",
          "Mars",
          "Jupiter",
          "Saturn",
          "Uranus",
          "Neptune",
          "Pluto",
          "North Node",
          "South Node",
          "Chiron",
          "Black Moon Lilith"
        ],
        "type": "string"
      },
      "description": "Filter to specific transiting planets. Omit to include all planets. Useful for focusing on slow-moving outer planet transits (Saturn, Jupiter, Pluto)."
    },
    "natalChart": {
      "type": "object",
      "required": [
        "date",
        "time",
        "latitude",
        "longitude",
        "timezone"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "example": "1990-07-15",
          "description": "Birth date in YYYY-MM-DD format. Determines planetary positions for the specific calendar day."
        },
        "time": {
          "type": "string",
          "format": "time",
          "example": "14:30:00",
          "description": "Birth time in 24-hour HH:MM:SS format. Determines the Ascendant (rising sign) and house cusps. Use 12:00:00 if unknown."
        },
        "latitude": {
          "type": "number",
          "example": 40.7128,
          "maximum": 90,
          "minimum": -90,
          "description": "Birth location latitude in decimal degrees (-90 to 90). Positive = North, negative = South."
        },
        "timezone": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 14,
              "minimum": -14
            },
            {
              "type": "string"
            }
          ],
          "example": -5,
          "description": "Timezone: IANA name (e.g. \"America/New_York\", \"Europe/London\") OR decimal hours from UTC (e.g. -5 for EST, 1 for CET). IANA strings are resolved to the DST-correct offset for the given date, so you can pass `cities[0].timezone` from /location/search directly."
        },
        "longitude": {
          "type": "number",
          "example": -74.006,
          "maximum": 180,
          "minimum": -180,
          "description": "Birth location longitude in decimal degrees (-180 to 180). Positive = East, negative = West."
        }
      },
      "description": "Natal chart birth details (date, time, location, timezone). Used to calculate natal planetary positions that transits are compared against."
    },
    "aspectTypes": {
      "type": "array",
      "items": {
        "enum": [
          "CONJUNCTION",
          "OPPOSITION",
          "TRINE",
          "SQUARE",
          "SEXTILE",
          "SEMI_SEXTILE",
          "QUINCUNX",
          "SEMI_SQUARE",
          "SESQUIQUADRATE"
        ],
        "type": "string"
      },
      "description": "Filter to specific aspect types (conjunction, opposition, trine, square, sextile, etc.). Omit to include all aspect types."
    },
    "minStrength": {
      "type": "number",
      "example": 50,
      "maximum": 100,
      "minimum": 0,
      "description": "Minimum aspect strength threshold (0-100). Higher values return only tighter, more potent aspects. Useful for filtering out wide-orb aspects."
    },
    "transitDate": {
      "type": "string",
      "format": "date",
      "example": "2026-02-03",
      "description": "Transit date in YYYY-MM-DD format. Defaults to current date if omitted. Use future dates for predictive transit analysis."
    },
    "transitTime": {
      "type": "string",
      "format": "time",
      "example": "12:00:00",
      "description": "Transit time in HH:MM:SS format. Defaults to 12:00:00 (noon) if omitted."
    }
  }
}

What this tool wraps· 0 endpoints

min confidence0.700.50

No endpoints wrapped at confidence ≥ 0.70.

Parent server

Western Astrology MCP Server by RoxyAPI

1/7 registries
View full server →