npm package: @pitscz/sberateleminci-mcp
Description: MCP server for Sběratelé Mincí — access coins, authors, collections, and market data via Model Context Protocol
Author: Radek Hřebeček
Latest version: 1.2.0

# Sběratelé Mincí MCP Server

[![npm version](https://img.shields.io/npm/v/%40pitscz%2Fsberateleminci-mcp)](https://www.npmjs.com/package/@pitscz/sberateleminci-mcp)
[![npm downloads](https://img.shields.io/npm/dm/%40pitscz%2Fsberateleminci-mcp)](https://www.npmjs.com/package/@pitscz/sberateleminci-mcp)
[![License](https://img.shields.io/npm/l/%40pitscz%2Fsberateleminci-mcp)](./package.json)
[![Node.js](https://img.shields.io/node/v/%40pitscz%2Fsberateleminci-mcp)](./package.json)

[Model Context Protocol](https://modelcontextprotocol.io) server for the [Sběratelé Mincí](https://sberateleminci.cz) platform. Gives AI assistants access to a Czech commemorative coin catalog — browse coins, authors, and collections, look up live precious metal prices and exchange rates, and submit support tickets.

## Quick Start

No installation needed — run directly with `npx`:

```bash
npx @pitscz/sberateleminci-mcp --service_api_key YOUR_KEY
```

Or add to your MCP client configuration (see [Configuration](#configuration) below).

## Tools

### Coins

| Tool           | Description                                                                  |
| -------------- | ---------------------------------------------------------------------------- |
| `coins_list`   | Browse coins with pagination, filter by metal type (GOLD / SILVER / BIMETAL) |
| `coin_get`     | Full coin details — weight, diameter, variants, images, authors              |
| `coin_search`  | Search by name, issuer, year (min 3 characters)                              |
| `coin_get_url` | Get web link to a coin page                                                  |

### Authors

| Tool             | Description                         |
| ---------------- | ----------------------------------- |
| `authors_list`   | Browse coin designers and engravers |
| `author_get`     | Author biography and portfolio      |
| `author_get_url` | Get web link to an author page      |

### Collections

| Tool                 | Description                          |
| -------------------- | ------------------------------------ |
| `collections_list`   | Browse thematic coin sets and series |
| `collection_get`     | Collection details and coin list     |
| `collection_get_url` | Get web link to a collection page    |

### Market Data

| Tool                          | Description                                       |
| ----------------------------- | ------------------------------------------------- |
| `commodity_today`             | Current gold and silver prices (USD/troy oz)      |
| `commodity_date`              | Historical precious metal prices for a given date |
| `currency_today`              | Current USD and EUR to CZK exchange rates         |
| `currency_date`               | Historical exchange rates for a given date        |
| `today`                       | Current server date and time                      |
| `convert_troy_ounce_to_grams` | Convert troy ounces to grams                      |

### Account _(requires `ACCOUNT_API_KEY`)_

| Tool              | Description                                                 |
| ----------------- | ----------------------------------------------------------- |
| `account_profile` | Authenticated user profile — name, email, subscription tier |

### Support

| Tool           | Description             |
| -------------- | ----------------------- |
| `support_send` | Submit a support ticket |

## Configuration

### Claude Desktop

Edit `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "sberateleminci": {
      "command": "npx",
      "args": ["@pitscz/sberateleminci-mcp", "--service_api_key", "YOUR_SERVICE_KEY"]
    }
  }
}
```

With account access enabled:

```json
{
  "mcpServers": {
    "sberateleminci": {
      "command": "npx",
      "args": [
        "@pitscz/sberateleminci-mcp",
        "--service_api_key",
        "YOUR_SERVICE_KEY",
        "--account_api_key",
        "YOUR_ACCOUNT_KEY"
      ]
    }
  }
}
```

### Environment Variables

Alternatively, credentials can be set via environment variables:

| Variable          | Required | Description                              |
| ----------------- | -------- | ---------------------------------------- |
| `SERVICE_API_KEY` | Yes      | Service API key                          |
| `ACCOUNT_API_KEY` | No       | User account key — enables account tools |

```bash
SERVICE_API_KEY=your_key npx @pitscz/sberateleminci-mcp
```

## Requirements

- Node.js 20+
- Service API key for the Sběratelé Mincí API

## License

Copyright © 2026 [PiTS s.r.o.](https://pits.cz) — All rights reserved.

## Contact

Radek Hřebeček — [radek.hrebecek@pits.cz](mailto:radek.hrebecek@pits.cz)