Vedic Astrology and Kundli MCP Server by RoxyAPI

Daily finance score from four KP sub lord layers - KP Daily Finance API

post_vedic_astrology_kp_daily_finance

Read-only

A Krishnamurti Paddhati daily finance reading for one native on one date. Four KP layers are each scored against the money houses and weighed into one number: the cusp sub lords of the gain and loss houses (structural promise), the four running Vimshottari lords at the reading moment (timing), the ruling planets of that moment (the pulse), and the sub lord windows the Moon passes through across the civil day (the hour hand), with the best and worst windows named. Weights cusps 30, dasha 40, rulingPlanets 15, moonWindows 15. Every input is the shipped KP arithmetic: Placidus cusps, the 249 sub lord table, the four tier significator rule, the Vimshottari chain to the sookshma level, all in the one ayanamsa you choose. Every row prints its planet, its standing against the two sets and its score, so the number can be audited rather than trusted. The house groups, the classification, the inversion on the loss cusps, the retrograde penalty, the level weights and the layer weights are a KP practitioner convention adopted as the published convention of this route: no classical KP text weighs these four layers against each other, and every table behind the number is printed so the result can be checked line by line rather than trusted. The score measures what the method outputs for the day, never the probability of a gain or a loss. Override the two house groups to run your own school.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`date`	No	Civil date to read, YYYY-MM-DD in the request timezone. Defaults to today (UTC). The Moon windows cover this date from midnight to midnight.
`time`	No	Reading moment on that date, HH:MM:SS local. The ruling planets and the running sookshma lord are read at this instant. Defaults to 12:00:00; pass a market open or any hour for an intraday read.
`compact`	No	Set true for the same data in a compact shape: arrays of same-shaped objects arrive columnar as {"__cols":[names],"__rows":[[values]]}. Lossless, typically 40 to 52 percent fewer tokens.
`weights`	No	Layer weights in percent, all four required, summing to 100. Defaults to the convention, cusps 30, dasha 40, rulingPlanets 15, moonWindows 15. Seventy percent of the default sits on the cusps and the outer dasha levels, which hold for months, so a chart reads inside a narrow band all month and the bands separate charts more than days. Move weight onto rulingPlanets and moonWindows for a reading that turns with the day.
`ayanamsa`	No	Ayanamsa system for sidereal conversion. "kp-newcomb" uses the KP-Newcomb dynamic formula, the most common choice for KP astrology. "kp-old" uses the Krishnamurti original table from KP Reader-1 with constant precession rate. "lahiri" uses Lahiri/Chitrapaksha ayanamsa, matching most traditional Vedic software. "raman" uses the B.V. Raman ayanamsa from Hindu Predictive Astrology, a recognised traditional school that sits about 1.45 degrees below Lahiri. Defaults to "kp-newcomb".	kp-newcomb
`latitude`	Yes	Birth latitude in decimal degrees. Sets the Placidus cusps; also the place the ruling planets and the Moon windows are read at.
`nodeType`	No	Lunar node convention. "mean" is the smoothed average node, which always moves retrograde; "true" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the Rahu and Ketu positions. Mean is the traditional Vedic default and what printed panchangs use; the choice can move a KP sub-lord in narrow boundary cases, where a span can be as small as 0.5 degrees. Defaults to "mean".	mean
`timezone`	No	Timezone as an IANA name (Asia/Kolkata) or decimal hours from UTC. Applies to the birth time, to the reading date and time, and to every local timestamp in the response. IANA names resolve to the offset in force on the date being read.
`birthDate`	Yes	Birth date, YYYY-MM-DD. Fixes the Placidus cusps, the four tier significators and the Vimshottari balance every layer reads.
`birthTime`	Yes	Birth time, HH:MM:SS, 24 hour, local to the birth place. The cusp sub lords move about one sub every four minutes of clock time, so this is the input the whole reading is most sensitive to.
`longitude`	Yes	Birth longitude in decimal degrees, east positive.
`gainHouses`	No	Houses whose significators count as gain, 1 to 12. Defaults to the convention, 2 and 11. Override it to run your own school: the two lists may not share a house.
`lossHouses`	No	Houses whose significators count as loss, 1 to 12. Defaults to the convention, 6 and 8 and 12. Override it to run your own school: the two lists may not share a house.

Output Schema

TableJSON Schema

