# TokenBel Financial Data MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-andreidrang-tokenbel-mcp
- Repository: https://github.com/AndreiDrang/tokenbel-mcp

## Install
- Endpoint: https://mcp.tokenbel.info/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.tokenbel.info/mcp

## Tools
- token_get_by_uuid - Get a single token by its TokenBel internal identifier (field name: uuid). Tokens are TokenBel-native tokenized corporate securities on fintech platforms (fainex/finstore/bynex/whitebird), not BCSE-listed tickers. Returns platform, lifecycle status, pricing, coupon rate, and company info. Endpoint: https://mcp.tokenbel.info/mcp
- token_list - List active tokens with optional filtering by fintech platform and token lifecycle status. Tokens do not have tickers; use this list tool to browse tokenized securities by platform/status. Supports cursor-based pagination. Endpoint: https://mcp.tokenbel.info/mcp
- share_get_by_uuid - Get a single BCSE exchange-listed share by its TokenBel internal identifier (field name: uuid). Returns ticker, issuer_uuid/issuer_name, share_kind (common/preferred), nominal value, lot size, and is_trading (traded today, not historical liquidity). Use search_by_ticker first when starting from a ticker. Endpoint: https://mcp.tokenbel.info/mcp
- share_list - List active BCSE exchange-listed shares with optional filtering by securities issuer TokenBel internal id (parameter name: issuer_uuid) and today-trading flag. Use issuer_uuid from search_by_name results where entity_type="issuer". Supports cursor-based pagination. Endpoint: https://mcp.tokenbel.info/mcp
- share_payouts_get - Get dividend/payout history and an aggregate summary for a single share by its TokenBel internal identifier (field name: uuid). Use search_by_ticker to find a share, then call this tool with the returned uuid value. Event period_type is annual/halfyear/quarterly. Event status meanings: declared = payout declared/expected/paid depending on dates, no_dividend = issuer declared no payout, cancelled = revoked. Summary money totals use declared events only. dividend_yield_pct is a nominal-based proxy (latest declared amount / nominal value * 100), not a market-price dividend yield. Endpoint: https://mcp.tokenbel.info/mcp
- bond_get_by_uuid - Get a single BCSE exchange-listed bond by its TokenBel internal identifier (field name: uuid). Returns ticker, issuer_uuid/issuer_name, bond_kind, current coupon/annual yield rate, payment type, maturity date, and is_trading (traded today). Use search_by_ticker first when starting from a ticker. Trading history is available via trading_stats_get; no separate bond payout schedule is exposed by this worker. Endpoint: https://mcp.tokenbel.info/mcp
- bond_list - List active BCSE exchange-listed bonds with optional filtering by securities issuer TokenBel internal id (parameter name: issuer_uuid) and today-trading flag. Use issuer_uuid from search_by_name results where entity_type="issuer". Supports cursor-based pagination. Endpoint: https://mcp.tokenbel.info/mcp
- company_get_by_uuid - Get a single company catalogue row by its TokenBel internal identifier (field name: uuid). Returns name, full_name, UNP (Belarusian tax ID), industry, logo, and activity flag. Companies are not always the same row as securities issuers; use search_by_name to discover both companies and issuers. Endpoint: https://mcp.tokenbel.info/mcp
- company_list - List active company catalogue rows with optional filtering by industry. This does not list security_issuer rows directly; use search_by_name to find issuers and then share_list/bond_list with issuer_uuid. Supports cursor-based pagination. Endpoint: https://mcp.tokenbel.info/mcp
- search_by_ticker - Search BCSE exchange-listed shares and bonds by ticker (case-insensitive substring match). Tokens are excluded because they do not have ticker symbols. Use the returned uuid value as an opaque TokenBel internal id (usually 8 hex chars, not an RFC UUID) with share_get_by_uuid/bond_get_by_uuid, share_payouts_get for share rows, or trading_stats_get for either share/bond row. Returns entity_type, ticker, issuer_uuid, issuer_name, and is_trading (traded today). Endpoint: https://mcp.tokenbel.info/mcp
- search_by_name - Search companies AND securities issuers by name, full name, or UNP (Belarusian tax ID). Results are tagged with entity_type: "company" (use company_get_by_uuid) or "issuer" (use uuid as issuer_uuid in share_list/bond_list). The returned uuid/issuer_uuid values are opaque TokenBel internal ids (usually 8 hex chars, not RFC UUIDs). Companies and issuers are different tables and may overlap; linked_company_uuid connects an issuer to a company when known. Endpoint: https://mcp.tokenbel.info/mcp
- currency_rate_get - Get NBRB (National Bank of Belarus) official FX rates against BYN (Belarusian ruble) for USD, EUR, and/or RUB. Rates are BYN per 1 unit of foreign currency. Modes: latest (no dates), single_date (date), range (date_from/date_to, either bound optional), or grouped weekly/monthly aggregates (group_by + range). Only usd/eur/rub are supported; BYN is the implicit base currency. Endpoint: https://mcp.tokenbel.info/mcp
- trading_stats_get - Get trading statistics for a BCSE exchange-listed share or bond by TokenBel internal identifier (field name: uuid). Use search_by_ticker first. Modes: latest_30d (default, no dates) reads the refreshed 30-day materialized view and includes latest price/yield plus yield_wavg; range (both date_from and date_to, YYYY-MM-DD, inclusive) aggregates raw trade history live and returns yield_min/yield_max only — yield_wavg and all *_latest fields are null in range mode. Omit both dates or provide both; one bound is rejected. Both modes also return daily_series: one point per trade_date (same-day buckets collapsed across market_type/trade_mode/payment_code) with per-day turnover, transactions, price_wavg/min/max, and yield_min/max — no range-level rollup. Endpoint: https://mcp.tokenbel.info/mcp
- token_trading_stats_get - Get primary-market sales statistics for a token by its TokenBel internal identifier (field name: uuid). Returns a per-day series of tokens sold (derived from the cumulative instrument_log.sold counter), range totals, and a token snapshot (status, token_price, percent_rate, sold_total, total_tokens, sold_pct). Find the id via token_list first. Always a date range: omit both dates for the last 30 days, or provide date_from and/or date_to. Secondary-market data is not included. Endpoint: https://mcp.tokenbel.info/mcp
- company_financial_params_get - Get financial parameters for a company or securities issuer by TokenBel internal identifier (field name: uuid). Returns periodic financial statement metrics (balance, equity, long/short-term assets and liabilities) and calculated financial ratios (liquidity, leverage, independence, stability, capitalization). Accepts a company id or an issuer id — issuer ids are resolved to their linked company. Find the id via search_by_name first. Endpoint: https://mcp.tokenbel.info/mcp
- company_tokens_list - List summary cards of a company's active tokens (emissions). Accepts a company OR issuer TokenBel id; resolves the company and returns its tokens. Endpoint: https://mcp.tokenbel.info/mcp
- company_shares_list - List summary cards of a company's active shares. Accepts a company OR issuer TokenBel id; resolves the company and returns its shares. Endpoint: https://mcp.tokenbel.info/mcp
- company_bonds_list - List summary cards of a company's active bonds. Accepts a company OR issuer TokenBel id; resolves the company and returns its bonds. Endpoint: https://mcp.tokenbel.info/mcp
- entity_news_list - List full published news events across a company's or issuer's full entity graph (the company, its security_issuers, their bonds/shares, and emissions under the company). Accepts a company OR issuer TokenBel id; resolves the entity and returns enriched news events with aggregated links and tags. Supports filtering by event_types, impact_types, and a date_from/date_to range, plus cursor-based pagination. Endpoint: https://mcp.tokenbel.info/mcp

