---
title: "Integrations | BCV rate API, Python, Odoo, widget, MCP and Telegram · BCV Today"
description: "The official BCV rate wherever you need it. JSON API, Python, JavaScript and PHP libraries, Odoo module, web widget, WooCommerce, MCP server, A2A agent and Telegram bot, free and with no API keys."
url: "https://bcv.today/en/integrations/"
tokens: 1475
---

# 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](https://bcv.today/en/license/): if you show it, credit the source.

## All integrations
All Business Code AI People Coming soon

-    <bcv-rate>
### Web widget
Available
Today'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>`
```

[Source code](https://github.com/grupoclip/bcv-api/tree/main/packages/widget)
BCV dollar: 917.7751 Bs. Live, with today's rate
-
### Odoo
Available
`l10n_ve_bcv_rate` · Odoo 16–20 · Community and Enterprise

Updates every company's rates daily, on Odoo.sh or on your own server.

[Odoo Apps](https://apps.odoo.com/apps/modules/l10n_ve_bcv_rate)[Source code](https://github.com/grupoclip/odoo-bcv-rate)[Guide](https://bcv.today/en/api/#odoo)

-
### WooCommerce and WordPress
In review
bcv-today plugin

Shows the price in bolivars next to your store's price and saves the rate with every order.

[Source code](https://github.com/grupoclip/wp-bcv-today)

-   { }
### JSON API
Available
HTTP · no key

The current rate, the daily history and the status as JSON files, for any language.

```
`curl -s https://bcv.today/api/v1/rate.json`
```

[Documentation](https://bcv.today/en/api/)[OpenAPI](https://bcv.today/openapi.json)

-
### Python
Available
`bcv` · Python 3.9+

Zero-dependency client with caching, Decimal and the bcv command.

```
`pip install bcv`
```

[PyPI](https://pypi.org/project/bcv/)[Guide](https://bcv.today/en/api/#python-library)[Source code](https://github.com/grupoclip/bcv-api/tree/main/packages/python)

-
### JavaScript
Available
`bcv-today` · TypeScript

TypeScript client for Node, Deno, Bun, browsers and Workers.

```
`npm install bcv-today`
```

[npm](https://www.npmjs.com/package/bcv-today)[Guide](https://bcv.today/en/api/#javascript)[Source code](https://github.com/grupoclip/bcv-api/tree/main/packages/js)

-
### PHP
Available
`grupoclip/bcv-today` · PHP 8.1+

Zero-dependency client for PHP 8.1+, with exact conversions and Laravel support.

```
`composer require grupoclip/bcv-today`
```

[Packagist](https://packagist.org/packages/grupoclip/bcv-today)[Source code](https://github.com/grupoclip/bcv-api/tree/main/packages/php)

-
### Go
Available
`packages/go` · Go 1.22+

Go module using only the standard library, with exact conversions and the bcv command.

```
`go get github.com/grupoclip/bcv-api/packages/go`
```

[pkg.go.dev](https://pkg.go.dev/github.com/grupoclip/bcv-api/packages/go)[Source code](https://github.com/grupoclip/bcv-api/tree/main/packages/go)

-
### Ruby
Coming soon
`bcv` · Ruby 3.1+

Zero-dependency gem with exact conversions and the bcv command.

```
`gem install bcv`
```

-
### MCP server
Available
Streamable HTTP

Rates, history and conversions as tools for Claude, ChatGPT, Cursor and other MCP clients.

```
`https://mcp.bcv.today/mcp`
```

[How to connect it](https://bcv.today/en/api/#mcp-server)[Server card](https://bcv.today/.well-known/mcp/server-card.json)

-   A2A
### A2A agent
Available
JSON-RPC 2.0 · A2A 1.0

An agent that answers other agents about rates and conversions, in Spanish or English.

```
`https://mcp.bcv.today/a2a`
```

[How to use it](https://bcv.today/en/api/#a2a-agent)[Agent card](https://bcv.today/.well-known/agent-card.json)

-
### Markdown and llms.txt
Available
text/markdown · text/plain

Every page as clean Markdown, plus a site index for language models.

```
`Accept: text/markdown`
```

[llms.txt](https://bcv.today/llms.txt)[Home page in Markdown](https://bcv.today/en/index.md)

-
### Telegram
Available
bot · channel

The @BCVTodayBot bot gives you the rate and converts amounts; the @bcvtoday channel posts the dollar every day.

```
`/dollar · /convert 100 usd`
```

[Open @BCVTodayBot](https://t.me/BCVTodayBot)[@bcvtoday channel](https://t.me/bcvtoday)

## Try it

A minimal example per integration, with today's rate.
curl Python JavaScript PHP Odoo MCP A2A Telegram
### curl: JSON API

Request

```
`curl -s https://bcv.today/api/v1/rate.json`
```

Response, trimmed200 · application/json

```
`{
  "USD": 917.7751,
  "EUR": 1007.39583851,
  …
  "effective_date": "2026-11-19"
}`
```

[API documentation →](https://bcv.today/en/api/)[OpenAPI](https://bcv.today/openapi.json)

### Python: bcv library

Install

```
`pip install bcv`
```

Usage

```
`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`
```

[Python guide →](https://bcv.today/en/api/#python-library)[PyPI](https://pypi.org/project/bcv/)

### JavaScript: bcv-today library

Install

```
`npm install bcv-today`
```

Usage

```
`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`
```

[JavaScript guide →](https://bcv.today/en/api/#javascript)[npm](https://www.npmjs.com/package/bcv-today)

### PHP: grupoclip/bcv-today library

Install

```
`composer require grupoclip/bcv-today`
```

Usage

```
`$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`
```

[Packagist →](https://packagist.org/packages/grupoclip/bcv-today)[Source code](https://github.com/grupoclip/bcv-api/tree/main/packages/php)

### Odoo: l10n_ve_bcv_rate module

Install

Download it from [Odoo Apps](https://apps.odoo.com/apps/modules/l10n_ve_bcv_rate), 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.

[View on Odoo Apps →](https://apps.odoo.com/apps/modules/l10n_ve_bcv_rate)[Guide](https://bcv.today/en/api/#odoo)

### MCP: remote server

Claude Code

```
`claude mcp add --transport http bcv-today https://mcp.bcv.today/mcp`
```

In 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_rates` The BCV dollar is at **917.7751** bolivars, with value date November 19, 2026.
[How to connect it →](https://bcv.today/en/api/#mcp-server)[Server card](https://bcv.today/.well-known/mcp/server-card.json)

### 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 } } }
  ] }]
} } }`
```

