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---56# QVeris Tool Search & Execution78QVeris provides dynamic tool discovery and execution - search for tools by capability, then execute them with parameters.910## Setup1112Requires environment variable:13- `QVERIS_API_KEY` - Get from https://qveris.ai1415No additional dependencies — uses Node.js built-in `fetch`.1617## Security1819- **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.2324## Quick Start2526### Search for tools27```bash28node scripts/qveris_tool.mjs search "weather forecast API"29```3031### Execute a tool32```bash33node scripts/qveris_tool.mjs execute openweathermap_current_weather --search-id <id> --params '{"city": "London", "units": "metric"}'34```3536## Script Usage3738```39node scripts/qveris_tool.mjs <command> [options]4041Commands:42 search <query> Search for tools matching a capability description43 execute <tool_id> Execute a specific tool with parameters4445Options: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 string49 --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 display52```5354## Workflow55561. **Search**: Describe the capability needed (not specific parameters)57 - Good: "weather forecast API"58 - Bad: "get weather for London"59602. **Select**: Review tools by `success_rate` and `avg_execution_time`61623. **Execute**: Call tool with `tool_id`, `search_id`, and `parameters`6364## Example Session6566```bash67# Find weather tools68node scripts/qveris_tool.mjs search "current weather data"6970# Execute with returned tool_id and search_id71node scripts/qveris_tool.mjs execute openweathermap_current_weather \72 --search-id abc123 \73 --params '{"city": "Tokyo", "units": "metric"}'74```7576## Use Cases7778- **Weather**: Get current weather, forecasts for any location79- **Search**: Web search, information retrieval80- **Stocks & Finance**: Query stock prices, historical data, earnings calendars81- **Economics**: GDP, inflation rates, economic indicators82- **Geolocation**: IP lookup, geocoding, reverse geocoding83- **AIGC**: Image generation, text-to-speech, AI content creation84- **News**: Headlines, article search, trending topics85- **Social Media**: Trending topics, post analytics, engagement data86- **Health Data**: Clinical trials, drug info, health statistics87- **And more**: QVeris aggregates thousands of API tools
dvcrn