---
title: "Describe one tool"
method: GET
path: "/api/v1/tools/{tool_name}"
tags: ["Discovery"]
---

# Describe one tool

`GET /api/v1/tools/{tool_name}`

## Request

- Base URL: `https://adako.ai`
- URL: `https://adako.ai/api/v1/tools/{tool_name}`
- Auth: HTTP bearer

The full standard-operating-procedure description, the JSON Schema of its arguments and example prompts.

## Path parameters

- `tool_name` string, required

## Response `200`

The tool.

- object
  - `success` unknown, required
  - `tool` ToolDetail, required
    - `name` string, required
    - `title` string, required
    - `platform` string, required
    - `category` string, nullable
    - `risk` 'read-only' | 'write' | 'destructive-write', required
    - `cost` integer, required: Tasks charged per call. 0 is never billed.
    - `since` string, nullable
    - `call_url` string, required
    - `description` string
    - `kind` 'read' | 'write'
    - `examples` string[]
    - `input_schema` object
    - `required` string[]
  - `request_id` string, required

## Other responses

- `401`: Missing or invalid API key.
- `404`: Unknown tool name.

---

[API](https://skmtc.dev/adako/apis/adako-rest-api.md) · [All operations](https://skmtc.dev/adako/apis/adako-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adako/apis/adako-rest-api/revisions/59ee60d48a56?raw)