describe_tool

Returns the full contract for a tool: parameter definitions (types, required fields, enums, examples), the per-call cost, and an execute_as template you can copy into execute_tool.

Call describe_tool before every execute_tool. Never guess parameters.

string

required

A canonical Provider/Operation tool name (e.g. Firecrawl/scrape, Brave/getWebSearch), a browse path (e.g. crypto/market/...), or agentkey_account. On a typo, returns fuzzy-match suggestions — read them and correct rather than retrying blindly.

Returns

params — JSON Schema of parameters with types, required, enums, examples
cost — { credits_per_call, usd_per_call, cost_by_provider }
execute_as — a ready-to-run template for execute_tool
health — upstream availability for the tool

Cost guidance

Multiply cost.credits_per_call by your planned call count before executing a batch. For bulk work (≥3 calls or a meaningful credit estimate), check your balance first with account.

Example

describe_tool("Firecrawl/scrape")

{
  "name": "Firecrawl/scrape",
  "cost": { "credits_per_call": 0.2, "usd_per_call": 0.004 },
  "execute_as": { "name": "Firecrawl/scrape", "params": { "url": "<The URL to scrape.>" } },
  "params": { "type": "object", "required": ["url"], "properties": { "url": { "type": "string", "format": "uri" } } }
}

Next step

Copy execute_as, fill in the values, and pass it to execute_tool.

Overview

Tools

Returns

Cost guidance

Example

Next step

​Returns

​Cost guidance

​Example

​Next step

Returns

Cost guidance

Example

Next step