# Kurs MCPB

[![Kurs MCPB](https://newreleases.io/badge.svg)](https://newreleases.io/github/janos/kurs-mcpb)

**kurs-mcpb** is a bridge that lets any [MCP](https://modelcontextprotocol.io/) client use the [Kurs](https://kurs.resenje.org) Serbian Dinar exchange rate tools.

It connects to the Kurs MCP server at `https://kurs.resenje.org/mcp` using the [Streamable HTTP transport](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#streamable-http) and exposes it locally over the MCP [stdio transport](https://spec.modelcontextprotocol.io/specification/basic/transports/#stdio).

## Install in Claude Desktop

Download [`kurs.mcpb`](https://github.com/janos/kurs-mcpb/releases/latest) from the latest release and open it in Claude Desktop. The single package works on all supported platforms (macOS, Linux, Windows).

Once installed, the **Kurs** tools appear automatically in every conversation.

## Available tools

| Tool | Description |
|------|-------------|
| `list_currencies` | List all supported currencies |
| `get_currency` | Get details for a currency by code |
| `get_rate` | Get the exchange rate for a currency on a date |
| `get_rates` | Get multiple rates for a currency starting from a date |
| `get_all_rates` | Get rates for all currencies on a date |
| `get_announced_rate` | Get the announced (next-day) rate for a currency |
| `get_all_announced_rates` | Get all announced rates |
| `get_week_rate` | Get the weekly average rate for a currency |
| `get_week_rates` | Get multiple weekly rates |
| `get_month_rate` | Get the monthly average rate for a currency |
| `get_month_rates` | Get multiple monthly rates |
| `convert_currency` | Convert between a foreign currency and RSD |

## How it works

```
Claude Desktop  ──stdio──▶  server/index.js  ──HTTP POST──▶  kurs.resenje.org/mcp
                ◀──stdio──                   ◀──HTTP resp──
```

When the Kurs server gains new tools, kurs-mcpb does **not** need to be updated — it passes raw JSON through without parsing tool schemas.

## License

This application is distributed under the BSD-style license found in the [LICENSE](LICENSE) file.