TokenBel Financial Data

andreidrang/tokenbel-mcp

Pull live data on Belarusian securities markets without scraping or building your own data pipeline. This server connects to the Tokenbel platform and exposes read-only access to information about tokens, shares, bonds, and company profiles traded in Belarus. Reach for this when you're building financial analysis tools, portfolio trackers, or research applications that need structured access to Belarusian market data. The streamable HTTP transport means you can query it remotely without local installation, though details on specific endpoints and data schemas aren't provided in the source. Best suited for fintech projects focused on Eastern European markets.

tools: 19
transport: HTTP
last updated: Sep 25, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.tokenbel.dev/mcp --name tokenbel-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http tokenbel-mcp https://mcp.tokenbel.dev/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 19 tools

Verified live against the running server on Nov 6, 2026.

token_get_by_uuidGet a token's platform, sale status, price, rate and issuer. Tokens have no tickers; find the id with token_list. Example: {"uuid":"78c7e502"}.1 params

Get a token's platform, sale status, price, rate and issuer. Tokens have no tickers; find the id with token_list. Example: {"uuid":"78c7e502"}.

Parameters* required

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from token_list.

token_listBrowse active tokenized securities by platform or sale status; returns tokens and next_cursor. Tokens have no tickers. Example: {"platform":"finstore","limit":20}.5 params

Browse active tokenized securities by platform or sale status; returns tokens and next_cursor. Tokens have no tickers. Example: {"platform":"finstore","limit":20}.

Parameters* required

cursor_created_atstring

Timestamp after | in next_cursor; pass with cursor_uuid.

cursor_uuidstring

ID before | in next_cursor; pass with cursor_created_at.

limitinteger

Page size; default 50 (max 1000).

platformstring

Tokenization platform.one of fainex · finstore · bynex · whitebird

statusstring

Sale/circulation state; SELL_IN_PROGRESS is on sale, SOLD_OUT is fully sold, OBLIGATIONS_COMPLETED is repaid.one of SELL_NOT_STARTED · SELL_IN_PROGRESS · SELL_SUSPENDED · SOLD_OUT · SELL_ENDED · CIRCULATION_ENDED

share_get_by_uuidGet a BCSE share's ticker, issuer, nominal value and trading-today flag. Resolve tickers with search_by_ticker first. Example: {"uuid":"a97f1fed"}.1 params

Get a BCSE share's ticker, issuer, nominal value and trading-today flag. Resolve tickers with search_by_ticker first. Example: {"uuid":"a97f1fed"}.

Parameters* required

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from search_by_ticker.

share_listList active BCSE shares by issuer and trading-today status; returns shares and next_cursor. Use an issuer row from search_by_name. Example: {"issuer_uuid":"0d3bf3be","limit":20}.5 params

List active BCSE shares by issuer and trading-today status; returns shares and next_cursor. Use an issuer row from search_by_name. Example: {"issuer_uuid":"0d3bf3be","limit":20}.

Parameters* required

cursor_created_atstring

Timestamp after | in next_cursor; pass with cursor_uuid.

cursor_uuidstring

ID before | in next_cursor; pass with cursor_created_at.

is_tradingboolean

Traded today on BCSE, not historical liquidity.

issuer_uuidstring

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'.

limitinteger

Page size; default 50 (max 1000).

share_payouts_getGet a share's dividend events and declared-payout summary. dividend_yield_pct uses nominal value, not market price; no_dividend/cancelled events are excluded from money totals. Example: {"uuid":"a97f1fed"}.1 params

Get a share's dividend events and declared-payout summary. dividend_yield_pct uses nominal value, not market price; no_dividend/cancelled events are excluded from money totals. Example: {"uuid":"a97f1fed"}.

Parameters* required

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from search_by_ticker.

bond_get_by_uuidGet a BCSE bond's ticker, issuer, coupon, maturity and trading-today flag. Resolve tickers with search_by_ticker first. Example: {"uuid":"76f01f65"}.1 params

Get a BCSE bond's ticker, issuer, coupon, maturity and trading-today flag. Resolve tickers with search_by_ticker first. Example: {"uuid":"76f01f65"}.

Parameters* required

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Bond id from search_by_ticker.

