Sběratelé Mincí MCP Server

Model Context Protocol server for the Sběratelé Mincí 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:

npx @pitscz/sberateleminci-mcp --service_api_key YOUR_KEY

Or add to your MCP client configuration (see 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:

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

With account access enabled:

{
  "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 |

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. — All rights reserved.

Contact

Radek Hřebeček — [email protected]