Inspect and price a task or tool
capability_inspectRead one task or provider tool from Ahel's catalog by its id: its exact inputs (Ahel's own contract, or the published reference input when Ahel has none), its status and exact reason, Ahel's price per provider (Unknown when Ahel has no rate), for a temporarily unavailable item the market prices seen elsewhere, for comparison, and the exact run_capability call when it can run. With arguments it also prices that exact run before anything runs: Ahel's quote, the most it may cost, the amount a run would reserve and whether the balance covers it; nothing is reserved, charged or started. With rows or rows_text (up to 100, for people.email.find or companies.register.search or companies.emails.from_website) it quotes a whole list instead: rows, rows that can run, each row's price and the most one row and the list may cost, the balance against it, and what each row that cannot run is missing. Free; changes nothing. NOT for: finding ids, which is capability_search, or running it, which is run_capability.
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": {
"id": "<id>"
},
"name": "capability_inspect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | A task id or tool id from capability_search. | |
| rows | No | A list for people.email.find or companies.register.search or companies.emails.from_website: 1 to 100 rows, each run once as its own run with its own exact cost. One object per row, such as {"name": "Patrick Collison", "domain": "stripe.com"} or {"name": "Wise", "country": "GB"}. | |
| arguments | No | Optional: the run's inputs, by name, to price that exact run (a quote only; nothing runs). | |
| max_items | No | With arguments: most rows to price for, 1-100. Default 10. | |
| rows_text | No | A list for people.email.find or companies.register.search or companies.emails.from_website: 1 to 100 rows, each run once as its own run with its own exact cost. Instead of rows: paste up to 100 rows as text, one per line ("Patrick Collison, stripe.com"; "Wise, GB") or a CSV with a header row (name, domain, linkedin_url; name, country). | |
| endpoint_ids | No | With arguments: price the run on these providers only (endpoint ids from this answer). | |
| timeout_seconds | No | With arguments: longest the run may take, 1-180 seconds. Default: the provider's own (60, more for slow sources). | |
| exclude_endpoint_ids | No | With arguments: price the run without these providers. |