bond_listList active BCSE bonds by issuer and trading-today status; returns bonds and next_cursor. Use an issuer row from search_by_name. Example: {"issuer_uuid":"45aca6f7","limit":20}.5 params

List active BCSE bonds by issuer and trading-today status; returns bonds and next_cursor. Use an issuer row from search_by_name. Example: {"issuer_uuid":"45aca6f7","limit":20}.

Parameters* required

cursor_created_atstring

Timestamp after | in next_cursor; pass with cursor_uuid.

cursor_uuidstring

ID before | in next_cursor; pass with cursor_created_at.

is_tradingboolean

Traded today on BCSE, not historical liquidity.

issuer_uuidstring

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'.

limitinteger

Page size; default 50 (max 1000).

company_get_by_uuidGet a company catalogue row, including name, UNP, industry and activity flag; includes inactive companies. Find company IDs with search_by_name. Example: {"uuid":"730f9a9e"}.1 params

Get a company catalogue row, including name, UNP, industry and activity flag; includes inactive companies. Find company IDs with search_by_name. Example: {"uuid":"730f9a9e"}.

Parameters* required

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='company'.

company_listBrowse active companies by industry; returns companies and next_cursor, not issuer rows. For issuers use search_by_name. Example: {"limit":20}.4 params

Browse active companies by industry; returns companies and next_cursor, not issuer rows. For issuers use search_by_name. Example: {"limit":20}.

Parameters* required

cursor_created_atstring

Timestamp after | in next_cursor; pass with cursor_uuid.

cursor_uuidstring

ID before | in next_cursor; pass with cursor_created_at.

industrystring

Exact company industry name.

limitinteger

Page size; default 50 (max 1000).

search_by_tickerFind BCSE shares/bonds by ticker substring; returns entity_type and TokenBel uuid for detail or trading tools. Tokens have no tickers. Example: {"query":"ASB"}.2 params

Find BCSE shares/bonds by ticker substring; returns entity_type and TokenBel uuid for detail or trading tools. Tokens have no tickers. Example: {"query":"ASB"}.

Parameters* required

limitinteger

Result cap; default 20 (max 100).default: 20

query*string

Case-insensitive share/bond ticker substring.

search_by_nameFind companies and securities issuers by name or UNP; results tag entity_type. Use company uuid for company_get_by_uuid, issuer uuid for share_list/bond_list; linked_company_uuid joins them when known. Example: {"query":"Агрофинанс"}.2 params

Find companies and securities issuers by name or UNP; results tag entity_type. Use company uuid for company_get_by_uuid, issuer uuid for share_list/bond_list; linked_company_uuid joins them when known. Example: {"query":"Агрофинанс"}.

Parameters* required

limitinteger

Result cap; default 20 (max 100).default: 20

query*string

Case-insensitive company/issuer name or Belarusian UNP.

currency_rate_getGet NBRB FX rates in BYN per 1 USD/EUR/RUB. No dates = latest; date = one day; date_from/date_to = range; group_by + both bounds = weekly/monthly averages. Example: {"currency":"usd","date":"2026-06-18"}.5 params

Get NBRB FX rates in BYN per 1 USD/EUR/RUB. No dates = latest; date = one day; date_from/date_to = range; group_by + both bounds = weekly/monthly averages. Example: {"currency":"usd","date":"2026-06-18"}.

Parameters* required

currencystring

Foreign currency; omit for all three. BYN is the base.one of usd · eur · rub

datestring

YYYY-MM-DD; cannot combine with range dates or group_by.

date_fromstring

Inclusive range start (YYYY-MM-DD); optional for open start.

date_tostring

Inclusive range end (YYYY-MM-DD); must be >= date_from.

group_bystring

Week/month average; requires both range dates.one of week · month

trading_stats_getGet share/bond trading totals and daily_series. No dates = latest 30 days; both dates = range (yield_wavg and *_latest are null). Find the id with search_by_ticker. Example: {"uuid":"a97f1fed","date_from":"2026-06-01","date_to":"2026-06-30"}.3 params

Get share/bond trading totals and daily_series. No dates = latest 30 days; both dates = range (yield_wavg and *_latest are null). Find the id with search_by_ticker. Example: {"uuid":"a97f1fed","date_from":"2026-06-01","date_to":"2026-06-30"}.

Parameters* required

date_fromstring

