Skip to main content
Glama
astroway-mcp

astroway-mcp

Official
by astroway

A*C*G by Life Category

astroway_geo_acg_by_category
Read-onlyIdempotent

Rank ACG astro-geography lines for a chosen life category by astrological weight or proximity to a point, returning curated interpretations in 11 languages.

Instructions

ACG lines that govern one area of life, ranked by astrological weight and, when a point is supplied, by proximity to it. Returns curated interpretation text per line in 11 languages.

[Group: Astro-Geography] [Endpoint: POST /v1/acg/by-category] [Cost: 50 credits (Tier 3)]

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "body": "<body>"
    },
    "name": "astroway_geo_acg_by_category"
  }
}

Input Schema

NameRequiredDescriptionDefault
bodyYesBirth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single house-system letter, P by default; a name such as "Placidus" is refused, and the case matters because I and i are two different Sunshine systems.

Output Schema

NameRequiredDescriptionDefault
countNo
linesNo
pointNo
categoryNo
languageNo
polarityNo
radiusDegNo
requestedLanguageNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv1.6.1
    • changedInput schema / properties / body / allOf
      Previous value: -[
      -  {
      -    "additionalProperties": {
      -      "anyOf": [
      -        {},
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      -    "properties": {
      -      "ayanamsa": {
      -        "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.",
      -        "enum": [
      -          "fagan-bradley",
      -          "lahiri",
      -          "de-luce",
      -          "raman",
      -          "krishnamurti",
      -          "kp",
      -          "yukteshwar",
      -          "jn-bhasin",
      -          "true-citra",
      -          "djwhal-khul"
      -        ],
      -        "type": "string"
      -      },
      -      "ayanamsaId": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "city": {
      -        "default": "",
      -        "type": "string"
      -      },
      -      "cosmogram": {
      -        "type": "boolean"
      -      },
      -      "date": {
      -        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      -        "type": "string"
      -      },
      -      "houseSystem": {
      -        "default": "P",
      -        "enum": [
      -          "P",
      -          "K",
      -          "R",
      -          "C",
      -          "E",
      -          "W",
      -          "B",
      -          "M",
      -          "O",
      -          "A",
      -          "T",
      -          "V",
      -          "D",
      -          "F",
      -          "G",
      -          "H",
      -          "I",
      -          "i",
      -          "L",
      -          "N",
      -          "Q",
      -          "S",
      -          "U",
      -          "X",
      -          "Y"
      -        ],
      -        "type": "string"
      -      },
      -      "latitude": {
      -        "maximum": 90,
      -        "minimum": -90,
      -        "type": "number"
      -      },
      -      "longitude": {
      -        "maximum": 180,
      -        "minimum": -180,
      -        "type": "number"
      -      },
      -      "name": {
      -        "default": "",
      -        "type": "string"
      -      },
      -      "time": {
      -        "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
      -        "type": "string"
      -      },
      -      "timezone": {
      -        "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.",
      -        "type": "string"
      -      },
      -      "timezoneOffset": {
      -        "anyOf": [
      -          {
      -            "maximum": 14,
      -            "minimum": -14,
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": 0,
      -        "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
      -      },
      -      "zodiacType": {
      -        "enum": [
      -          "tropical",
      -          "sidereal"
      -        ],
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "date",
      -      "time",
      -      "latitude",
      -      "longitude"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {
      -      "anyOf": [
      -        {},
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "properties": {
      -      "category": {
      -        "enum": [
      -          "adventure",
      -          "career",
      -          "communication",
      -          "creativity",
      -          "health",
      -          "home",
      -          "learning",
      -          "love",
      -          "money",
      -          "power",
      -          "relationship",
      -          "retreat",
      -          "spirituality",
      -          "stability",
      -          "success",
      -          "transformation",
      -          "travel",
      -          "vitality",
      -          "wealth"
      -        ],
      -        "type": "string"
      -      },
      -      "includeCoordinates": {
      -        "default": true,
      -        "type": "boolean"
      -      },
      -      "includeText": {
      -        "default": true,
      -        "type": "boolean"
      -      },
      -      "language": {
      -        "enum": [
      -          "uk",
      -          "en",
      -          "de",
      -          "pl",
      -          "es",
      -          "pt",
      -          "fr",
      -          "it",
      -          "nl",
      -          "cs",
      -          "ro",
      -          "hu",
      -          "el",
      -          "tr",
      -          "ar",
      -          "hi",
      -          "ja",
      -          "ko",
      -          "vi",
      -          "id",
      -          "ru"
      -        ],
      -        "type": "string"
      -      },
      -      "point": {
      -        "properties": {
      -          "lat": {
      -            "maximum": 90,
      -            "minimum": -90,
      -            "type": "number"
      -          },
      -          "lng": {
      -            "maximum": 180,
      -            "minimum": -180,
      -            "type": "number"
      -          }
      -        },
      -        "required": [
      -          "lat",
      -          "lng"
      -        ],
      -        "type": "object"
      -      },
      -      "polarity": {
      -        "default": "all",
      -        "enum": [
      -          "supportive",
      -          "challenging",
      -          "all"
      -        ],
      -        "type": "string"
      -      },
      -      "radiusDeg": {
      -        "default": 4,
      -        "maximum": 20,
      -        "minimum": 0.5,
      -        "type": "number"
      -      }
      -    },
      -    "required": [
      -      "category"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {
      +      "anyOf": [
      +        {},
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "description": "Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single house-system letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems.",
      +    "properties": {
      +      "ayanamsa": {
      +        "description": "Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.",
      +        "enum": [
      +          "fagan-bradley",
      +          "lahiri",
      +          "de-luce",
      +          "raman",
      +          "krishnamurti",
      +          "kp",
      +          "yukteshwar",
      +          "jn-bhasin",
      +          "true-citra",
      +          "djwhal-khul"
      +        ],
      +        "type": "string"
      +      },
      +      "ayanamsaId": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "city": {
      +        "default": "",
      +        "type": "string"
      +      },
      +      "cosmogram": {
      +        "type": "boolean"
      +      },
      +      "date": {
      +        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      +        "type": "string"
      +      },
      +      "houseSystem": {
      +        "default": "P",
      +        "enum": [
      +          "P",
      +          "K",
      +          "R",
      +          "C",
      +          "E",
      +          "W",
      +          "B",
      +          "M",
      +          "O",
      +          "A",
      +          "T",
      +          "V",
      +          "D",
      +          "F",
      +          "G",
      +          "H",
      +          "I",
      +          "i",
      +          "L",
      +          "N",
      +          "Q",
      +          "S",
      +          "U",
      +          "X",
      +          "Y"
      +        ],
      +        "type": "string"
      +      },
      +      "latitude": {
      +        "maximum": 90,
      +        "minimum": -90,
      +        "type": "number"
      +      },
      +      "longitude": {
      +        "maximum": 180,
      +        "minimum": -180,
      +        "type": "number"
      +      },
      +      "name": {
      +        "default": "",
      +        "type": "string"
      +      },
      +      "time": {
      +        "pattern": "^\\d{2}:\\d{2}(:\\d{2})?$",
      +        "type": "string"
      +      },
      +      "timezone": {
      +        "description": "IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.",
      +        "type": "string"
      +      },
      +      "timezoneOffset": {
      +        "anyOf": [
      +          {
      +            "maximum": 14,
      +            "minimum": -14,
      +            "type": "number"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": 0,
      +        "description": "Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent."
      +      },
      +      "zodiacType": {
      +        "enum": [
      +          "tropical",
      +          "sidereal"
      +        ],
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "date",
      +      "time",
      +      "latitude",
      +      "longitude"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {
      +      "anyOf": [
      +        {},
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "properties": {
      +      "category": {
      +        "enum": [
      +          "adventure",
      +          "career",
      +          "communication",
      +          "creativity",
      +          "health",
      +          "home",
      +          "learning",
      +          "love",
      +          "money",
      +          "power",
      +          "relationship",
      +          "retreat",
      +          "spirituality",
      +          "stability",
      +          "success",
      +          "transformation",
      +          "travel",
      +          "vitality",
      +          "wealth"
      +        ],
      +        "type": "string"
      +      },
      +      "includeCoordinates": {
      +        "default": true,
      +        "type": "boolean"
      +      },
      +      "includeText": {
      +        "default": true,
      +        "type": "boolean"
      +      },
      +      "language": {
      +        "enum": [
      +          "uk",
      +          "en",
      +          "de",
      +          "pl",
      +          "es",
      +          "pt",
      +          "fr",
      +          "it",
      +          "nl",
      +          "cs",
      +          "ro",
      +          "hu",
      +          "el",
      +          "tr",
      +          "ar",
      +          "hi",
      +          "ja",
      +          "ko",
      +          "vi",
      +          "id",
      +          "ru"
      +        ],
      +        "type": "string"
      +      },
      +      "point": {
      +        "properties": {
      +          "lat": {
      +            "maximum": 90,
      +            "minimum": -90,
      +            "type": "number"
      +          },
      +          "lng": {
      +            "maximum": 180,
      +            "minimum": -180,
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "lat",
      +          "lng"
      +        ],
      +        "type": "object"
      +      },
      +      "polarity": {
      +        "default": "all",
      +        "enum": [
      +          "supportive",
      +          "challenging",
      +          "all"
      +        ],
      +        "type": "string"
      +      },
      +      "radiusDeg": {
      +        "default": 4,
      +        "maximum": 20,
      +        "minimum": 0.5,
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "category"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedInput schema / properties / body / description
      Previous value: -"Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single Swiss Ephemeris letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems."New value: +"Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss), latitude and longitude in decimal degrees. The short forms lat, lon, lng and tz are rejected with 400 INVALID_FIELD; pass the full names. timezoneOffset is hours from UTC and defaults to 0, meaning UTC; send timezone instead (an IANA name such as Europe/Kyiv, or auto) and the offset for that date is worked out, summer time included. city is a display label only: nothing here geocodes it, so it never stands in for coordinates. houseSystem is a single house-system letter, P by default; a name such as \"Placidus\" is refused, and the case matters because I and i are two different Sunshine systems."
  2. Addedv1.6.0

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly=true, idempotent=true, destructive=false, so the safety profile is covered. The description adds genuinely non-redundant behavior: results are ranked by astrological weight and re-ranked by proximity when a point is given, interpretation text is included per line, and the call costs 50 credits (Tier 3) — a real pre-invocation consideration. Pagination/volume limits are not stated, but the output schema likely covers the response shape.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two front-loaded sentences that state purpose first, then return content, followed by compact group/endpoint/cost metadata that is scannable and useful. Minor waste and an inaccurate detail ('11 languages') keep it from a 5.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, and annotations cover the safety profile; combined with a rich input schema, the definition supplies the remaining essentials (ranking logic, interpretation text, cost). It stops short of explaining what an A*C*G 'line' is or how this differs from the general ACG sibling, which matters for a category-scoped variant.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the nested body schema is unusually detailed (timezone, ayanamsa, houseSystem caveats), so the schema carries parameter meaning. The description adds one useful behavioral note — that 'point' switches the ranking to proximity — but it also introduces a factual mismatch, claiming '11 languages' when the language enum lists 21 values, which could mislead an agent about coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Specific verb+resource: 'A*C*G lines that govern one area of life,' plus what is returned (curated interpretation text per line). It signals the category-based slice of ACG work, but it never names a sibling such as astroway_geo_acg or astroway_geo_acg_best_places, so differentiation from the plain ACG tool is left to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: an agent can infer 'use this when you want lines for a single life area,' and the phrase 'when a point is supplied' hints at the locating use case. There is no explicit when-not guidance, no statement of which sibling to pick when the user wants all lines, and no prerequisites described.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools