io.github.AndreiDrang/tokenbel-mcp

TokenBel Financial Data

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

1.0.1
Version
remote
Transport
19
Tools

Security review

Review passed

Reviewed Jan 1, 2000.

  • tools: 19 tools scanned
  • metadata: scanned

No findings.

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

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

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

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

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

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

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

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

  • company_list

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

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

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

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

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

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

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

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

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

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

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