## Resources
- tokenbel://schemas/token - token entity schema Field contract and lookup guidance for token. Read this before calling tools or entity resources to learn available fields and semantics. MIME type: application/json
- tokenbel://schemas/share - share entity schema Field contract and lookup guidance for share. Read this before calling tools or entity resources to learn available fields and semantics. MIME type: application/json
- tokenbel://schemas/bond - bond entity schema Field contract and lookup guidance for bond. Read this before calling tools or entity resources to learn available fields and semantics. MIME type: application/json
- tokenbel://schemas/company - company entity schema Field contract and lookup guidance for company. Read this before calling tools or entity resources to learn available fields and semantics. MIME type: application/json
- tokenbel://schemas/search-result - search-result entity schema Field contract and lookup guidance for search-result. Read this before calling tools or entity resources to learn available fields and semantics. MIME type: application/json
- tokenbel://schemas/trading-stats - trading-stats entity schema Field contract and lookup guidance for trading-stats. Read this before calling tools or entity resources to learn available fields and semantics. MIME type: application/json
- tokenbel://schemas/token-stats - token-stats entity schema Field contract and lookup guidance for token-stats. Read this before calling tools or entity resources to learn available fields and semantics. MIME type: application/json
- tokenbel://schemas/currency-rate - currency-rate entity schema Field contract and lookup guidance for currency-rate. Read this before calling tools or entity resources to learn available fields and semantics. MIME type: application/json
- tokenbel://schemas/company-financial-params - company-financial-params entity schema Field contract and lookup guidance for company-financial-params. Read this before calling tools or entity resources to learn available fields and semantics. MIME type: application/json

## Prompts
- get_company_all_financial_data - Get comprehensive financial data for a company including metrics, ratios, and historical periods
- get_company_share_trading_data - Get trading statistics and market data for shares issued by a company
- get_company_share_dividends_data - Get dividend history and payout information for shares issued by a company
- get_company_active_tokens_data - Get information about active tokenized securities issued by a company

## Metadata
- Owner: io.github.AndreiDrang
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 9, 2026
- Source: https://registry.modelcontextprotocol.io