Servers Playground How we check Add a server Log in

TokenBel Financial Data

Working · 2.0 s

io.github.AndreiDrang/tokenbel-mcpv1.0.1

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

Finance & Payments

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.tokenbel.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

bond_get_by_uuid Read-only

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

uuidstring, required

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

TokenBel Financial Data MCP server | mcptry

Tools (19)

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Bond id from search_by_ticker.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Bond id from search_by_ticker."
    }
  }
}

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

read-only

Argument	Type	Description
limit	integer	Page size; default 50 (max 1000).
is_trading	boolean	Traded today on BCSE, not historical liquidity.
cursor_uuid	string	ID before \| in next_cursor; pass with cursor_created_at.
issuer_uuid	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'.
cursor_created_at	string	Timestamp after \| in next_cursor; pass with cursor_uuid.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Page size; default 50 (max 1000)."
    },
    "is_trading": {
      "type": "boolean",
      "description": "Traded today on BCSE, not historical liquidity."
    },
    "cursor_uuid": {
      "type": "string",
      "description": "ID before | in next_cursor; pass with cursor_created_at."
    },
    "issuer_uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'."
    },
    "cursor_created_at": {
      "type": "string",
      "description": "Timestamp after | in next_cursor; pass with cursor_uuid."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.
limit	integer	Page size; default 50.
cursor_uuid	string	ID before \| in next_cursor; pass with cursor_created_at.
cursor_created_at	string	Timestamp after \| in next_cursor; pass with cursor_uuid.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name."
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Page size; default 50.",
      "exclusiveMinimum": 0
    },
    "cursor_uuid": {
      "type": "string",
      "description": "ID before | in next_cursor; pass with cursor_created_at."
    },
    "cursor_created_at": {
      "type": "string",
      "description": "Timestamp after | in next_cursor; pass with cursor_uuid."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.
limit_periods	integer	Newest periods to return; default 8 (max 100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name."
    },
    "limit_periods": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Newest periods to return; default 8 (max 100)."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='company'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='company'."
    }
  }
}

company_list

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

read-only

Argument	Type	Description
limit	integer	Page size; default 50 (max 1000).
industry	string	Exact company industry name.
cursor_uuid	string	ID before \| in next_cursor; pass with cursor_created_at.
cursor_created_at	string	Timestamp after \| in next_cursor; pass with cursor_uuid.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Page size; default 50 (max 1000)."
    },
    "industry": {
      "type": "string",
      "description": "Exact company industry name."
    },
    "cursor_uuid": {
      "type": "string",
      "description": "ID before | in next_cursor; pass with cursor_created_at."
    },
    "cursor_created_at": {
      "type": "string",
      "description": "Timestamp after | in next_cursor; pass with cursor_uuid."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.
limit	integer	Page size; default 50.
cursor_uuid	string	ID before \| in next_cursor; pass with cursor_created_at.
cursor_created_at	string	Timestamp after \| in next_cursor; pass with cursor_uuid.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name."
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Page size; default 50.",
      "exclusiveMinimum": 0
    },
    "cursor_uuid": {
      "type": "string",
      "description": "ID before | in next_cursor; pass with cursor_created_at."
    },
    "cursor_created_at": {
      "type": "string",
      "description": "Timestamp after | in next_cursor; pass with cursor_uuid."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name.
limit	integer	Page size; default 50.
cursor_uuid	string	ID before \| in next_cursor; pass with cursor_created_at.
cursor_created_at	string	Timestamp after \| in next_cursor; pass with cursor_uuid.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or linked issuer id from search_by_name."
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Page size; default 50.",
      "exclusiveMinimum": 0
    },
    "cursor_uuid": {
      "type": "string",
      "description": "ID before | in next_cursor; pass with cursor_created_at."
    },
    "cursor_created_at": {
      "type": "string",
      "description": "Timestamp after | in next_cursor; pass with cursor_uuid."
    }
  }
}

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

read-only

