Skip to main content
Glama

Generate Muhurta Report (PDF or HTML)

astroway_reports_muhurta

Render a standard A4 report of the most auspicious dates for a chosen activity over a search window. Same window-scan engine as /vedic/muhurat/*: it scores each day by sunrise Panchang (Tithi/Vara/Nakshatra/Yoga/Karana) per Muhurta Chintamani + B.V.Raman, and lists ranked days with per-day Abhijit Muhurat and the scoring factors as the rationale. activity is one of the 12 from /muhurta/types. PDF default; ?format=html returns HTML.

[Group: Reports] [Endpoint: POST /v1/reports/muhurta] [Required: activity, search_window_start, latitude, longitude] [Cost: 5,000 credits (Tier 7)] ⚠️ Premium — ~50% of free monthly budget. Confirm with user before invoking.

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": {
      "activity": "<activity>",
      "search_window_start": "<search_window_start>",
      "latitude": "<latitude>",
      "longitude": "<longitude>"
    },
    "name": "astroway_reports_muhurta"
  }
}

Input Schema

NameRequiredDescriptionDefault
topNNo
fieldsNoCompact mode: comma-separated dotted paths to keep, relative to `data`, e.g. "planets.name,planets.longitude,houses.cusp". Omit for the whole response.
formatNo`pdf` (default) stores a PDF and answers with its `url`. `html` returns one self-contained `text/html` document, `markdown` returns `text/markdown` with the same sections and tables; neither is stored. Same price in every format.
activityYes
ayanamsaNoSidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
languageNo
latitudeYes
longitudeYes
precisionNoCompact mode: round fractional numbers to this many decimals. Longitudes carry 14 by default; 2 is finer than any chart is drawn.
ayanamsaIdNo
whitelabelNo
timezoneOffsetNoHours 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.
search_window_endNo
search_window_startYes

Output Schema

NameRequiredDescriptionDefault
urlNo
expires_atNo
page_countNo
byte_lengthNo
duration_msNo
storage_keyNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / format
      Added value: +{
      +  "description": "`pdf` (default) stores a PDF and answers with its `url`. `html` returns one self-contained `text/html` document, `markdown` returns `text/markdown` with the same sections and tables; neither is stored. Same price in every format.",
      +  "enum": [
      +    "pdf",
      +    "html",
      +    "markdown"
      +  ],
      +  "type": "string"
      +}
  2. Changed15 schema fields changed
    • removedInput schema / properties / ayanamsaId / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedInput schema / properties / ayanamsaId / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • changedInput schema / properties / whitelabel / anyOf
      Previous value: -[
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "backgroundColor": {
      -        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      -        "type": "string"
      -      },
      -      "companyBio": {
      -        "maxLength": 500,
      -        "type": "string"
      -      },
      -      "companyEmail": {
      -        "format": "email",
      -        "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      -        "type": "string"
      -      },
      -      "companyMobile": {
      -        "maxLength": 40,
      -        "type": "string"
      -      },
      -      "companyName": {
      -        "maxLength": 80,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "companyUrl": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "fontPairing": {
      -        "enum": [
      -          "serif-sans",
      -          "sans-serif",
      -          "serif-only",
      -          "sans-only",
      -          "system"
      -        ],
      -        "type": "string"
      -      },
      -      "footerText": {
      -        "maxLength": 200,
      -        "type": "string"
      -      },
      -      "frontImage": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "headingColor": {
      -        "description": "Colour of the divider rule under each section heading (not the heading text, which is themeColor).",
      -        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      -        "type": "string"
      -      },
      -      "logoUrl": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "reportName": {
      -        "maxLength": 80,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "textPrimaryColor": {
      -        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      -        "type": "string"
      -      },
      -      "textSecondaryColor": {
      -        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      -        "type": "string"
      -      },
      -      "themeColor": {
      -        "description": "Accent colour, used for section heading text and inline emphasis.",
      -        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "type": "boolean"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "backgroundColor": {
      +        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      +        "type": "string"
      +      },
      +      "companyBio": {
      +        "maxLength": 500,
      +        "type": "string"
      +      },
      +      "companyEmail": {
      +        "format": "email",
      +        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      +        "type": "string"
      +      },
      +      "companyMobile": {
      +        "maxLength": 40,
      +        "type": "string"
      +      },
      +      "companyName": {
      +        "maxLength": 80,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "companyUrl": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "fontPairing": {
      +        "enum": [
      +          "serif-sans",
      +          "sans-serif",
      +          "serif-only",
      +          "sans-only",
      +          "system"
      +        ],
      +        "type": "string"
      +      },
      +      "footerText": {
      +        "maxLength": 200,
      +        "type": "string"
      +      },
      +      "frontImage": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "headingColor": {
      +        "description": "Colour of the divider rule under each section heading (not the heading text, which is themeColor).",
      +        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      +        "type": "string"
      +      },
      +      "logoUrl": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "reportName": {
      +        "maxLength": 80,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "textPrimaryColor": {
      +        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      +        "type": "string"
      +      },
      +      "textSecondaryColor": {
      +        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      +        "type": "string"
      +      },
      +      "themeColor": {
      +        "description": "Accent colour, used for section heading text and inline emphasis.",
      +        "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
      +        "type": "string"
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / properties / byte_length / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / byte_length / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / duration_ms / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / duration_ms / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / expires_at / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / expires_at / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / page_count / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / page_count / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / storage_key / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / storage_key / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
  3. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare openWorld/non-destructive/non-idempotent, and the description adds materially relevant behavior beyond them: PDF is stored and returns a URL while html/markdown are returned inline and not stored, price is identical across formats, and the call costs 5,000 credits at ~50% of a free monthly budget. It also explains the scoring basis (sunrise Panchang per Muhurta Chintamani + B.V. Raman, per-day Abhijit Muhurat). Minor gap: no note on latency or whether repeated calls bill again.

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?

Three tight sentences with the deliverable front-loaded, followed by the methodology rationale and the format/cost notes. Nothing is padded, though the internal-path references ('/vedic/muhurat/*', '/muhurta/types') assume the reader knows the REST surface.

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?

With an output schema present the description need not explain return values, and it covers the essentials for a paid, generating call: required inputs, activity source, format behavior and cost confirmation. The noticeable omission is the whitelabel branding option, a headline capability of a report renderer that the description never mentions, plus no guidance on window length or topN.

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 only 36% across 14 parameters, and the description compensates only partially — it points activity at the 12 types from /muhurta/types and explains the format switch in prose, which is useful. It is silent on topN, language, whitelabel branding, timezoneOffset, search_window_end (optional) and ayanamsa, leaving roughly half the surface to be read from the schema alone.

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 gives a specific verb and deliverable — 'Render a standard A4 report of the most auspicious dates for a chosen activity over a search window' — and distinguishes itself from the data-only muhurta siblings by noting it shares 'the same window-scan engine as /vedic/muhurat/*' but produces a rendered report. An agent knows immediately that this is a document-producing tool, not a raw JSON endpoint.

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?

It states the required selection inputs and a cost-driven rule ('Confirm with user before invoking'), which is real guidance for a 5,000-credit call. But it never says when to prefer this over the per-activity muhurat tools or astroway_reports_generate, nor what search-window length is sensible, so the when-to-use decision is only implied.

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