Currency Exchange

Official7 toolsLive

by Publifye · Python

Norges Bank exchange rates for AI: 38 currencies against NOK since ~1980, plus buying power

Norges Bank exchange-rate data served for AI use. The server provides rates covering 38 currencies versus NOK, including historical rates going back to 1980. It supports currency conversion and charting, with metadata describing the data source and scope.

🛠️ Key Features

38 currencies vs NOK exchange rates
History available to 1980 (from Norges Bank data)
Convert currencies
Chart exchange-rate trends

🚀 Use Cases

Retrieve Norwegian exchange rates for currencies and NOK
Convert amounts using historical or current rates
Visualize exchange-rate history through charts

⚡ Developer Benefits

Dataset coverage defined as 38 currencies against NOK
Time range explicitly includes history to 1980
Clear input/output focus on conversion and charting

⚠️ Limitations

Limited to currencies versus NOK (no other base pairs described)
Historical coverage starts at 1980 (no earlier data specified)

Topics

aibiblebrregclaudedictionaryepubgreekhebrewlexicographylexiconllmmcpmodel-context-protocolnorwaypublishingstrongslovdatamcp-servernorwegian-law

Declared in the repository manifest (services/currency/tools.json). Not verified against a live endpoint.

get_rate

Get the exchange rate between any two currencies on a specific date. Returns the rate and its inverse. Supports all 38 Norges Bank currencies plus NOK. Cross-rates (e.g. USD→EUR) are computed via NOK as intermediary. If date is omitted, returns the most recent available rate.

Parameters3

date	string	optional	Date in YYYY-MM-DD format. Omit or set to 'latest' for the most recent available rate.
from	string	required	Source currency code, e.g. USD, EUR, GBP (case-insensitive)
to	string	required	Target currency code, e.g. NOK, SEK, DKK (case-insensitive)

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date in YYYY-MM-DD format. Omit or set to 'latest' for the most recent available rate."
    },
    "from": {
      "type": "string",
      "description": "Source currency code, e.g. USD, EUR, GBP (case-insensitive)"
    },
    "to": {
      "type": "string",
      "description": "Target currency code, e.g. NOK, SEK, DKK (case-insensitive)"
    }
  },
  "required": [
    "from",
    "to"
  ]
}

convert

Convert a monetary amount from one currency to another using Norges Bank exchange rates. Supports all 38 currencies plus NOK. Cross-currency conversion (e.g. USD→EUR) is computed via NOK. If date is omitted, uses the most recent available rate.

Parameters4

amount	number	required	Amount to convert (zero or greater)
date	string	optional	Date in YYYY-MM-DD format. Omit or set to 'latest' for the most recent available rate.
from	string	required	Source currency code, e.g. USD (case-insensitive)
to	string	required	Target currency code, e.g. NOK (case-insensitive)

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "description": "Amount to convert (zero or greater)"
    },
    "date": {
      "type": "string",
      "description": "Date in YYYY-MM-DD format. Omit or set to 'latest' for the most recent available rate."
    },
    "from": {
      "type": "string",
      "description": "Source currency code, e.g. USD (case-insensitive)"
    },
    "to": {
      "type": "string",
      "description": "Target currency code, e.g. NOK (case-insensitive)"
    }
  },
  "required": [
    "amount",
    "from",
    "to"
  ]
}

list_currencies

List all 38 available currency codes with their full names. Returns the base currency (NOK) and data source (Norges Bank). Use this to discover valid currency codes for get_rate and convert.

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

get_rates_range

Get daily exchange rates for a single currency over a date range. Returns an array of {date, rate} points sorted chronologically. Useful for charts, trend analysis, and historical comparisons. Rates are NOK per unit of the specified currency.

Parameters3

currency	string	required	Currency code, e.g. USD (case-insensitive)
from_date	string	required	Start date in YYYY-MM-DD format (inclusive)
to_date	string	required	End date in YYYY-MM-DD format (inclusive)

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "description": "Currency code, e.g. USD (case-insensitive)"
    },
    "from_date": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format (inclusive)"
    },
    "to_date": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format (inclusive)"
    }
  },
  "required": [
    "currency",
    "from_date",
    "to_date"
  ]
}

