catalog_search
Search cloud instance catalog by provider, vCPU, memory, price, or text query to match instance types with specs, pricing, and architecture for workload sizing and cost optimization.
Instructions
Search the cloud instance catalog by provider, specs, or text query.
Returns matching instance types with instance family, vCPU / memory / storage, hourly on-demand price, region availability, and architecture (x86 / arm). All filters combine with AND semantics.
When to use: Right-sizing workloads, finding the cheapest instance that meets a hardware bar, or discovering equivalents across families.
Behavior: Pure lookup from the bundled SQLite catalog — no LLM, no
network. Prices reflect catalog snapshot date (see refresh CLI command
to update).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| provider | No | Cloud provider slug to search within. Default 'aws'. | aws |
| query | No | Optional free-text query matching instance family, generation, or purpose (e.g. 'memory-optimized', 'graviton', 'gpu'). | |
| vcpus | No | Optional exact vCPU count filter. Returns instances matching this vCPU count. | |
| memory_gb | No | Optional exact memory-in-GB filter. Returns instances matching this memory size. | |
| max_price_per_hour | No | Optional maximum hourly on-demand price (USD). Returns only instances at or below this price. Useful for budget-constrained sizing. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |