<!-- mcp-name: io.github.gemsmakers/mcp-server -->
# GemsMakers Model Context Protocol (MCP) Server

[![MCP Registry](https://img.shields.io/badge/MCP-Registry%202025--12--11-00f5d4?style=flat&logo=openai)](https://modelcontextprotocol.io)
[![Glama MCP](https://glama.ai/mcp/servers/badges/io.github.gemsmakers/mcp-server.svg)](https://glama.ai/mcp/servers)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Calculators](https://img.shields.io/badge/Tools-2%2C700%2B%20Live-brightgreen)](https://gemsmakers.com)

Connect your AI agent (**Claude Desktop, Cursor IDE, Windsurf, Claude Code, or any MCP-compatible runtime**) directly to **[GemsMakers.com](https://gemsmakers.com)** — the web's definitive suite of 2,700+ interactive precision scientific, engineering, horological, and bullion simulators.

Zero login. Zero API keys. Verified empirical formulas with KaTeX step-by-step mathematical proofs.

---

## ⚡ Quick Start

### 1. Official MCP Registry Installation
If using the MCP Registry CLI:
```bash
mcp install io.github.gemsmakers/mcp-server
```

### 2. Claude Desktop Setup
Add this entry to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "gemsmakers": {
      "command": "npx",
      "args": ["-y", "gemsmakers-mcp-server"]
    }
  }
}
```

### 3. Cursor IDE Setup
Add this to your project `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "gemsmakers": {
      "command": "node",
      "args": ["/path/to/gemsmakers-mcp-server/index.js"]
    }
  }
}
```

---

## 🛠️ Included Production MCP Tools

| Tool | Capability | Scientific / Mathematical Standard | Live Interactive Simulator |
| :--- | :--- | :--- | :--- |
| `bullion_melt` | Pure karat metal grams, troy ounces, fine fineness %, & live scrap value | ASTM / LBMA Good Delivery Karat Math | [Gold Calculators](https://gemsmakers.com/gold.php) |
| `specific_gravity` | Archimedean dry vs submerged mass alloy authentication | Archimedes Hydrostatic Specific Gravity Standard | [Precious Metal Tests](https://gemsmakers.com/metals.php) |
| `watch_beat_math` | Escapement frequency (Hz), ticks/sec, beat rate (BPH), & lift angle drift | Swiss Horology escapement balance dynamics | [Horology Hub](https://gemsmakers.com/watches.php) |
| `beam_deflection` | Euler-Bernoulli maximum beam deflection, moment of inertia & bending stress | AISC 15th Edition / Eurocode 3 | [Civil Engineering](https://gemsmakers.com/construction.php) |
| `fossil_age_overlap` | Concurrent Range Zone chronostratigraphic stage identification | ICS International Chronostratigraphic Chart | [Paleontology Lab](https://gemsmakers.com/fossils.php) |

---

## ⚖️ Programmatic Matchups & Worked Queries

Explore over 150+ empirical head-to-head technical matchups and 200+ pre-calculated numeric problems:
* **Head-to-Head Comparisons:** [https://gemsmakers.com/compare.php](https://gemsmakers.com/compare.php)
* **Instant Conversion Queries:** [https://gemsmakers.com/calculate-query.php](https://gemsmakers.com/calculate-query.php)
* **60FPS Browser Arcade:** [https://gemsmakers.com/gaming.php](https://gemsmakers.com/gaming.php)
* **Open Empirical Datasets:** [https://gemsmakers.com/datasets.php](https://gemsmakers.com/datasets.php)
* **REST API Documentation:** [https://gemsmakers.com/developers.php](https://gemsmakers.com/developers.php)
* **AI Search Index:** [https://gemsmakers.com/llms.txt](https://gemsmakers.com/llms.txt)

---

## 📄 License
MIT © 2026 GemsMakers Atelier. Open source for researchers, engineers, and AI developers.