Introduction
# QVeris Tool Search & Execution
QVeris provides dynamic tool discovery and execution - search for tools by capability, then execute them with parameters.
## Setup
Requires environment variable: - `QVERIS_API_KEY` - Get from https://qveris.ai
## Quick Start
### Search for tools ```bash uv run scripts/qveris_tool.py search "weather forecast API" ```
### Execute a tool ```bash uv run scripts/qveris_tool.py execute openweathermap_current_weather --search-id <id> --params '{"city": "London", "units": "metric"}' ```
## Script Usage
``` scripts/qveris_tool.py <command> [options]
Commands: search <query> Search for tools matching a capability description execute <tool_id> Execute a specific tool with parameters
Options: --limit N Max results for search (default: 5) --search-id ID Search ID from previous search (required for execute) --params JSON Tool parameters as JSON string --max-size N Max response size in bytes (default: 20480) --json Output raw JSON instead of formatted display ```
## Workflow
1. **Search**: Describe the capability needed (not specific parameters) - Good: "weather forecast API" - Bad: "get weather for London"
2. **Select**: Review tools by `success_rate` and `avg_execution_time`
3. **Execute**: Call tool with `tool_id`, `search_id`, and `parameters`
## Example Session
```bash # Find weather tools uv run scripts/qveris_tool.py search "current weather data"
# Execute with returned tool_id and search_id uv run scripts/qveris_tool.py execute openweathermap_current_weather \ --search-id abc123 \ --params '{"city": "Tokyo", "units": "metric"}' ```
## Use Cases
- **Weather Data**: Get current weather, forecasts for any location - **Stock Market**: Query stock prices, historical data, earnings calendars - **Search**: Web search, news retrieval - **Data APIs**: Currency exchange, geolocation, translations - **And more**: QVeris aggregates thousands of API tools