Voice
Qveris Agent Toolkit
By Bring professional data and tools to the AI you already use: open-source MCP, CLI, SDKs, skills, and docs to find services, call them, and audit usage.
Install
npm install -gREADME
<div align="center">
<img src="assets/logo-light.png" width="120" alt="QVeris Logo" />
<h1>QVeris Agent Toolkit</h1>
<p><strong>Bring professional data to the AI you already use.</strong></p>
<p>QVeris is a professional data and tool access platform for AI. This open-source toolkit provides the CLI, MCP server, Python SDK, skills, and REST API docs that help AI assistants, products, and workflows find services, review supported scope, call them, and audit usage.</p>
<p>
Website: <a href="https://qveris.ai" target="_blank"><b>https://qveris.ai</b></a>
</p>
<p>
<b>๐บ๐ธ English</b> ยท
<a href="README_zh-CN.md">๐จ๐ณ ็ฎไฝไธญๆ</a>
</p>
<p>
<a href="https://github.com/QVerisAI/qveris-agent-toolkit">
<img src="https://img.shields.io/github/stars/QVerisAI/qveris-agent-toolkit?style=social" alt="GitHub stars" />
</a>
<a href="https://github.com/QVerisAI/qveris-agent-toolkit/actions/workflows/contract-tests.yml">
<img src="https://github.com/QVerisAI/qveris-agent-toolkit/actions/workflows/contract-tests.yml/badge.svg?branch=main" alt="CI" />
</a>
<a href="https://www.npmjs.com/package/@qverisai/cli">
<img src="https://img.shields.io/npm/v/@qverisai/cli?label=cli" alt="cli npm version" />
</a>
<a href="https://www.npmjs.com/package/@qverisai/mcp">
<img src="https://img.shields.io/npm/v/@qverisai/mcp?label=mcp" alt="mcp npm version" />
</a>
<a href="https://www.npmjs.com/package/@qverisai/sdk">
<img src="https://img.shields.io/npm/v/@qverisai/sdk?label=js-sdk" alt="js-sdk npm version" />
</a>
<a href="https://pypi.org/project/qveris/">
<img src="https://img.shields.io/pypi/v/qveris?label=python-sdk" alt="PyPI version" />
</a>
<a href="https://github.com/QVerisAI/qveris-agent-toolkit/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/QVerisAI/qveris-agent-toolkit" alt="license" />
</a>
</p>
</div>
---
- Professional data and tools across finance, search, weather, maps, documents, and more
- `Discover / Call` is the default path; `Inspect` and `Probe` are conditional checks for missing/stale contracts, comparison, parameter validation, or a current quote
- For provider comparison, Inspect every candidate when current scope or a complete contract must be confirmed; a Discover summary is not confirmation. Probe every candidate when the comparison requires a current quote. Reuse may preserve an exact route, never business parameters or results: build parameters from the current request, and make a fresh Call for current, latest, today, or other time-sensitive data.
- `Discover` is free. `Call` returns structured pre-settlement billing, with final charge outcomes available through usage audit and credits ledger views.
- **NEW** `QVeris CLI` โ command-line access to professional data and tools for agents. [Learn more](#qveris-cli)
- Works with `CLI` / `MCP` / `Python SDK` / `REST API`
**When to use QVeris:** use it when built-in tools are insufficient, a provider must be found dynamically, comparison or fallback matters, or the user requests it. Keep using local or native tools when they already fit the task.
---
## Quick Start
### ๐ค I'm an Agent
> Your owner sent you here to learn about QVeris?
> โ If you are an OpenClaw-style skill agent, use the official skill: [skills/openclaw/qveris-official/SKILL.md](skills/openclaw/qveris-official/SKILL.md)
> โ If you are running in Cursor / Claude Code / OpenCode, follow the [Agent capability guide & install protocol](agent/SETUP.md)
> โ Default path: Discover (free) โ Call; use Inspect or Probe only when additional verification is needed
### ๐งโ๐ป I have OpenClaw / Cursor / Claude Code installed
> Copy this to your Agent โ done in 30 seconds:
> `Install QVeris skill following https://qveris.ai/skill/instruct.md and use QVERIS_API_KEY=your-key`
> โ [Get API Key](https://qveris.ai/account?page=api-keys) (free, 1,000 one-time trial credits after signup verification)
### โ๏ธ I'm a developer integrating via CLI / MCP / API / SDK
> โ **[QVeris CLI](packages/cli)** โ `npm install -g @qverisai/cli` or `curl -fsSL https://qveris.ai/cli/install | bash`
> โ [MCP Server Doc](docs/en-US/mcp-server.md)
> โ [REST API Doc](docs/en-US/rest-api.md)
> โ [Python SDK](packages/python-sdk)
---
## For Agents
If you are an AI Agent evaluating whether to use QVeris, here is what you need to know.
**What QVeris gives you:**
- `Discover` โ find candidate services with natural language (free)
- `Inspect` โ optionally check missing or stale parameters, available signals, and billing details
- `Call` โ invoke a selected service and receive structured results and pre-settlement billing when available
- `Usage audit` / `Credits ledger` โ review request and credit outcomes through the interfaces that expose them
- **QVeris CLI** โ access services via `qveris discover/inspect/call` without preloading the full service catalog
- Professional data and tools across finance, search, weather, maps, documents, social, blockchain, healthcare, and more
- Per-tool execution history, success-rate, and latency signals when supplied
**How to install:**
- **CLI (recommended)**: `curl -fsSL https://qveris.ai/cli/install | bash` โ then use `qveris discover/inspect/call`
- See [SETUP.md](agent/SETUP.md) โ supports OpenClaw / Claude Code / Cursor / OpenCode / Trae
- Install does not modify shell startup files by default (session-scoped)
- Must pass file checks + CLI verification to confirm success
**How to explain to your owner:**
> QVeris helps me find a service when the tools I already have are insufficient, review its supported scope when needed, and call it. Installation does not change system configuration unless explicitly requested. Call pricing and usage or credit records depend on the selected capability and supported interface.
**Billing and audit:**
- Discover: **free**
- Call: priced by structured `billing_rule`; call responses may include compact pre-settlement `billing`
- Final charge status: check `qveris usage` / `usage_history`
- Final balance movement: check `qveris ledger` / `credits_ledger`
- Free tier: 1,000 one-time trial credits after signup verification
- $19 = 10,000 credits (pay-as-you-go, credits never expire)
- Details: [qveris.ai/pricing](https://qveris.ai/pricing)
---
## 30-Second Setup
1. [Get API Key](https://qveris.ai/account?page=api-keys) (free, 1,000 one-time trial credits after signup verification)
### OpenClaw users
Send this to your Agent:
```
Install QVeris skill following https://qveris.ai/skill/instruct.md and use QVERIS_API_KEY=your-key
```
The Agent will download the [official OpenClaw skill](skills/openclaw/qveris-official/SKILL.md) and complete installation automatically.
### Cursor / Claude Code / OpenCode users
Follow the [setup guide (agent/SETUP.md)](agent/SETUP.md) โ your Agent will configure MCP server + [skill](skills/qveris/SKILL.md) for your environment.
#### Cursor Marketplace plugin
The Cursor plugin in this repository bundles the hosted QVeris MCP connection and the official QVeris skills. After installing it from Cursor Marketplace:
1. Open the plugin configuration and enter your `QVERIS_API_KEY`.
2. Start a new agent session so Cursor can connect to `https://mcp.qveris.ai/mcp`.
3. Confirm that `discover`, `inspect`, `probe`, `call`, `usage_history`, and `credits_ledger` are available.
The API key is stored by Cursor as a plugin variable and is never committed to this repository.
#### Gemini CLI extension
Install QVeris directly from this repository:
```bash
gemini extensions install https://github.com/QVerisAI/qveris-agent-toolkit
```
During installation, enter your `QVERIS_API_KEY` when prompted. Gemini CLI stores it as a sensitive extension setting and connects to the hosted QVeris MCP server at `https://mcp.qveris.ai/mcp`.
Restart Gemini CLI after installation, then run `/mcp` to confirm that the `qveris` server is connected and its tools are available.
### After setup
Try a task: "Check the current weather in Tokyo"
**Safety:**
- Install does not modify your shell config (unless you explicitly ask)
- Capability calls are remote API requests and do not grant a called service access to your local filesystem or system configuration
- You can review usage and credit records through supported interfaces
---
## QVeris CLI
**Access professional data and tools from your agent's shell.**
CLI executes as a subprocess and finds services on demand, without preloading the full service catalog. Instructions, commands, and results still consume context tokens. QVeris MCP likewise exposes a compact tool surface instead of every service definition.
```bash
# Install (one-liner)
curl -fsSL https://qveris.ai/cli/install | bash
# Or via npm
npm install -g @qverisai/cli
```
```bash
# Guided first call: `init` handles selection and validation for you
$ qveris init
# Default agent workflow: discover โ call
$ qveris discover "weather forecast API"
Found 5 capabilities matching your query
1. gridpoint_forecast by Weather.gov
params: wfo (string, required), x (number, required), y (number, required)
$ qveris call 1 --params '{"wfo":"LWX","x":90,"y":90}'
โ success
{ "forecast": "Sunny, high near 75..." }
# Optional when selection or request construction needs missing details
$ qveris inspect 1
# Optional when parameters need validation or a budget decision needs a current quote
$ qveris probe 1 --params '{"wfo":"LWX","x":90,"y":90}' --checks schema,quote
$ qveris usage --mode search --execution-id <execution_id>
# Confirms charge_outcome and actual_amount_credits for that call
```
### Why CLI over MCP for agents?
| | CLI | MCP |
|---|---|---|
| **Token cost** | No upfront catalog schemas; command/result tokens still apply | Depends on client context handling and exposed routing schemas |
| **Startup** | Instant (`npx` or global install) | Requires server process + transport handshake |
| **Output**
... (truncated)
voice
Comments
Sign in to leave a comment