---
title: "Agent tool definitions"
method: GET
path: "/agent/tools"
tags: ["Agent Platform"]
---

# Agent tool definitions

`GET /agent/tools`

Tool definitions for an agent framework, generated from the live OpenAPI document, so the schema a model fills is the schema the endpoint validates. `format=openai` (default) returns `{ type, function }` objects you can spread straight into a chat completion; `format=anthropic` returns `{ name, description, input_schema }`. The objects carry nothing of ours: how to call each tool lives in a separate `executors` map keyed by tool name, because an unexpected key inside a vendor tool object is a 400 at their end. `select` chooses what to hand over: the curated starter set by default, `all` for the catalogue, `group:Vedic` for one area, `paths:/chart,/synastry` for an explicit list; `q` filters within that, `limit` caps it (default 32, max 128, which is the OpenAI ceiling). Nothing truncates silently: `totalMatched`, `totalAvailable` and a note say what was left out. No auth is embedded in a tool, so send X-Api-Key on the call itself.

## Query parameters

- `format` 'openai' | 'anthropic'
- `select` string
- `q` string
- `limit` integer

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `format` string, nullable
    - `select` string, nullable
    - `tools` object[], nullable
      - `type` string, nullable
      - `function` object, nullable
        - `name` string, nullable
        - `description` string, nullable
        - `parameters` object, nullable
          - `type` string, nullable
          - `properties` object, nullable
            - `date` object, nullable
              - …
            - `time` object, nullable
              - …
            - `timezoneOffset` object, nullable
              - …
            - `latitude` object, nullable
              - …
            - `longitude` object, nullable
              - …
            - `houseSystem` object, nullable
              - …
            - `name` object, nullable
              - …
            - `city` object, nullable
              - …
            - `zodiacType` object, nullable
              - …
            - `ayanamsaId` object, nullable
              - …
            - `ayanamsa` object, nullable
              - …
            - `cosmogram` object, nullable
              - …
            - `timeUnknown` object, nullable
              - …
          - `required` string[], nullable
          - `additionalProperties` boolean, nullable
          - `description` string, nullable
    - `executors` object, nullable
      - `astroway_post_chart` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_planets` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_sun_times` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_synastry` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_composite` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_synastry_attraction_score` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_transits` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_transit_calendar` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_forecast_calendar` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_solar_return` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_render_wheel_western` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_moon_phase` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_human_design` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_hd_penta` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_vedic_varga_D1` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_vedic_varga_D9` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_vedic_panchang_full` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_vedic_dashas_vimshottari_maha` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_horoscope_daily` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_numerology_pythagorean_life_path` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_numerology_pythagorean_expression` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_numerology_chaldean_life_path` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_tarot_rider_waite_draw_single` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_tarot_rider_waite_draw_three_card` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_reports_natal` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
      - `astroway_post_ai_explain_aspect` object, nullable
        - `method` string, nullable
        - `path` string, nullable
        - `credits` number, nullable
        - `group` string, nullable
        - `docs` string, nullable
    - `count` number, nullable
    - `totalMatched` number, nullable
    - `totalAvailable` number, nullable
    - `truncated` boolean, nullable
    - `notes` string[], nullable

## Other responses

- `400` — Validation error
- `401` — Missing or invalid API key

---

[API](https://skmtc.net/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.net/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/astroway/astroway-calculation-api/revisions/8ab5a768b521/schema)