mcpField
E
exchange-rate

exchange-rate

github.com/qverisaiOther2093 installsUpdated 6w ago
Repository

About exchange-rate

exchange-rate is a skill for looking up current currency rates and converting amounts through QVeris. It discovers tools by capability and can try alternative providers when a request fails.

Key features

  1. 01Current currency-rate lookup
  2. 02Amount conversion at current rates
  3. 03Optional historical date queries
  4. 04Provider fallback on failure
  5. 05Markdown or JSON output

Use cases

  1. 01Check a rate before a trip
  2. 02Convert amounts for trade records
  3. 03Prepare currency figures for reports

MCP support

Uses QVeris tools to search for currency-rate or conversion capabilities, then executes a selected tool; it is not described as an MCP server.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/qverisai/open-qveris-skills --skill exchange-rate

After installing, type/exchange-ratein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
README.md
scripts/
exchange_rate.mjs

Details

From the project README

Exchange Rate

Real-time currency exchange rate and conversion using QVeris tools.

What This Skill Does

Exchange Rate provides:

  1. Rate lookup – Current exchange rate between two currencies (e.g. USD/EUR, CNY/JPY).
  2. Amount conversion – Convert an amount from one currency to another at current rates.

Supported via QVeris: forex and common fiat pairs; optional historical date for rate/conversion when the tool supports it.

Key Advantages

  • Uses only QVeris API: search for tools by capability, then execute; no hardcoded provider list.
  • Fallback across providers (e.g. Alpha Vantage, Twelve Data) when one fails or is unavailable.
  • Same credential as other skills: QVERIS_API_KEY only.
  • Read-only, no side effects; suitable for travel, trade, and reporting.

Core Workflow

  1. Parse user intent: rate (from_currency, to_currency) or convert (from_currency, to_currency, amount).
  2. Search QVeris for tools: e.g. "currency exchange rate real-time", "currency conversion".
  3. Rank results by success_rate, latency, and parameter fit (rate vs conversion).
  4. Build request parameters: for rate use from_currency/to_currency or symbol (e.g. EUR/USD); for conversion add amount.
  5. Execute chosen tool with 5s timeout; on failure try next candidate.
  6. Return formatted rate and/or converted amount (markdown or JSON).

Command Surface

Primary script: scripts/exchange_rate.mjs

  • Get rate only:
    • node scripts/exchange_rate.mjs rate --from USD --to EUR
    • node scripts/exchange_rate.mjs rate --from CNY --to USD
  • Convert amount:
    • node scripts/exchange_rate.mjs convert --from USD --to JPY --amount 1000
    • node scripts/exchange_rate.mjs convert --from EUR --to GBP --amount 500

Optional: --date YYYY-MM-DD for historical rate/conversion when the tool supports it; --format json for machine-readable output.

Safety and Disclosure

  • Uses only QVERIS_API_KEY; no other secrets.
  • Calls only QVeris over HTTPS; no package install or arbitrary commands.
  • Output is for reference only; not financial or contractual advice.

Comments

Markdown supported