MysticAPI

Official6 toolsLive

by Latimer-Woods-Tech

Human Design & astrology engine: bodygraph, personal-sky SVG, today's sky. JPL ephemeris.

Captured live from the server via tools/list.

sky_today

Today's universal sky: which planets are retrograde right now, the current moon phase and illumination, geocentric positions for 13 bodies (zodiac sign + Energy Blueprint gate/line), and a 30-day forward scan of retrograde stations and new/full moons. No input. Deterministic astronomy (JPL-validated ephemeris). Costs 1 call.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

bodygraph

Compute an Energy Blueprint (Human Design) chart from a UTC birth instant. Returns type, authority, strategy, profile, definition, incarnation cross, channels, defined centers, and conscious/unconscious gate maps, plus a body-graph SVG. Location is NOT needed. Convert local birth time to UTC before calling. Costs 1 call.

Parameters

year	integer	required	4-digit year (UTC)
month	integer	required
day	integer	required
hour	integer	required	Hour 0–23 in UTC
minute	integer	required
second	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2200,
      "description": "4-digit year (UTC)"
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "day": {
      "type": "integer",
      "minimum": 1,
      "maximum": 31
    },
    "hour": {
      "type": "integer",
      "minimum": 0,
      "maximum": 23,
      "description": "Hour 0–23 in UTC"
    },
    "minute": {
      "type": "integer",
      "minimum": 0,
      "maximum": 59
    },
    "second": {
      "type": "integer",
      "minimum": 0,
      "maximum": 59,
      "default": 0
    }
  },
  "required": [
    "year",
    "month",
    "day",
    "hour",
    "minute"
  ]
}

sky_personal

Render a personal natal sky as an SVG from a UTC birth instant: each body placed on the wheel, retrogrades marked, fixed stars conjunct natal points lit. Deterministic (same birth → same sky). Convert local birth time to UTC before calling. Returns SVG markup. Costs 1 call.

Parameters

year	integer	required	4-digit year (UTC)
month	integer	required
day	integer	required
hour	integer	required	Hour 0–23 in UTC
minute	integer	required
second	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2200,
      "description": "4-digit year (UTC)"
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "day": {
      "type": "integer",
      "minimum": 1,
      "maximum": 31
    },
    "hour": {
      "type": "integer",
      "minimum": 0,
      "maximum": 23,
      "description": "Hour 0–23 in UTC"
    },
    "minute": {
      "type": "integer",
      "minimum": 0,
      "maximum": 59
    },
    "second": {
      "type": "integer",
      "minimum": 0,
      "maximum": 59,
      "default": 0
    }
  },
  "required": [
    "year",
    "month",
    "day",
    "hour",
    "minute"
  ]
}

ephemeris

Raw geocentric ecliptic positions for any instant (UTC): 13 bodies (Sun through Pluto, Chiron, lunar nodes) with longitude and retrograde flags. JPL-validated ephemeris (Meeus + Standish 1992). Costs 1 call.

Parameters

year	integer	required	4-digit year (UTC)
month	integer	required
day	integer	required
hour	integer	required	Hour 0–23 in UTC
minute	integer	required
second	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2200,
      "description": "4-digit year (UTC)"
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "day": {
      "type": "integer",
      "minimum": 1,
      "maximum": 31
    },
    "hour": {
      "type": "integer",
      "minimum": 0,
      "maximum": 23,
      "description": "Hour 0–23 in UTC"
    },
    "minute": {
      "type": "integer",
      "minimum": 0,
      "maximum": 59
    },
    "second": {
      "type": "integer",
      "minimum": 0,
      "maximum": 59,
      "default": 0
    }
  },
  "required": [
    "year",
    "month",
    "day",
    "hour",
    "minute"
  ]
}

numerology

Numerology profile from a birth date (UTC): Pythagorean life path (master numbers 11/22/33 preserved), birthday number, personal year/month/day cycles, and tarot birth card. Time fields are accepted but only the date matters. Costs 1 call.

Parameters

year	integer	required	4-digit year (UTC)
month	integer	required
day	integer	required
hour	integer	required	Hour 0–23 in UTC
minute	integer	required
second	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2200,
      "description": "4-digit year (UTC)"
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "day": {
      "type": "integer",
      "minimum": 1,
      "maximum": 31
    },
    "hour": {
      "type": "integer",
      "minimum": 0,
      "maximum": 23,
      "description": "Hour 0–23 in UTC"
    },
    "minute": {
      "type": "integer",
      "minimum": 0,
      "maximum": 59
    },
    "second": {
      "type": "integer",
      "minimum": 0,
      "maximum": 59,
      "default": 0
    }
  },
  "required": [
    "year",
    "month",
    "day",
    "hour",
    "minute"
  ]
}

relationship

Composite/connection chart for two people from their UTC birth instants: electromagnetic channels (chemistry), dominance, companionship, and compromise channels, combined definition, and type/authority/profile dynamics. Canonical Energy Blueprint (Human Design) relationship analysis. Costs 1 call.

Parameters

personA	object	required
personB	object	required

Raw schema

{
  "type": "object",
  "properties": {
    "personA": {
      "type": "object",
      "properties": {
        "year": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2200,
          "description": "4-digit year (UTC)"
        },
        "month": {
          "type": "integer",
          "minimum": 1,
          "maximum": 12
        },
        "day": {
          "type": "integer",
          "minimum": 1,
          "maximum": 31
        },
        "hour": {
          "type": "integer",
          "minimum": 0,
          "maximum": 23,
          "description": "Hour 0–23 in UTC"
        },
        "minute": {
          "type": "integer",
          "minimum": 0,
          "maximum": 59
        },
        "second": {
          "type": "integer",
          "minimum": 0,
          "maximum": 59,
          "default": 0
        }
      },
      "required": [
        "year",
        "month",
        "day",
        "hour",
        "minute"
      ]
    },
    "personB": {
      "type": "object",
      "properties": {
        "year": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2200,
          "description": "4-digit year (UTC)"
        },
        "month": {
          "type": "integer",
          "minimum": 1,
          "maximum": 12
        },
        "day": {
          "type": "integer",
          "minimum": 1,
          "maximum": 31
        },
        "hour": {
          "type": "integer",
          "minimum": 0,
          "maximum": 23,
          "description": "Hour 0–23 in UTC"
        },
        "minute": {
          "type": "integer",
          "minimum": 0,
          "maximum": 59
        },
        "second": {
          "type": "integer",
          "minimum": 0,
          "maximum": 59,
          "default": 0
        }
      },
      "required": [
        "year",
        "month",
        "day",
        "hour",
        "minute"
      ]
    }
  },
  "required": [
    "personA",
    "personB"
  ]
}

Install

Tools (6)

sky_todaybodygraphsky_personalephemerisnumerologyrelationship

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mysticapi.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mysticapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mysticapi.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.