---
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
    - `count` number, nullable
    - `totalMatched` number, nullable
    - `totalAvailable` number, nullable
    - `truncated` boolean, 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
            - `latitude` object, nullable
          - `required` 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
    - `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/6828e5609564/schema)