Dev astroMCP Examples

Ready-to-use Dev astroMCP prompts and workflows.

Getting started with the workflow

Step 1: List available endpoints

Use dev.list_allowed to show me all available endpoints

Step 2: Get schema for an endpoint

Before calling an endpoint, understand its structure:

Use dev.get_schema:
- path: /ephemeris/natal-chart
- format: llm_v2

Step 3: Fetch a preset payload

Get a template to start with:

Use dev.fetch_lab_preset:
- preset_name: minimal

Step 4: Search docs for guidance

Find integration patterns and best practices:

Use dev.search_docs:
- query: "how to optimize natal chart for LLM agent"

Step 5: Execute the call

After confirming the format and payload, execute:

Use dev.call:
- method: POST
- path: /ephemeris/natal-chart
- body: { ... }

Natal charts

Simple natal chart

Use dev.call to calculate a natal chart:
- method: POST
- path: /ephemeris/natal-chart
- body: {
    "subject": {
      "name": "Example Person",
      "birth_datetime": { "iso": "1990-01-15T14:30:00" },
      "birth_location": {
        "latitude": { "decimal": 40.7128 },
        "longitude": { "decimal": -74.0060 },
        "timezone": { "iana_name": "America/New_York" }
      }
    }
  }

Full natal chart (LLM format)

Use dev.call:
- method: POST
- path: /ephemeris/natal-chart
- body: {
    "subject": {
      "name": "Example Person",
      "birth_datetime": { "iso": "1990-01-15T14:30:00" },
      "birth_location": {
        "latitude": { "decimal": 40.7128 },
        "longitude": { "decimal": -74.0060 },
        "timezone": { "iana_name": "America/New_York" }
      }
    },
    "output_schema": {
      "format": "llm_v2"
    }
  }

House system comparison

Use dev.call:
- method: POST
- path: /ephemeris/natal-chart
- body: {
    "subject": { ... },
    "configuration": {
      "house_system": "W"
    }
  }

House system codes: P, K, W, E, R, C, O.

Dignities

Use dev.call:
- method: POST
- path: /ephemeris/dignities
- body: {
    "datetime": { "iso": "1990-01-15T14:30:00" },
    "latitude": { "decimal": 40.7128 },
    "longitude": { "decimal": -74.0060 }
  }

Predictive astrology

Current transits

Use dev.call:
- method: POST
- path: /predictive/transit-chart
- body: {
    "transit_datetime": { "iso": "2026-01-24T12:00:00" },
    "transit_location": {
      "latitude": { "decimal": 40.7128 },
      "longitude": { "decimal": -74.0060 },
      "timezone": { "iana_name": "America/New_York" }
    }
  }

Solar return

Use dev.call:
- method: POST
- path: /predictive/returns
- body: {
    "natal_subject": {
      "birth_datetime": { "iso": "1990-01-15T14:30:00" },
      "birth_location": {
        "latitude": { "decimal": 40.7128 },
        "longitude": { "decimal": -74.0060 }
      }
    },
    "return_type": "solar",
    "return_year": 2026,
    "return_location": {
      "latitude": { "decimal": 40.7128 },
      "longitude": { "decimal": -74.0060 },
      "timezone": { "iana_name": "America/New_York" }
    }
  }

Transit search

Use dev.call:
- method: POST
- path: /predictive/transits/search
- body: {
    "transiting_body": "jupiter",
    "natal_point_degree": 15.5,
    "aspect_type": "conjunction",
    "search_start": { "iso": "2026-01-24T00:00:00" },
    "search_end": { "iso": "2026-12-31T23:59:59" },
    "timezone": { "iana_name": "America/New_York" }
  }

Sign ingresses

Use dev.call:
- method: POST
- path: /predictive/transits/sign-ingresses
- body: {
    "body": "mars",
    "start_date": { "iso": "2026-01-01T00:00:00" },
    "end_date": { "iso": "2026-12-31T23:59:59" },
    "timezone": { "iana_name": "America/New_York" }
  }

Relationship analysis

Synastry (two-person comparison)

Use dev.call:
- method: POST
- path: /comparative/synastry
- body: {
    "subject_a": {
      "name": "Person A",
      "birth_datetime": { "iso": "1990-01-15T14:30:00" },
      "birth_location": {
        "latitude": { "decimal": 40.7128 },
        "longitude": { "decimal": -74.0060 },
        "timezone": { "iana_name": "America/New_York" }
      }
    },
    "subject_b": {
      "name": "Person B",
      "birth_datetime": { "iso": "1992-06-20T10:15:00" },
      "birth_location": {
        "latitude": { "decimal": 34.0522 },
        "longitude": { "decimal": -118.2437 },
        "timezone": { "iana_name": "America/Los_Angeles" }
      }
    }
  }

Composite chart

Use dev.call:
- method: POST
- path: /comparative/composite
- body: {
    "subjects": [
      {
        "name": "Person A",
        "birth_datetime": { "iso": "1990-01-15T14:30:00" },
        "birth_location": {
          "latitude": { "decimal": 40.7128 },
          "longitude": { "decimal": -74.0060 }
        }
      },
      {
        "name": "Person B",
        "birth_datetime": { "iso": "1992-06-20T10:15:00" },
        "birth_location": {
          "latitude": { "decimal": 34.0522 },
          "longitude": { "decimal": -118.2437 }
        }
      }
    ],
    "method": "midpoint"
  }

Location and timezone

Autocomplete location

Use dev.call:
- method: GET
- path: /location/autocomplete
- query: {
    "query": "Paris, France",
    "limit": 5
  }

Reverse geocode

Use dev.call:
- method: GET
- path: /location/reverse
- query: {
    "latitude": 40.7128,
    "longitude": -74.0060
  }

Timezone lookup

Use dev.call:
- method: POST
- path: /timezone/lookup
- body: {
    "latitude": 40.7128,
    "longitude": -74.0060
  }

Advanced techniques

LLM-optimized output

Use dev.call:
- method: POST
- path: /ephemeris/natal-chart
- body: {
    "subject": { ... },
    "output_schema": {
      "format": "llm_v2"
    }
  }

Custom orbs

Use dev.call:
- method: POST
- path: /ephemeris/natal-chart
- body: {
    "subject": { ... },
    "configuration": {
      "aspect_orbs": {
        "conjunction": 8,
        "opposition": 8,
        "trine": 6,
        "square": 6,
        "sextile": 4
      }
    }
  }

Fixed star filters

Use dev.call:
- method: POST
- path: /ephemeris/natal-chart
- body: {
    "subject": { ... },
    "configuration": {
      "fixed_star_options": {
        "include": true,
        "orb": 1.0,
        "stars": ["Regulus", "Spica", "Antares", "Aldebaran"]
      }
    }
  }

Midpoints

Use dev.call:
- method: POST
- path: /ephemeris/midpoints
- body: {
    "datetime": { "iso": "1990-01-15T14:30:00" },
    "latitude": { "decimal": 40.7128 },
    "longitude": { "decimal": -74.0060 }
  }

Tips and best practices

Start with dev.list_allowed to confirm endpoints
Use dev.get_schema to understand request/response shapes before calling
Use dev.fetch_lab_preset to seed payloads with sample data
Use dev.search_docs to find integration patterns and guidance
Test payloads in Astro Lab before deploying to production
Use llm_v2 format for LLM integrations to reduce token usage
Cache natal chart results—they never change
Validate user input before calling the API