Skip to main content
Glama

The eight directions

astroway_vastu_shastra_vastu_directions
Read-onlyIdempotent

Guardian deity, planet, element, the classical use, the result of a water body and of enlarging the house on each side for the eight directions, each with its source. Elements have no verse and are marked as modern.

[Group: Vastu Shastra] [Endpoint: POST /v1/vastu/directions] [Cost: 10 credits (Tier 1)]

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "astroway_vastu_shastra_vastu_directions"
  }
}

Input Schema

NameRequiredDescriptionDefault
fieldsNoCompact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
precisionNoCompact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.

Output Schema

NameRequiredDescriptionDefault
notesNo
orderNo
directionsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedOutput schema / properties / directions / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "anyOf": [
      -        {
      -          "additionalProperties": {},
      -          "properties": {
      -            "classicalUse": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "classicalUseSource": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "degrees": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "dikpala": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "direction": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "element": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "elementBasis": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "higherGround": {
      -              "anyOf": [
      -                {},
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "higherGroundSource": {
      -              "anyOf": [
      -                {},
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "planet": {
      -              "anyOf": [
      -                {
      -                  "type": "string"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            },
      -            "water": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": {},
      -                  "properties": {
      -                    "effect": {
      -                      "anyOf": [
      -                        {
      -                          "type": "string"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "source": {
      -                      "anyOf": [
      -                        {
      -                          "type": "string"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    },
      -                    "verdict": {
      -                      "anyOf": [
      -                        {
      -                          "type": "string"
      -                        },
      -                        {
      -                          "type": "null"
      -                        }
      -                      ]
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                {
      -                  "type": "null"
      -                }
      -              ]
      -            }
      -          },
      -          "type": "object"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {},
      +          "properties": {
      +            "classicalUse": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "classicalUseSource": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "degrees": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "dikpala": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "direction": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "element": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "elementBasis": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "higherGround": {
      +              "anyOf": [
      +                {},
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "higherGroundSource": {
      +              "anyOf": [
      +                {},
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "planet": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "water": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": {},
      +                  "properties": {
      +                    "effect": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "verdict": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            }
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / notes / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedOutput schema / properties / order / anyOf
      Previous value: -[
      -  {
      -    "items": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ]
      -    },
      -    "type": "array"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "items": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "type": "array"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  2. Added

TDQS

B3.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint/idempotentHint/closed-world, so safety is covered; the description adds value beyond them by disclosing provenance ('each with its source') and a data-quality caveat ('Elements have no verse and are marked as modern'). The endpoint and cost tier (POST /v1/vastu/directions, 10 credits, Tier 1) are also behaviorally relevant facts the annotations do not carry. It does not say the call requires no chart/birth input, which would have been a useful confirmation.

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

Conciseness3/5

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

The content is compact and front-loaded, but the main sentence is a dangling noun list with no verb ('Guardian deity, planet, element, ... for the eight directions'), which takes a second pass to parse. The bracketed metadata block is well structured and cheap; the prose sentence is the weak point.

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 the description still usefully previews the per-direction fields. With zero required parameters and full schema coverage, an agent has enough to invoke it correctly. The only real omission is routing guidance against the other Vastu tools.

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 both parameters (fields, precision) are fully documented as compact-mode controls, so the schema carries the semantics. The description adds nothing about them, but per the baseline rule a 3 is correct when the schema does the heavy lifting on a 2-parameter tool.

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?

The description enumerates exactly what each of the eight directions carries: guardian deity, planet, element, classical use, water-body result, and the effect of enlarging the house on that side. That is a concrete, identifiable dataset, so an agent can tell this is a classical reference lookup rather than a computed chart. It stops short of an explicit verb ('returns/gets') and never names the sibling Vastu tools it differs from, so it is clear but not fully differentiated.

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

Usage Guidelines2/5

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

There is no statement of when to call this versus astroway_vastu_shastra_vastu_zones, vastu_mandala, or vastu_plan, all of which sit adjacent to it in the Vastu group. The agent must infer that this is the static doctrinal table and the others are applied/computed outputs. No prerequisites, no exclusions, no alternative routing.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources