Astral Code

Calculate birth charts, relationship aspects, and Moon phases in English or Spanish.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
89%
Naming quality
95%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,260Tokens (tool definitions)
~2.6 KBTypical response size
Moderate attention impact (0.98% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "astral-code": {
      "url": "https://astralcode.app/api/mcp"
    }
  }
}

Remote endpoints

https://astralcode.app/api/mcpstreamable-http

What it can do

Tool inventory

Tools (4)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢find_birth_locations(query, locale)

Find city coordinates and IANA timezone for a birth chart. Ask the user to choose if multiple places match. Do not invent coordinates or silently choose another city.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "description": "Conversation language. Default en."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}
🟢calculate_birth_chart(birth, locale)

Calculate a tropical Placidus natal chart, Big Three, positions and aspects from user-provided birth details. Resolve the city first. Ask for missing details; never guess birth time. Returns a chart here and an optional link to continue on Astral Code. Astrology is symbolic reflection, not a prediction of events.

Input Schema

{
  "type": "object",
  "properties": {
    "birth": {
      "type": "object",
      "properties": {
        "birth_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Local birth date, YYYY-MM-DD, between 1900 and today."
        },
        "birth_time": {
          "type": "string",
          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
          "description": "Local clock time HH:MM. Omit when unknown; never guess."
        },
        "unknown_time": {
          "type": "boolean",
          "description": "True when the user does not know their birth time. No Ascendant or houses will be returned."
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180
        },
        "timezone": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "IANA timezone from find_birth_locations, not a current UTC offset."
        },
        "birthplace": {
          "type": "string",
          "minLength": 1,
          "maxLength": 160
        }
      },
      "required": [
        "birth_date",
        "unknown_time",
        "latitude",
        "longitude",
        "timezone",
        "birthplace"
      ],
      "additionalProperties": false
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "description": "Conversation language. Default en."
    }
  },
  "required": [
    "birth"
  ],
  "additionalProperties": false
}
🟢compare_birth_charts(person_a, person_b, locale)

Calculate synastry aspects between two user-provided birth charts. Use for relationship dynamics, communication and affinity, not a compatibility verdict or a prediction of marriage. Resolve both locations first. Unknown times exclude Moon contacts and houses.

Input Schema

{
  "type": "object",
  "properties": {
    "person_a": {
      "type": "object",
      "properties": {
        "birth_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Local birth date, YYYY-MM-DD, between 1900 and today."
        },
        "birth_time": {
          "type": "string",
          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
          "description": "Local clock time HH:MM. Omit when unknown; never guess."
        },
        "unknown_time": {
          "type": "boolean",
          "description": "True when the user does not know their birth time. No Ascendant or houses will be returned."
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180
        },
        "timezone": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "IANA timezone from find_birth_locations, not a current UTC offset."
        },
        "birthplace": {
          "type": "string",
          "minLength": 1,
          "maxLength": 160
        }
      },
      "required": [
        "birth_date",
        "unknown_time",
        "latitude",
        "longitude",
        "timezone",
        "birthplace"
      ],
      "additionalProperties": false
    },
    "person_b": {
      "type": "object",
      "properties": {
        "birth_date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Local birth date, YYYY-MM-DD, between 1900 and today."
        },
        "birth_time": {
          "type": "string",
          "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
          "description": "Local clock time HH:MM. Omit when unknown; never guess."
        },
        "unknown_time": {
          "type": "boolean",
          "description": "True when the user does not know their birth time. No Ascendant or houses will be returned."
        },
        "latitude": {
          "type": "number",
          "minimum": -90,
          "maximum": 90
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180
        },
        "timezone": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80,
          "description": "IANA timezone from find_birth_locations, not a current UTC offset."
        },
        "birthplace": {
          "type": "string",
          "minLength": 1,
          "maxLength": 160
        }
      },
      "required": [
        "birth_date",
        "unknown_time",
        "latitude",
        "longitude",
        "timezone",
        "birthplace"
      ],
      "additionalProperties": false
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "description": "Conversation language. Default en."
    }
  },
  "required": [
    "person_a",
    "person_b"
  ],
  "additionalProperties": false
}
🟢get_moon_phase(date, locale)

Calculate geocentric Moon phase, illumination and tropical lunar sign on a date at 12:00 UTC, or at the current instant if date is omitted. Not a local moonrise forecast or medical timing advice.

Input Schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional YYYY-MM-DD, 1900–2100. Evaluated at noon UTC."
    },
    "locale": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ],
      "description": "Conversation language. Default en."
    }
  },
  "required": [],
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded4 tools