[How to use it →](https://bcv.today/en/api/#a2a-agent)[Agent card](https://bcv.today/.well-known/agent-card.json)

### Telegram: @BCVTodayBot bot and @bcvtoday channel

Bot

Open [@BCVTodayBot](https://t.me/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 usd`
```

Only want the dollar rate every day? Join the [@bcvtoday](https://t.me/bcvtoday) channel.

[Open the bot →](https://t.me/BCVTodayBot)[@bcvtoday channel](https://t.me/bcvtoday)

All of it is open source: [bcv-api](https://github.com/grupoclip/bcv-api) (site, API, MCP, A2A, widget and libraries) and [odoo-bcv-rate](https://github.com/grupoclip/odoo-bcv-rate) (Odoo module), on GitHub. Missing an integration? [Tell us](https://github.com/grupoclip/bcv-api/issues/new/choose).

```json
{
            "@context": "https://schema.org",
            "@type": "Organization",
            "@id": "https://bcv.today/#organization",
            "name": "BCV Today",
            "url": "https://bcv.today/",
            "logo": "https://bcv.today/assets/icon-512.png",
            "sameAs": [
                "https://github.com/grupoclip/bcv-api"
            ]
        }
{
            "@context": "https://schema.org",
            "@type": "WebSite",
            "@id": "https://bcv.today/#website",
            "name": "BCV Today",
            "alternateName": [
                "BCVHoy",
                "BCV hoy"
            ],
            "url": "https://bcv.today/",
            "description": "Tasas oficiales del Banco Central de Venezuela, hoy. USD, EUR, CNY, TRY y RUB contra el bolívar, actualizadas a diario.",
            "inLanguage": [
                "es-VE",
                "en-US"
            ],
            "publisher": {
                "@id": "https://bcv.today/#organization"
            },
            "potentialAction": {
                "@type": "SearchAction",
                "target": "https://bcv.today/en/history/?c={search_term_string}",
                "query-input": "required name=search_term_string"
            }
        }
{
            "@context": "https://schema.org",
            "@type": "WebPage",
            "@id": "https://bcv.today/en/integrations/#webpage",
            "url": "https://bcv.today/en/integrations/",
            "name": "Integrations | BCV rate API, Python, Odoo, widget, MCP and Telegram",
            "description": "The official BCV rate wherever you need it. JSON API, Python, JavaScript and PHP libraries, Odoo module, web widget, WooCommerce, MCP server, A2A agent and Telegram bot, free and with no API keys.",
            "isPartOf": {
                "@id": "https://bcv.today/#website"
            },
            "publisher": {
                "@id": "https://bcv.today/#organization"
            },
            "inLanguage": "en-US"
        }
{
            "@context": "https://schema.org",
            "@type": "BreadcrumbList",
            "@id": "https://bcv.today/en/integrations/#breadcrumb",
            "itemListElement": [
                {
                    "@type": "ListItem",
                    "position": 1,
                    "name": "BCV Today",
                    "item": "https://bcv.today/en/"
                },
                {
                    "@type": "ListItem",
                    "position": 2,
                    "name": "Integrations | BCV rate API, Python, Odoo, widget, MCP and Telegram",
                    "item": "https://bcv.today/en/integrations/"
                }
            ]
        }
```