Name	Required	Default
`band`	Yes
`date`	Yes
`score`	Yes
`houses`	Yes
`layers`	Yes
`ayanamsa`	No	kp-newcomb
`readingAt`	Yes
`bestWindow`	Yes
`worstWindows`	Yes
`significators`	Yes
`ayanamsaDegrees`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 20, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "ayanamsa": {
+      "default": "kp-newcomb",
+      "enum": [
+        "kp-newcomb",
+        "kp-old",
+        "lahiri",
+        "raman"
+      ],
+      "type": "string"
+    },
+    "ayanamsaDegrees": {
+      "type": "number"
+    },
+    "band": {
+      "enum": [
+        "strong",
+        "favourable",
+        "mixed",
+        "caution",
+        "unfavourable"
+      ],
+      "type": "string"
+    },
+    "bestWindow": {
+      "properties": {
+        "from": {
+          "type": "string"
+        },
+        "inGain": {
+          "type": "boolean"
+        },
+        "inLoss": {
+          "type": "boolean"
+        },
+        "score": {
+          "type": "number"
+        },
+        "subLord": {
+          "type": "string"
+        },
+        "to": {
+          "type": "string"
+        },
+        "verdict": {
+          "enum": [
+            "favourable",
+            "mixed",
+            "unfavourable",
+            "neutral"
+          ],
+          "type": "string"
+        }
+      },
+      "required": [
+        "inGain",
+        "inLoss",
+        "verdict",
+        "from",
+        "to",
+        "subLord",
+        "score"
+      ],
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "date": {
+      "type": "string"
+    },
+    "houses": {
+      "properties": {
+        "gain": {
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        },
+        "loss": {
+          "items": {
+            "type": "number"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "gain",
+        "loss"
+      ],
+      "type": "object"
+    },
+    "layers": {
+      "properties": {
+        "cusps": {
+          "properties": {
+            "layer": {
+              "enum": [
+                "cusps"
+              ],
+              "type": "string"
+            },
+            "rows": {
+              "items": {
+                "properties": {
+                  "house": {
+                    "type": "number"
+                  },
+                  "inGain": {
+                    "type": "boolean"
+                  },
+                  "inLoss": {
+                    "type": "boolean"
+                  },
+                  "inverted": {
+                    "type": "boolean"
+                  },
+                  "longitude": {
+                    "type": "number"
+                  },
+                  "score": {
+                    "type": "number"
+                  },
+                  "signLord": {
+                    "type": "string"
+                  },
+                  "starLord": {
+                    "type": "string"
+                  },
+                  "subLord": {
+                    "type": "string"
+                  },
+                  "verdict": {
+                    "enum": [
+                      "favourable",
+                      "mixed",
+                      "unfavourable",
+                      "neutral"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "inGain",
+                  "inLoss",
+                  "verdict",
+                  "house",
+                  "longitude",
+                  "signLord",
+                  "starLord",
+                  "subLord",
+                  "inverted",
+                  "score"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "score": {
+              "type": "number"
+            },
+            "weight": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "layer",
+            "weight",
+            "score",
+            "rows"
+          ],
+          "type": "object"
+        },
+        "dasha": {
+          "properties": {
+            "layer": {
+              "enum": [
+                "dasha"
+              ],
+              "type": "string"
+            },
+            "rows": {
+              "items": {
+                "properties": {
+                  "endDate": {
+                    "type": "string"
+                  },
+                  "inGain": {
+                    "type": "boolean"
+                  },
+                  "inLoss": {
+                    "type": "boolean"
+                  },
+                  "level": {
+                    "enum": [
+                      "mahadasha",
+                      "antardasha",
+                      "pratyantardasha",
+                      "sookshmaDasha"
+                    ],
+                    "type": "string"
+                  },
+                  "lord": {
+                    "type": "string"
+                  },
+                  "retrograde": {
+                    "type": "boolean"
+                  },
+                  "score": {
+                    "type": "number"
+                  },
+                  "startDate": {
+                    "type": "string"
+                  },
+                  "verdict": {
+                    "enum": [
+                      "favourable",
+                      "mixed",
+                      "unfavourable",
+                      "neutral"
+                    ],
+                    "type": "string"
+                  },
+                  "weight": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "inGain",
+                  "inLoss",
+                  "verdict",
+                  "level",
+                  "lord",
+                  "startDate",
+                  "endDate",
+                  "retrograde",
+                  "score",
+                  "weight"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "score": {
+              "type": "number"
+            },
+            "weight": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "layer",
+            "weight",
+            "score",
+            "rows"
+          ],
+          "type": "object"
+        },
+        "moonWindows": {
+          "properties": {
+            "layer": {
+              "enum": [
+                "moonWindows"
+              ],
+              "type": "string"
+            },
+            "rows": {
+              "items": {
+                "properties": {
+                  "from": {
+                    "type": "string"
+                  },
+                  "inGain": {
+                    "type": "boolean"
+                  },
+                  "inLoss": {
+                    "type": "boolean"
+                  },
+                  "score": {
+                    "type": "number"
+                  },
+                  "subLord": {
+                    "type": "string"
+                  },
+                  "to": {
+                    "type": "string"
+                  },
+                  "verdict": {
+                    "enum": [
+                      "favourable",
+                      "mixed",
+                      "unfavourable",
+                      "neutral"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "inGain",
+                  "inLoss",
+                  "verdict",
+                  "from",
+                  "to",
+                  "subLord",
+                  "score"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "score": {
+              "type": "number"
+            },
+            "weight": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "layer",
+            "weight",
+            "score",
+            "rows"
+          ],
+          "type": "object"
+        },
+        "rulingPlanets": {
+          "properties": {
+            "layer": {
+              "enum": [
+                "rulingPlanets"
+              ],
+              "type": "string"
+            },
+            "rows": {
+              "items": {
+                "properties": {
+                  "inGain": {
+                    "type": "boolean"
+                  },
+                  "inLoss": {
+                    "type": "boolean"
+                  },
+                  "planet": {
+                    "type": "string"
+                  },
+                  "retrograde": {
+                    "type": "boolean"
+                  },
+                  "score": {
+                    "type": "number"
+                  },
+                  "verdict": {
+                    "enum": [
+                      "favourable",
+                      "mixed",
+                      "unfavourable",
+                      "neutral"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "inGain",
+                  "inLoss",
+                  "verdict",
+                  "planet",
+                  "retrograde",
+                  "score"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "score": {
+              "type": "number"
+            },
+            "weight": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "layer",
+            "weight",
+            "score",
+            "rows"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "cusps",
+        "dasha",
+        "rulingPlanets",
+        "moonWindows"
+      ],
+      "type": "object"
+    },
+    "readingAt": {
+      "type": "string"
+    },
+    "score": {
+      "type": "number"
+    },
+    "significators": {
+      "properties": {
+        "byHouse": {
+          "items": {
+            "properties": {
+              "group": {
+                "enum": [
+                  "gain",
+                  "loss"
+                ],
+                "type": "string"
+              },
+              "house": {
+                "type": "number"
+              },
+              "significators": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "required": [
+              "house",
+              "group",
+              "significators"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "gain": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "loss": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "gain",
+        "loss",
+        "byHouse"
+      ],
+      "type": "object"
+    },
+    "worstWindows": {
+      "items": {
+        "properties": {
+          "from": {
+            "type": "string"
+          },
+          "inGain": {
+            "type": "boolean"
+          },
+          "inLoss": {
+            "type": "boolean"
+          },
+          "score": {
+            "type": "number"
+          },
+          "subLord": {
+            "type": "string"
+          },
+          "to": {
+            "type": "string"
+          },
+          "verdict": {
+            "enum": [
+              "favourable",
+              "mixed",
+              "unfavourable",
+              "neutral"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "inGain",
+          "inLoss",
+          "verdict",
+          "from",
+          "to",
+          "subLord",
+          "score"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "date",
+    "readingAt",
+    "ayanamsaDegrees",
+    "houses",
+    "significators",
+    "layers",
+    "score",
+    "band",
+    "bestWindow",
+    "worstWindows"
+  ],
+  "type": "object"
+}

AddedSep 14, 2026

TDQS

A4/5.0

Behavior5/5

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

Annotations already declare readOnlyHint=true, so no contradiction. The description adds substantial behavioral context: it explains the scoring method, the weights, the auditability ('every table behind the number is printed'), and clarifies the score measures method output, not probability. It also discloses the KP practitioner convention and the override capability. This goes well beyond the annotations.

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

Conciseness2/5

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

The description is verbose and repetitive, with phrases like 'rather than trusted' appearing twice. It contains multiple long sentences that could be trimmed without losing meaning. While it is structured, it does not meet the standard of every sentence earning its place; some redundancy exists.

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

Completeness5/5

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

Given the complexity (13 parameters, nested objects, output schema exists), the description is remarkably complete. It covers the method, weights, arithmetic conventions, auditability, disclaimer about probability, and override capability. The output schema handles return values, so no gap there. Nothing essential is missing for an agent to call it correctly.

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%, so the baseline is 3. The description adds conceptual context for weights and layers, but the schema already provides detailed parameter explanations. The description does not introduce new parameter semantics beyond what the schema offers, so it remains at baseline.

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

Purpose5/5

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

The description states a specific verb and resource: 'A Krishnamurti Paddhati daily finance reading for one native on one date.' It clearly differentiates from sibling KP tools by focusing on a finance score from four sub lord layers, which is distinct from raw cusps, ruling planets, or chart calculations. The purpose is unambiguous.

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?

The description implies usage for daily finance readings but does not explicitly state when to use this tool over alternatives. It mentions override options but no exclusions or direct references to sibling tools. The use case is clear but lacks explicit routing guidance.

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

All Vedic Astrology and Kundli MCP Server by RoxyAPI tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?