io.github.malkreide/swiss-snb-mcp

Convert a foreign currency amount to CHF using official SNB exchange rates. Uses the monthly average rate (Monatsmittel) from the SNB data portal. Suitable for budget calculations, cost estimations, and financial planning. Args: params (ConvertCurrencyInput): - amount: Amount in foreign currency to convert. - currency_id: SNB currency ID (e.g. 'EUR1', 'USD1', 'JPY100'). - reference_month: Month YYYY-MM for the rate. Default: most recent. Returns: str: CHF equivalent, exchange rate used, and reference date. Example: amount=45000, currency_id='USD1' → CHF equivalent of USD 45,000 amount=100, currency_id='JPY100' → CHF equivalent of JPY 100

Retrieve annual average CHF exchange rates from the SNB (cube 'devkua'). Returns yearly average exchange rates for all major currencies against CHF. Useful for multi-year trend analysis, budget planning, and financial reporting. Data goes back to 1980 for most currencies. Args: params (AnnualExchangeRatesInput): - currencies: List of currency IDs (e.g. ['EUR1', 'USD1']). Default: all. - from_year: Start year, e.g. '2015'. Default: 5 years ago. - to_year: End year, e.g. '2025'. Default: current year. - lang: Response language. Default: de. Returns: str: Markdown summary and JSON data with annual exchange rates.

Retrieve balance-of-payments or international investment position data. Categories: - overview: Zahlungsbilanz — Übersicht (cube bopoverq) - iip: Auslandvermögen — Komponenten (cube auvekomq) Args: params (BalanceOfPaymentsInput): - category: 'overview' or 'iip'. - from_date: Start date, e.g. '2020-Q1' or '2020'. - to_date: End date. - lang: Response language (de/en/fr). Returns: str: Markdown summary with JSON data.

Retrieve SNB balance sheet (Bilanz) data from the data portal (cube 'snbbipo'). Returns monthly balance sheet positions of the Swiss National Bank in millions of CHF. Covers assets (gold, foreign exchange reserves, repos) and liabilities (banknotes in circulation, sight deposits of domestic banks, government deposits). Key positions: - GFG: Gold und Forderungen aus Goldgeschäften - D: Devisenanlagen (foreign exchange reserves — the world's largest relative to GDP) - N: Notenumlauf (banknotes in circulation) - GB: Girokonten inländischer Banken (sight deposits) - T0/T1: Total Aktiven / Total Passiven Args: params (BalanceSheetInput): - positions: List of position IDs. Default: key positions (GFG, D, N, GB, T0, T1). - from_date: Start month YYYY-MM. Default: 24 months ago. - to_date: End month YYYY-MM. Default: latest available. - lang: Response language. Default: de. Returns: str: Markdown summary and JSON data in millions CHF.

Retrieve banking balance sheet data from SNB Warehouse (BSTA BIL cubes). Returns total assets and/or liabilities for selected bank groups from the Swiss banking statistics. Values are converted to millions of CHF. Args: params (BankingBalanceSheetInput): - side: 'assets', 'liabilities', or 'both'. - bank_groups: Bank group IDs (default: ['A30'] = all banks). - frequency: 'annual' or 'monthly'. - currency: Currency filter (default: 'T' = Total). - from_date / to_date: Date range. - lang: Response language. Returns: str: Markdown summary with values in Millionen CHF, plus JSON data.

Retrieve banking income statement data from SNB Warehouse (BSTA EFR cubes). Returns key income statement positions (Geschäftsertrag, Geschäftsaufwand, etc.) for selected bank groups. Values are converted to millions of CHF. Args: params (BankingIncomeInput): - bank_groups: Bank group IDs (default: ['A30'] = all banks). - from_year / to_year: Year range (YYYY). - lang: Response language. Returns: str: Markdown summary with values in Millionen CHF, plus JSON data.

Retrieve raw data from any SNB data cube by ID. Generic tool for accessing SNB cubes beyond the dedicated tools. Use snb_get_cube_metadata first to understand the cube structure. Browse https://data.snb.ch to discover cube IDs from the URL pattern: data.snb.ch/de/topics/{topic}/cube/{cubeId} Args: params (CubeDataInput): - cube_id: SNB cube identifier (lowercase), e.g. 'devkum', 'snbbipo'. - from_date: Start date (YYYY-MM for monthly, YYYY for annual). - to_date: End date. - lang: Response language (de/en/fr). Returns: str: Raw timeseries data from the cube as JSON.

Get metadata and dimension structure for any SNB data cube. Retrieves the cube's dimension definitions, available filter values, and structure. Use this before querying snb_get_cube_data to understand what parameters and filters are available. Args: params (CubeMetadataInput): - cube_id: SNB cube identifier, e.g. 'devkum', 'snbbipo'. - lang: Language for labels (de/en/fr). Returns: str: Cube ID, dimensions, and all available dimension item IDs with labels.

Retrieve monthly CHF exchange rates from the Swiss National Bank (data.snb.ch). Returns monthly average rates (and optionally month-end rates) for all major currencies against the Swiss Franc (CHF). Data source: SNB cube 'devkum'. Rates are expressed as the CHF value of the stated foreign currency unit (e.g. EUR1: 1 EUR = 0.9416 CHF; JPY100: 100 JPY = 0.58 CHF). Args: params (ExchangeRatesInput): - currencies: List of currency IDs (e.g. ['EUR1', 'USD1']). Default: all. - from_date: Start month YYYY-MM. Default: 12 months ago. - to_date: End month YYYY-MM. Default: current month. - include_month_end: Also include month-end rates. Default: False. - lang: Response language (de/en/fr). Default: de. Returns: str: Markdown table with dates and CHF exchange rates per currency. Includes publication date and data source metadata. Schema: { "cube_id": "devkum", "publishing_date": "YYYY-MM-DD HH:MM", "currencies_returned": int, "timeseries": [ { "currency": str, "type": "Monatsmittel" | "Monatsende", "unit": str, "values": [{"date": "YYYY-MM", "value": float}] } ] }

Retrieve raw data from any SNB Warehouse cube by ID. Generic tool for accessing SNB Warehouse cubes (BSTA banking statistics). Use snb_get_warehouse_metadata first to understand the cube structure. Use snb_list_warehouse_cubes to discover available cube IDs. Args: params (WarehouseDataInput): - cube_id: SNB Warehouse cube ID (uppercase, dot-separated). - from_date: Start date (YYYY for annual, YYYY-MM for monthly). - to_date: End date. - lang: Response language (de/en/fr). Returns: str: Timeseries data from the warehouse cube as Markdown + JSON.

Get metadata and dimension structure for any SNB Warehouse cube. Retrieves the cube's dimension definitions and last update date. Use this before querying snb_get_warehouse_data to understand what dimensions and filter values are available. Args: params (WarehouseMetadataInput): - cube_id: SNB Warehouse cube ID to inspect. - lang: Language for labels (de/en/fr). Returns: str: Cube ID, edition date, dimensions and their items.