Get data
call_toolRuns one catalogue tool that reads data. A call is charged the tool's listed price only when it is a hit (it answered with data). A miss (answered, nothing there) and a failed call are not charged. The answer's meta says which: outcome, price_micros (what was charged) and balance_micros.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"tool": "<tool>"
},
"name": "call_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tool | Yes | Tool name from search_tools, e.g. tiktok.profile | |
| arguments | No | The tool's input, as describe_tools shows it | |
| max_age_s | No | Optional. The oldest answer you take, in seconds, for a tool whose repeat calls are answered from the cache (describe_tools shows cache for those). 0 = always read at the source, at the full price. Without it the tool's own maximum age applies; meta.cached, fetched_at and age_s say what you got | |
| idempotency_key | No | Optional. Your own name for this call (up to 200 characters). When a call that was charged is sent again with the same key, tool and arguments within 24 hours, the stored answer comes back free (meta.replay). Use it when you send a call again after a timeout | |
| max_cost_micros | No | Optional. The most this call may cost, in millionths of a dollar (1000000 = $1). A tool priced above it is refused before it runs, free, with its price in the error |