Integrations
The official BCV rate wherever you need it. Everything is free, with no keys and the same data.
The data is published under CC BY 4.0: if you show it, credit the source.
All integrations
-
Web widget
AvailableToday's rate on your page with a single tag: a card, an inline pill or a converter to bolivars.
<script type="module" src="https://bcv.today/widget/v1.js"></script> <bcv-rate currency="USD"></bcv-rate>BCV dollar: 917.7751 Bs. Live, with today's rate -
Odoo
AvailableUpdates every company's rates daily, on Odoo.sh or on your own server.
-
WooCommerce and WordPress
In reviewShows the price in bolivars next to your store's price and saves the rate with every order.
-
JSON API
AvailableThe current rate, the daily history and the status as JSON files, for any language.
curl -s https://bcv.today/api/v1/rate.json -
Python
AvailableZero-dependency client with caching, Decimal and the bcv command.
pip install bcv -
JavaScript
AvailableTypeScript client for Node, Deno, Bun, browsers and Workers.
npm install bcv-today -
PHP
AvailableZero-dependency client for PHP 8.1+, with exact conversions and Laravel support.
composer require grupoclip/bcv-today -
Go
AvailableGo module using only the standard library, with exact conversions and the bcv command.
go get github.com/grupoclip/bcv-api/packages/go -
Ruby
Coming soonZero-dependency gem with exact conversions and the bcv command.
gem install bcv -
MCP server
AvailableRates, history and conversions as tools for Claude, ChatGPT, Cursor and other MCP clients.
https://mcp.bcv.today/mcp -
A2A agent
AvailableAn agent that answers other agents about rates and conversions, in Spanish or English.
https://mcp.bcv.today/a2a -
Markdown and llms.txt
AvailableEvery page as clean Markdown, plus a site index for language models.
Accept: text/markdown -
Telegram
AvailableThe @BCVTodayBot bot gives you the rate and converts amounts; the @bcvtoday channel posts the dollar every day.
/dollar · /convert 100 usd
Try it
A minimal example per integration, with today's rate.
curl: JSON API
Request
curl -s https://bcv.today/api/v1/rate.jsonResponse, trimmed200 · application/json
{
"USD": 917.7751,
"EUR": 1007.39583851,
…
"effective_date": "2026-11-19"
} Python: bcv library
Install
pip install bcvUsage
from bcv import BCV
bcv = BCV()
print(bcv.latest()["USD"]) # bolivars per dollar
print(bcv.convert(100, "USD", "VES").result)Output
917.7751
91777.51 JavaScript: bcv-today library
Install
npm install bcv-todayUsage
import { BCV } from "bcv-today";
const bcv = new BCV();
console.log((await bcv.latest()).rates.USD); // bolivars per dollar
console.log((await bcv.convert(100, "USD", "VES")).resultText);Output
917.7751
91777.51 PHP: grupoclip/bcv-today library
Install
composer require grupoclip/bcv-todayUsage
$bcv = new BcvToday\Bcv();
echo $bcv->latest()->rate('USD'), PHP_EOL; // bolivars per dollar
echo $bcv->convert('100', 'USD', 'VES')->result;Output
917.7751
91777.51 Odoo: l10n_ve_bcv_rate module
Install
Download it from Odoo Apps, copy it into your addons path, then Apps → search “BCV” → Activate.
Set up
- Settings → Accounting → BCV exchange rates
- Tick Automatic BCV rates, with the Daily interval
- Update now, or wait for the scheduled job
Result
Each company's USD, EUR, CNY, TRY and RUB rates, with the BCV value date as the rate date. Odoo 16–20, Community and Enterprise; not Odoo Online.
MCP: remote server
Claude Code
claude mcp add --transport http bcv-today https://mcp.bcv.today/mcpIn Claude Desktop and claude.ai: Settings → Connectors → Add custom connector, with the same URL.
Example conversation
- You
- What is the BCV dollar rate today?
- Claude
get_latest_ratesThe BCV dollar is at 917.7751 bolivars, with value date November 19, 2026.
A2A: Agent2Agent agent
Request
curl -s https://mcp.bcv.today/a2a \
-H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
-d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"role":"ROLE_USER","messageId":"1","parts":[{"text":"convert 100 USD to VES"}]}}}'Response, trimmed200 · application/json
{ "result": { "task": {
"status": { "state": "TASK_STATE_COMPLETED" },
"artifacts": [{ "name": "convert", "parts": [
{ "text": "100.00 USD = 91,777.51 VES at the official BCV rate (effective 2026-11-19; …)" },
{ "data": { "result": { "result": 91777.51, "rate": 917.7751 } } }
] }]
} } } Telegram: @BCVTodayBot bot and @bcvtoday channel
Bot
Open @BCVTodayBot in Telegram and send it a command, or just ask: “100 dollars in bolivars”.
Example conversation
- You
/dollar- BCV Today
- US dollar BCV: 917.7751 Bs. · Effective: November 19, 2026
- You
/convert 100 usd- BCV Today
- 100.00 USD = 91,777.51 Bs.
In any chat (inline mode)
@BCVTodayBot 100 usdOnly want the dollar rate every day? Join the @bcvtoday channel.
All of it is open source: bcv-api (site, API, MCP, A2A, widget and libraries) and odoo-bcv-rate (Odoo module), on GitHub. Missing an integration? Tell us.