mcpField
Q
qveris

qveris

github.com/hqmanAgent workflows3484 installsUpdated 39w ago
Repository

About qveris

QVeris is a skill for discovering tools by capability and executing a selected tool with parameters. It uses the QVeris API and provides a command-line workflow for searching, comparing results, and running tools.

Key features

  1. 01Search tools by capability
  2. 02Execute tools with parameters
  3. 03Review success rate and execution time
  4. 04Limit search result count

Use cases

  1. 01Retrieve current weather or forecasts
  2. 02Query stock data and earnings calendars
  3. 03Find web search, news, or data API tools

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hqman/qveris --skill qveris

After installing, type/qverisin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
README.md
README.zh-CN.md
pyproject.toml
scripts/
qveris_tool.py

Details

From the project README

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:

Quick Start

Search for tools
uv run scripts/qveris_tool.py search "weather forecast API"
Execute a tool
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

# 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

Comments

Markdown supported