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:
No additional dependencies — uses Node.js built-in fetch.
Security
- Credential: Only
QVERIS_API_KEY is accessed. No other env vars or secrets are read.
- Network: API key is sent only to
https://qveris.ai/api/v1 over HTTPS. No other endpoints are contacted.
- Storage: The key is never logged, cached, or written to disk.
- Recommendation: Use a scoped, revocable API key. Monitor usage at https://qveris.ai.
Quick Start
Search for tools
node scripts/qveris_tool.mjs search "weather forecast API"
Execute a tool
node scripts/qveris_tool.mjs execute openweathermap_current_weather --search-id <id> --params '{"city": "London", "units": "metric"}'
Script Usage
node scripts/qveris_tool.mjs <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: 10)
--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)
--timeout N Request timeout in seconds (default: 30 for search, 60 for execute)
--json Output raw JSON instead of formatted display
Workflow
Search: Describe the capability needed (not specific parameters)
- Good: "weather forecast API"
- Bad: "get weather for London"
Select: Review tools by success_rate and avg_execution_time
Execute: Call tool with tool_id, search_id, and parameters
Example Session
# Find weather tools
node scripts/qveris_tool.mjs search "current weather data"
# Execute with returned tool_id and search_id
node scripts/qveris_tool.mjs execute openweathermap_current_weather \
--search-id abc123 \
--params '{"city": "Tokyo", "units": "metric"}'
Use Cases
- Weather: Get current weather, forecasts for any location
- Search: Web search, information retrieval
- Stocks & Finance: Query stock prices, historical data, earnings calendars
- Economics: GDP, inflation rates, economic indicators
- Geolocation: IP lookup, geocoding, reverse geocoding
- AIGC: Image generation, text-to-speech, AI content creation
- News: Headlines, article search, trending topics
- Social Media: Trending topics, post analytics, engagement data
- Health Data: Clinical trials, drug info, health statistics
- And more: QVeris aggregates thousands of API tools
1---2name: qverisai3description: Search and execute dynamic tools via QVeris API. Use when needing to find and call external APIs/tools dynamically — covers weather, search, stocks, finance, economics, geolocation, AIGC, news, social media, health data, and thousands more. Requires QVERIS_API_KEY environment variable.4---5
6# QVeris Tool Search & Execution
7
8QVeris provides dynamic tool discovery and execution - search for tools by capability, then execute them with parameters.
9
10## Setup
11
12Requires environment variable:
13- `QVERIS_API_KEY` - Get from https://qveris.ai
14
15No additional dependencies — uses Node.js built-in `fetch`.
16
17## Security
18
19- **Credential**: Only `QVERIS_API_KEY` is accessed. No other env vars or secrets are read.
20- **Network**: API key is sent only to `https://qveris.ai/api/v1` over HTTPS. No other endpoints are contacted.
21- **Storage**: The key is never logged, cached, or written to disk.
22- **Recommendation**: Use a scoped, revocable API key. Monitor usage at https://qveris.ai.
23
24## Quick Start
25
26### Search for tools
27```bash
28node scripts/qveris_tool.mjs search "weather forecast API"
29```
30
31### Execute a tool
32```bash
33node scripts/qveris_tool.mjs execute openweathermap_current_weather --search-id <id> --params '{"city": "London", "units": "metric"}'
34```
35
36## Script Usage
37
38```
39node scripts/qveris_tool.mjs <command> [options]
40
41Commands:
42 search <query> Search for tools matching a capability description
43 execute <tool_id> Execute a specific tool with parameters
44
45Options:
46 --limit N Max results for search (default: 10)
47 --search-id ID Search ID from previous search (required for execute)
48 --params JSON Tool parameters as JSON string
49 --max-size N Max response size in bytes (default: 20480)
50 --timeout N Request timeout in seconds (default: 30 for search, 60 for execute)
51 --json Output raw JSON instead of formatted display
52```
53
54## Workflow
55
561. **Search**: Describe the capability needed (not specific parameters)
57 - Good: "weather forecast API"
58 - Bad: "get weather for London"
59
602. **Select**: Review tools by `success_rate` and `avg_execution_time`
61
623. **Execute**: Call tool with `tool_id`, `search_id`, and `parameters`
63
64## Example Session
65
66```bash
67# Find weather tools
68node scripts/qveris_tool.mjs search "current weather data"
69
70# Execute with returned tool_id and search_id
71node scripts/qveris_tool.mjs execute openweathermap_current_weather \
72 --search-id abc123 \
73 --params '{"city": "Tokyo", "units": "metric"}'
74```
75
76## Use Cases
77
78- **Weather**: Get current weather, forecasts for any location
79- **Search**: Web search, information retrieval
80- **Stocks & Finance**: Query stock prices, historical data, earnings calendars
81- **Economics**: GDP, inflation rates, economic indicators
82- **Geolocation**: IP lookup, geocoding, reverse geocoding
83- **AIGC**: Image generation, text-to-speech, AI content creation
84- **News**: Headlines, article search, trending topics
85- **Social Media**: Trending topics, post analytics, engagement data
86- **Health Data**: Clinical trials, drug info, health statistics
87- **And more**: QVeris aggregates thousands of API tools
modbender