TokenBel Financial Data

currency_rate_get

Read-onlyIdempotent

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.

Input Schema

TableJSON Schema

Name	Required	Description
`date`	No	Single date in YYYY-MM-DD format. Mutually exclusive with date_from/date_to.
`date_to`	No	Range end date in YYYY-MM-DD format (inclusive, >= date_from). Open-ended or today-bounded ranges bypass cache.
`currency`	No	Filter to one supported foreign currency: usd, eur, or rub. Omit to return all three. BYN is the base currency, not a target.
`group_by`	No	Aggregate by week or month. Requires a date range (date_from/date_to), not a single date.
`date_from`	No	Range start date in YYYY-MM-DD format (inclusive). Can be omitted for open-start range.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`mode`	Yes
`count`	Yes
`date_to`	Yes
`results`	Yes
`currency`	Yes
`group_by`	No
`date_from`	Yes
`base_currency`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedSep 11, 2026

removedOutput schema / properties / date_from / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / date_from / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedOutput schema / properties / date_to / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / date_to / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / results / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "currency": {
-        "enum": [
-          "usd",
-          "eur",
-          "rub"
-        ],
-        "type": "string"
-      },
-      "rate": {
-        "type": "number"
-      },
-      "rate_date": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "currency",
-      "rate_date",
-      "rate"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "avg_rate": {
-        "type": "number"
-      },
-      "currency": {
-        "enum": [
-          "usd",
-          "eur",
-          "rub"
-        ],
-        "type": "string"
-      },
-      "data_points": {
-        "type": "number"
-      },
-      "expected_data_points": {
-        "type": "number"
-      },
-      "is_complete": {
-        "type": "boolean"
-      },
-      "max_rate": {
-        "type": "number"
-      },
-      "min_rate": {
-        "type": "number"
-      },
-      "period_start": {
-        "type": "string"
-      },
-      "period_type": {
-        "enum": [
-          "week",
-          "month"
-        ],
-        "type": "string"
-      },
-      "stddev_rate": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      }
-    },
-    "required": [
-      "currency",
-      "period_type",
-      "period_start",
-      "avg_rate",
-      "min_rate",
-      "max_rate",
-      "stddev_rate",
-      "data_points",
-      "expected_data_points",
-      "is_complete"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "currency": {
+        "enum": [
+          "usd",
+          "eur",
+          "rub"
+        ],
+        "type": "string"
+      },
+      "rate": {
+        "type": "number"
+      },
+      "rate_date": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "currency",
+      "rate_date",
+      "rate"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "avg_rate": {
+        "type": "number"
+      },
+      "currency": {
+        "enum": [
+          "usd",
+          "eur",
+          "rub"
+        ],
+        "type": "string"
+      },
+      "data_points": {
+        "type": "number"
+      },
+      "expected_data_points": {
+        "type": "number"
+      },
+      "is_complete": {
+        "type": "boolean"
+      },
+      "max_rate": {
+        "type": "number"
+      },
+      "min_rate": {
+        "type": "number"
+      },
+      "period_start": {
+        "type": "string"
+      },
+      "period_type": {
+        "enum": [
+          "week",
+          "month"
+        ],
+        "type": "string"
+      },
+      "stddev_rate": {
+        "type": [
+          "number",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "currency",
+      "period_type",
+      "period_start",
+      "avg_rate",
+      "min_rate",
+      "max_rate",
+      "stddev_rate",
+      "data_points",
+      "expected_data_points",
+      "is_complete"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedJun 26, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "base_currency": {
+      "type": "string"
+    },
+    "count": {
+      "type": "number"
+    },
+    "currency": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "date_from": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "date_to": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "group_by": {
+      "enum": [
+        "week",
+        "month"
+      ],
+      "type": "string"
+    },
+    "mode": {
+      "enum": [
+        "latest",
+        "single_date",
+        "range",
+        "grouped"
+      ],
+      "type": "string"
+    },
+    "results": {
+      "items": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "currency": {
+                "enum": [
+                  "usd",
+                  "eur",
+                  "rub"
+                ],
+                "type": "string"
+              },
+              "rate": {
+                "type": "number"
+              },
+              "rate_date": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "currency",
+              "rate_date",
+              "rate"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "avg_rate": {
+                "type": "number"
+              },
+              "currency": {
+                "enum": [
+                  "usd",
+                  "eur",
+                  "rub"
+                ],
+                "type": "string"
+              },
+              "data_points": {
+                "type": "number"
+              },
+              "expected_data_points": {
+                "type": "number"
+              },
+              "is_complete": {
+                "type": "boolean"
+              },
+              "max_rate": {
+                "type": "number"
+              },
+              "min_rate": {
+                "type": "number"
+              },
+              "period_start": {
+                "type": "string"
+              },
+              "period_type": {
+                "enum": [
+                  "week",
+                  "month"
+                ],
+                "type": "string"
+              },
+              "stddev_rate": {
+                "anyOf": [
+                  {
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "currency",
+              "period_type",
+              "period_start",
+              "avg_rate",
+              "min_rate",
+              "max_rate",
+              "stddev_rate",
+              "data_points",
+              "expected_data_points",
+              "is_complete"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "results",
+    "count",
+    "mode",
+    "base_currency",
+    "currency",
+    "date_from",
+    "date_to"
+  ],
+  "type": "object"
+}

Changed3 schema fields changedJun 25, 2026

changedInput schema / properties / currency / description

Previous value: -"Filter to a single currency (usd, eur, or rub). Omit to return all three."New value: +"Filter to one supported foreign currency: usd, eur, or rub. Omit to return all three. BYN is the base currency, not a target."

changedInput schema / properties / date_from / description

Previous value: -"Range start date in YYYY-MM-DD format (inclusive)."New value: +"Range start date in YYYY-MM-DD format (inclusive). Can be omitted for open-start range."

changedInput schema / properties / date_to / description

Previous value: -"Range end date in YYYY-MM-DD format (inclusive). Must be >= date_from."New value: +"Range end date in YYYY-MM-DD format (inclusive, >= date_from). Open-ended or today-bounded ranges bypass cache."

AddedJun 19, 2026

TDQS

A4.3/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnlyHint, idempotentHint), so the description is free to add domain behavior, and it does: the BYN-per-unit quote direction, BYN as implicit base, and the restriction to only usd/eur/rub. It adds no auth, rate-limit, or error behavior, which keeps it out of 5 territory.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four tight sentences with the highest-value facts (source, quote convention, mode selection, currency constraint) front-loaded and no filler. Every clause carries information an agent needs to construct a call.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values need no explanation, and the description fully covers the mode selection, parameter dependencies, currency constraints, and base-currency convention. Nothing an agent needs in order to invoke this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so each parameter already carries its own format, exclusivity, and dependency notes in the schema. The description's mode taxonomy largely restates those combinations rather than adding syntax or defaults the schema lacks, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (get NBRB official FX rates against BYN) and pins the exact supported currency set, so it cannot be confused with any of the sibling bond/share/company/news tools. The quote convention 'BYN per 1 unit of foreign currency' removes the main ambiguity an agent would otherwise face.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description enumerates the four usage modes (latest, single_date, range, grouped) and the parameter combination that selects each, which is real when-to-use guidance. It does not state exclusions or edge cases (e.g., how far back NBRB data goes, behavior on non-business days), so it stops short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All TokenBel Financial Data tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?