get_buying_power

Get the buying-power multiplier for one country, for pricing a USD list price in a local market. Returns TWO numbers. `factor` is the RECOMMENDED multiplier on the USD price: 1.0 means full price, and it is NEVER above 1.0 because the USD price is the maximum anyone pays regardless of local wealth; it is clamped to a floor of 0.35 because payment fees make smaller charges uneconomic. `raw_factor` is the honest, uncapped MEASUREMENT (GNI per capita PPP relative to the USA, square-root compressed) and CAN exceed 1.0 for countries richer than the United States — Norway measures about 1.10. `ratio` is the plain GNI ratio before that compression, for a consumer that wants to apply its own curve. The `capped` and `floored` flags say whether policy moved `factor` away from `raw_factor`. If in doubt, use `factor`. An unknown country, missing data or an upstream outage fails safe: factor 1.0 with `unknown` or `fallback` set and the reason in `note`.

Parameters2

country	string	required	ISO 3166-1 alpha-2 country code, e.g. DE, IN, NO, BR (case-insensitive). NOT a currency code — the eurozone spans very different economies on one currency.
history	boolean	optional	Also return the country's full year-to-GNI series and the United States' series alongside it, for trend analysis. Off by default: the history is ~36 years per country and most callers only need the current factor. Years with no observation are absent, not zero — do not interpolate across them.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code, e.g. DE, IN, NO, BR (case-insensitive). NOT a currency code — the eurozone spans very different economies on one currency."
    },
    "history": {
      "type": "boolean",
      "description": "Also return the country's full year-to-GNI series and the United States' series alongside it, for trend analysis. Off by default: the history is ~36 years per country and most callers only need the current factor. Years with no observation are absent, not zero — do not interpolate across them."
    }
  },
  "required": [
    "country"
  ]
}

list_buying_power

List the buying-power multiplier for every country the World Bank publishes GNI per capita (PPP) for, sorted lowest buying power first. Each row carries both numbers: `factor`, the recommended multiplier on a USD list price (1.0 = full price, never above 1.0, floored at 0.35), and `raw_factor`, the uncapped measurement which exceeds 1.0 for countries richer than the United States. The consumer chooses which to use; if in doubt, use `factor`. Also returns `reference_year` (the World Bank's release year — published annually, around July), `fetched_at` (when this service last pulled it — NOT the same thing), and `data_origin`/`fallback` saying whether the data is a live pull or the table embedded in the binary.

Parameters

No parameters.

Raw schema

{
  "type": "object"
}

get_all_rates

Get all 38 currency rates for a single date. Returns each currency code, full name, and rate (NOK per unit). If date is omitted, returns the most recent available rates. Useful for dashboards and bulk comparisons.

Parameters1

date

string

optional

Date in YYYY-MM-DD format. Omit or set to 'latest' for the most recent available rates.

Raw schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Date in YYYY-MM-DD format. Omit or set to 'latest' for the most recent available rates."
    }
  }
}

services/currency/README.md6 KBView on GitHub

Currency Exchange — Norges Bank exchange rate MCP server for Claude, Cursor and any MCP client

Currency gives an AI assistant Norges Bank's daily reference rates as structured data: the rate between any two of 38 currencies on any date back to about 1980, conversion of an amount, a daily series for charting — and World Bank buying-power multipliers for pricing one list price into many markets. It runs as a hosted MCP server over HTTPS.


Endpoint	`https://currency.publifye.com/mcp`
Transport	Streamable HTTP
Auth	OAuth 2.1 + PKCE (S256), DCR open · no API keys
Registry	`pro.publifye/currency` (server.json)
Product site	https://currency.publifye.com
What it solves	https://publifye.com/currency
Capability tools	7 (full schemas)

Connect

jsonc

{ "mcpServers": { "currency": { "type": "http", "url": "https://currency.publifye.com/mcp" } } }

Claude Code: claude mcp add --transport http currency https://currency.publifye.com/mcp, then /mcp to sign in.

