Search the DivineAPI docs by keyword and return the matching endpoint cards.

Case-insensitive token scan over every endpoint reference card. Cards that match more of the query's tokens rank first. Returns up to limit whole cards (path, summary, params, returns). Use this when you know roughly what you want ("auspicious timings", "natal wheel", "love compatibility") but not the exact path.

Return the full reference card for one endpoint path.

Give an exact path such as /indian-api/v1/auspicious-timings. If the path is not an exact match, the closest single endpoint (substring on the last path segment) is returned, otherwise a short "did you mean..." list of candidates. The card lists the host, summary, params (with * for required and example values), and the top-level response fields (returns: line).

List endpoint paths with their hosts, optionally filtered by category.

With no argument, lists every endpoint as "path [host]" lines. Pass a category substring (case-insensitive) to filter, e.g. "Indian", "Western", "Numerology", "PDF", "Horoscope", "Lifestyle", or "Calculators".

Return the global DivineAPI usage rules (the docs-pack header).

Covers authentication (Bearer token + api_key form field), error semantics per host, the standard birth params, horoscope selectors, field formats, house systems, SDK installs, the MCP server URLs, and a "what not to do" list of common mistakes. Read this before constructing any request.

Return a real captured example response body for an endpoint path.

Uses the bundled examples (with a version-agnostic slug fallback, so an example captured at /api/v2/x also answers for /api/v3/x). If no example was captured for the path, points you to the card's returns: line instead.