Argument	Type	Description
date	string	YYYY-MM-DD; cannot combine with range dates or group_by.
date_to	string	Inclusive range end (YYYY-MM-DD); must be >= date_from.
currency	string	Foreign currency; omit for all three. BYN is the base.
group_by	string	Week/month average; requires both range dates.
date_from	string	Inclusive range start (YYYY-MM-DD); optional for open start.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD; cannot combine with range dates or group_by."
    },
    "date_to": {
      "type": "string",
      "description": "Inclusive range end (YYYY-MM-DD); must be >= date_from."
    },
    "currency": {
      "enum": [
        "usd",
        "eur",
        "rub"
      ],
      "type": "string",
      "description": "Foreign currency; omit for all three. BYN is the base."
    },
    "group_by": {
      "enum": [
        "week",
        "month"
      ],
      "type": "string",
      "description": "Week/month average; requires both range dates."
    },
    "date_from": {
      "type": "string",
      "description": "Inclusive range start (YYYY-MM-DD); optional for open start."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Company or issuer id from search_by_name.
limit	integer	Page size; default 20 (max 50).
date_to	string	Inclusive event date end (YYYY-MM-DD).
date_from	string	Inclusive event date start (YYYY-MM-DD).
event_types	array	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_infrastructure, deposit_event, precious_metal_event, currency_market_event, market_data, other.
impact_types	array	Impact types: positive, neutral, negative, mixed; case-insensitive.
cursor_event_id	string	Numeric event ID before \| in next_cursor; pass with cursor_published_at.

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

read-only

Argument	Type	Description
limit	integer	Result cap; default 20 (max 100).
query*	string	Case-insensitive company/issuer name or Belarusian UNP.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Result cap; default 20 (max 100)."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Case-insensitive company/issuer name or Belarusian UNP."
    }
  }
}

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

read-only

Argument	Type	Description
limit	integer	Result cap; default 20 (max 100).
query*	string	Case-insensitive share/bond ticker substring.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Result cap; default 20 (max 100)."
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Case-insensitive share/bond ticker substring."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from search_by_ticker.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from search_by_ticker."
    }
  }
}

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

read-only

Argument	Type	Description
limit	integer	Page size; default 50 (max 1000).
is_trading	boolean	Traded today on BCSE, not historical liquidity.
cursor_uuid	string	ID before \| in next_cursor; pass with cursor_created_at.
issuer_uuid	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'.
cursor_created_at	string	Timestamp after \| in next_cursor; pass with cursor_uuid.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Page size; default 50 (max 1000)."
    },
    "is_trading": {
      "type": "boolean",
      "description": "Traded today on BCSE, not historical liquidity."
    },
    "cursor_uuid": {
      "type": "string",
      "description": "ID before | in next_cursor; pass with cursor_created_at."
    },
    "issuer_uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). From search_by_name entity_type='issuer'."
    },
    "cursor_created_at": {
      "type": "string",
      "description": "Timestamp after | in next_cursor; pass with cursor_uuid."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from search_by_ticker.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share id from search_by_ticker."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from token_list.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from token_list."
    }
  }
}

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

read-only

Argument	Type	Description
limit	integer	Page size; default 50 (max 1000).
status	string	Sale/circulation state; SELL_IN_PROGRESS is on sale, SOLD_OUT is fully sold, OBLIGATIONS_COMPLETED is repaid.
platform	string	Tokenization platform.
cursor_uuid	string	ID before \| in next_cursor; pass with cursor_created_at.
cursor_created_at	string	Timestamp after \| in next_cursor; pass with cursor_uuid.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Page size; default 50 (max 1000)."
    },
    "status": {
      "enum": [
        "SELL_NOT_STARTED",
        "SELL_IN_PROGRESS",
        "SELL_SUSPENDED",
        "SOLD_OUT",
        "SELL_ENDED",
        "CIRCULATION_ENDED",
        "OBLIGATIONS_COMPLETED"
      ],
      "type": "string",
      "description": "Sale/circulation state; SELL_IN_PROGRESS is on sale, SOLD_OUT is fully sold, OBLIGATIONS_COMPLETED is repaid."
    },
    "platform": {
      "enum": [
        "fainex",
        "finstore",
        "bynex",
        "whitebird"
      ],
      "type": "string",
      "description": "Tokenization platform."
    },
    "cursor_uuid": {
      "type": "string",
      "description": "ID before | in next_cursor; pass with cursor_created_at."
    },
    "cursor_created_at": {
      "type": "string",
      "description": "Timestamp after | in next_cursor; pass with cursor_uuid."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from token_list.
date_to	string	Inclusive YYYY-MM-DD end (>= start); defaults to today.
date_from	string	Inclusive YYYY-MM-DD start; defaults to 30 days before end.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Token id from token_list."
    },
    "date_to": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD end (>= start); defaults to today."
    },
    "date_from": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD start; defaults to 30 days before end."
    }
  }
}

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

read-only

Argument	Type	Description
uuid*	string	TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share/bond id from search_by_ticker.
date_to	string	Inclusive YYYY-MM-DD end (>= start); supply both dates or neither.
date_from	string	Inclusive YYYY-MM-DD start; supply both dates or neither.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "TokenBel id (usually 8 hex chars, no hyphens; not an RFC UUID). Share/bond id from search_by_ticker."
    },
    "date_to": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD end (>= start); supply both dates or neither."
    },
    "date_from": {
      "type": "string",
      "description": "Inclusive YYYY-MM-DD start; supply both dates or neither."
    }
  }
}