The OAuth flow runs in the browser on first use, with a Publifye account. Access is granted through that sign-in only; there is no API key to create, copy or rotate. The discovery chain is the same as for the other servers: ../../docs/connect.md.

Where the rates come from

The rates are Norges Bank's own daily reference rates, quoted against the Norwegian krone. This service syncs and serves them. It does not compute, estimate or interpolate a rate.

That last sentence is the one that matters when an AI is asking. Norges Bank publishes once per business day, at about 16:00 CET, so weekends, Norwegian public holidays and any day the bank did not publish simply have no rate. A date with no published rate returns the series as published rather than an invented value — no carry-forward, no interpolation, no nearest-neighbour. A model that wants a number for a Sunday has to decide for itself what to do about it, which is the correct place for that decision to be made.

Cross-rates — USD→EUR, say — are derived through NOK, because NOK is the only pair Norges Bank quotes. The derivation is arithmetic on two published rates, not a third source.

The buying-power tools return two numbers, and the difference matters

get_buying_power and list_buying_power exist for one job: pricing a USD list price into a local market. They return factor and raw_factor, and they are not the same thing.

factor is the recommended multiplier. It is never above 1.0 — the USD price is the maximum anyone pays regardless of how wealthy the local market is — and it is floored at 0.35 because payment fees make smaller charges uneconomic.
raw_factor is the honest, uncapped measurement: GNI per capita (PPP) relative to the USA, square-root compressed. It can exceed 1.0. Norway measures about 1.10.

Applying raw_factor to a Norwegian price charges about 10% above list. That is exactly the mistake the cap exists to prevent, which is why both numbers are returned with capped and floored flags saying whether policy moved one away from the other. If in doubt, use factor.

An unknown country, missing data or an upstream outage fails safe: factor 1.0, with unknown or fallback set and the reason in note — never a silent guess.

What the tools do

Every tool is documented with its exact description, annotations and input schema — 7 in all, generated from the service's own registry, never written by hand.

Area	The question it answers	Tools
Rates and conversion	What was this worth, in that currency, on that date?	5
Buying power	What should this USD price be in that country?	2

Machine-readable: tools.json carries all 7 callable tools with full JSON Schema, plus every excluded bucket listed by name so the count is auditable.

All seven are read-only and idempotent. None is marked open-world: every answer is served from data this service has already synced, so the same call on the same day gives the same answer.

What it does not do

No live or intraday rates. One publication per business day, about 16:00 CET. A day's rates are stable once published, and therefore cacheable.
No currency Norges Bank does not quote. 38 plus NOK, and no more.
No invented values. No interpolation across a gap, no carry-forward into a weekend.
No trading, no execution, no advice. These are reference rates, not dealable prices, and a reference rate is not what you will be charged by a bank or a card network.
Not a full annual-accounts or economics source. The buying-power figures are one World Bank indicator, not a model of an economy.

Data and licence

Exchange rates are published by Norges Bank. Buying-power figures are World Bank GNI per capita (PPP), released annually, around July. Results carry reference_year — the World Bank's release year — separately from fetched_at, which is when this service last pulled it. Those are not the same thing and conflating them is how a stale figure gets reported as current.

data_origin and fallback say whether a buying-power answer came from a live pull or from the table embedded in the binary, so a degraded answer is never indistinguishable from a fresh one.

Currency Exchange is operated by Publifye AS and is not affiliated with, or endorsed by, Norges Bank or the World Bank.

Plans

A free Publifye account grants a small daily allowance on a trial; Currency Access lifts it to a monthly quota. Plans and prices can change; the current ones are always on https://currency.publifye.com, and where this page and the site differ, the site is right.

Install

Tools (7)

get_rateconvertlist_currenciesget_rates_rangeget_buying_powerlist_buying_powerget_all_rates

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://currency.publifye.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "currency": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://currency.publifye.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_rate

convert

list_currencies

get_rates_range

get_buying_power

list_buying_power

get_all_rates

Currency Exchange — Norges Bank exchange rate MCP server for Claude, Cursor and any MCP client

Connect

Where the rates come from

The buying-power tools return two numbers, and the difference matters

What the tools do

What it does not do

Data and licence

Plans

Install

Remote endpoint

Related servers