About sek-fx-mcp
A Python MCP server that lets an LLM look up the latest mid-market exchange rate for a currency against the Swedish krona through the Riksbank API. It is for people who need exchange-rate data in a conversation, with results including the SEK price per currency unit and publication date.
Key features
- 01Look up currencies by ISO 4217 code
- 02Fetch the latest Riksbank mid-market rate
- 03Return SEK unit price and publication date
- 04Accept an API key through an environment variable
Use cases
- 01Check the latest EUR-to-SEK rate
- 02Verify when a rate was published
- 03Retrieve a reference currency price in an LLM conversation
MCP support
Exposes a currency-rate lookup tool to MCP clients and retrieves data through the Riksbank API. It can run over stdio and supports the RIKSBANKEN_API_KEY environment variable.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEsek-fx-mcp
En MCP-server (Model Context Protocol) skriven i Python som låter en LLM slå upp växlingskursen för en valuta mot svenska kronor.
Servern kontaktar Riksbankens API och hämtar senaste mittkurs (PMI) för en valuta. Den accepterar ISO 4217-koden för valutor dvs NOK (norska kronor), EUR (Euro), GBP (brittiska pund) etc. Svaret är strukturerat och anger priset i SEK för en enhet av valutan samt vilket datum kursen publicerades. Kurser publiceras bankdagar, så datumet kan vara tidigare än dagens.
Kräver Python 3.14 och uv. Testad i Claude Desktop i macOS.
Installation
Claude Desktop:
uv run mcp install server.py
Claude Code:
claude mcp add sek-fx -- uv run --directory /sökväg/till/sek-fx-mcp server.py
Servern kan också startas direkt (stdio) med uv run server.py.
API-nyckel
Utan API-nyckel begränsar Riksbanken antalet anrop från samma ip-adress (5 anrop per minut och maximalt 1000 anrop per dygn). Med en nyckel kan du göra 200 anrop per minut, med ett tak på 30 000 anrop per vecka.
Så skaffar du en nyckel:
- Gå till Riksbankens API-portal, välj Sign Up uppe till höger och registrera dig.
- Gå till fliken Products och skapa en subscription.
- Nycklarna visas under fliken Profile som Primary och Secondary key. Du kan använda vilken som helst av dem.
Observera att testmiljön (developer.api-test.riksbank.se) och produktionsmiljön (developer.api.riksbank.se) har olika nycklar. Servern använder produktionsmiljön.
Sätt nyckeln i miljövariabeln RIKSBANKEN_API_KEY, så skickas den i headern Ocp-Apim-Subscription-Key:
uv run mcp install server.py -v RIKSBANKEN_API_KEY=<din-nyckel>
# eller
claude mcp add sek-fx -e RIKSBANKEN_API_KEY=<din-nyckel> -- uv run --directory /sökväg/till/sek-fx-mcp server.py
Utveckling
uv run pytest # tester, Riksbankens API mockas
uv run ruff check .
uv run ruff format .
uv run mcp dev server.py # MCP Inspector
Vidare läsning:
https://en.wikipedia.org/wiki/ISO_4217
https://github.com/modelcontextprotocol/python-sdk
https://www.riksbank.se/sv/statistik/rantor-och-valutakurser/hamta-rantor-och-valutakurser-via-api/
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.