TokenBel Financial Data

io.github.AndreiDrangPublished by GitHub account AndreiDrangv1.0.1Updated Oct 24, 2026

Read-only MCP server for Belarusian securities: tokens, shares, bonds, companies.

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Lets an assistant look up Belarusian tokenized securities, shares, bonds, company financials, exchange rates and news through read-only tools.

What you can do
Offers 19 read-only tools for browsing and looking up Belarusian tokenized securities, BCSE shares and bonds, including price, coupon, maturity, dividend events and trading-today status. It also covers a company catalogue, financial statement metrics, per-company token, share and bond lists, NBRB currency rates, trading statistics and entity news. Search tools resolve entities by ticker or by name, including UNP.
When to use it
Use it to research Belarusian securities: tokenized securities, BCSE shares and bonds, issuer financials, NBRB exchange rates and related news. It suits market research and data gathering, not placing orders or trading.
Requirements
Connects to a remote endpoint; no local package is needed. The input declares no authentication, environment variables or headers. Network access to that remote service is required.
Before you install
The input describes the server as read-only and shows no write, payment or credential requirements. Queries and entity identifiers are still sent to a third-party remote service, so avoid putting sensitive information in search terms.

Installation

In SourceWeft

  1. Open TokenBel Financial Data in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.AndreiDrang%2Ftokenbel-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "tokenbel-financial-data": {
      "type": "http",
      "url": "https://mcp.tokenbel.dev/mcp"
    }
  }
}

README

This repository has no README.

Tools

19

token_get_by_uuid

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

Parametersuuidrequired

token_list

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

Parameterslimitstatusplatformcursor_uuidcursor_created_at

share_get_by_uuid

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

Parametersuuidrequired

share_list

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}.

Parameterslimitis_tradingcursor_uuidissuer_uuidcursor_created_at

share_payouts_get

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"}.

Parametersuuidrequired

bond_get_by_uuid

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

Parametersuuidrequired

bond_list

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}.

Parameterslimitis_tradingcursor_uuidissuer_uuidcursor_created_at

company_get_by_uuid

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"}.

Parametersuuidrequired

company_list

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

Parameterslimitindustrycursor_uuidcursor_created_at

search_by_ticker

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"}.

Parameterslimitqueryrequired

search_by_name

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":"Агрофинанс"}.

Parameterslimitqueryrequired

currency_rate_get

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"}.

Parametersdatedate_tocurrencygroup_bydate_from

trading_stats_get

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"}.

Parametersuuidrequireddate_todate_from

token_trading_stats_get

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"}.

Parametersuuidrequireddate_todate_from

company_financial_params_get

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}.

Parametersuuidrequiredlimit_periods

company_tokens_list

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

Parametersuuidrequiredlimitcursor_uuidcursor_created_at

company_shares_list

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

Parametersuuidrequiredlimitcursor_uuidcursor_created_at

company_bonds_list

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

Parametersuuidrequiredlimitcursor_uuidcursor_created_at

entity_news_list

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"]}.

Parametersuuidrequiredlimitdate_todate_fromevent_typesimpact_typescursor_event_idcursor_published_at

Version history

2
  1. v1.0.1LatestSep 25, 2026
  2. v1.0.0Sep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.