Inclusive YYYY-MM-DD start; supply both dates or neither.

date_tostring

Inclusive YYYY-MM-DD end (>= start); supply both dates or neither.

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share/bond id from search_by_ticker.

token_trading_stats_getGet a token's primary-market tokens-sold daily series, totals and snapshot; not secondary trading. No dates = last 30 days; either date bound is allowed. Find the id with token_list. Example: {"uuid":"78c7e502"}.3 params

Get a token's primary-market tokens-sold daily series, totals and snapshot; not secondary trading. No dates = last 30 days; either date bound is allowed. Find the id with token_list. Example: {"uuid":"78c7e502"}.

Parameters* required

date_fromstring

Inclusive YYYY-MM-DD start; defaults to 30 days before end.

date_tostring

Inclusive YYYY-MM-DD end (>= start); defaults to today.

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from token_list.

company_financial_params_getGet a company's financial statement metrics and ratios, newest periods first. Accepts a company or linked issuer id from search_by_name. Example: {"uuid":"311ff09f","limit_periods":4}.2 params

Get a company's financial statement metrics and ratios, newest periods first. Accepts a company or linked issuer id from search_by_name. Example: {"uuid":"311ff09f","limit_periods":4}.

Parameters* required

limit_periodsinteger

Newest periods to return; default 8 (max 100).

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.

company_tokens_listList a company's active token summary cards and next_cursor. Accepts a company or linked issuer id. Example: {"uuid":"7b860c81","limit":20}.4 params

List a company's active token summary cards and next_cursor. Accepts a company or linked issuer id. Example: {"uuid":"7b860c81","limit":20}.

Parameters* required

cursor_created_atstring

Timestamp after | in next_cursor; pass with cursor_uuid.

cursor_uuidstring

ID before | in next_cursor; pass with cursor_created_at.

limitinteger

Page size; default 50.

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.

company_shares_listList a company's active share summary cards and next_cursor. Accepts a company or linked issuer id. Example: {"uuid":"0d3bf3be","limit":20}.4 params

List a company's active share summary cards and next_cursor. Accepts a company or linked issuer id. Example: {"uuid":"0d3bf3be","limit":20}.

Parameters* required

cursor_created_atstring

Timestamp after | in next_cursor; pass with cursor_uuid.

cursor_uuidstring

ID before | in next_cursor; pass with cursor_created_at.

limitinteger

Page size; default 50.

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.

company_bonds_listList a company's active bond summary cards and next_cursor. Accepts a company or linked issuer id. Example: {"uuid":"0d3bf3be","limit":20}.4 params

List a company's active bond summary cards and next_cursor. Accepts a company or linked issuer id. Example: {"uuid":"0d3bf3be","limit":20}.

Parameters* required

cursor_created_atstring

Timestamp after | in next_cursor; pass with cursor_uuid.

cursor_uuidstring

ID before | in next_cursor; pass with cursor_created_at.

limitinteger

Page size; default 50.

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.

entity_news_listList published news across a company/issuer and linked securities; returns events with links, tags and next_cursor. Filter by event/impact type or date. Example: {"uuid":"f2c03989","impact_types":["negative"]}.8 params

List published news across a company/issuer and linked securities; returns events with links, tags and next_cursor. Filter by event/impact type or date. Example: {"uuid":"f2c03989","impact_types":["negative"]}.

Parameters* required

cursor_event_idstring

Numeric event ID before | in next_cursor; pass with cursor_published_at.

cursor_published_atstring

Sort timestamp after | in next_cursor; pass with cursor_event_id.

date_fromstring

Inclusive event date start (YYYY-MM-DD).

date_tostring

Inclusive event date end (YYYY-MM-DD).

event_typesarray

Types (case-insensitive): company_news, share_event, bond_event, token_event, emission_event, corporate_action, payment_event, default_risk, financial_report, regulatory_update, tax_update, market_...

impact_typesarray

Impact types: positive, neutral, negative, mixed; case-insensitive.

limitinteger

Page size; default 20 (max 50).

uuid*string

TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or issuer id from search_by_name.

Readme

Details

Repository: github.com/andreidrang/tokenbel-mcp
Transport: HTTP
Registry: MCP registry, active
Resources: 9
Prompts: 4
Tools verified: Nov 6, 2026