# HYRR

> HYRR is an open-source MCP server for health and science. Radio-isotope production, activity and dose calculations for beams on stacked targets. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://exoma-ch.github.io/hyrr/
- **Repository:** https://github.com/exoma-ch/hyrr/tree/HEAD/py-mcp
- **MCP Registry name:** io.github.exoma-ch/hyrr
- **Categories:** health and science, engineering simulation
- **Listing updated:** 2026-11-16

## About

HYRR, short for Hierarchical Yield and Radionuclide Rates, models how charged-particle beams produce isotopes in multi-layer target stacks. The calculation integrates cross-sections over energy loss, using TENDL cross-sections for protons, deuterons, tritons, helium-3 and alphas, tabulated PSTAR and ASTAR stopping powers with Bragg additivity, and Bateman equations for decay chains through irradiation and cooling.

The MCP server is a thin Python wrapper around Rust code and runs locally over stdio. The README names eight operations: simulate, list_materials, list_reaction_channels, get_decay_data, compare_simulations, get_stack_energy_budget, get_stopping_power and get_isotope_production_curve. The nuclear data is fetched once into a local folder, and the library can be switched, for example between TENDL 2023 and ENDF/B-8.1.

The web calculator is restricted because of nuclear-data licensing and uses ETH or SWITCH edu-ID sign-in with an access request, so confirm what applies to the data your server downloads.

## Features

- **Stack simulation:** Simulate yield and activity through multi-layer target assemblies.
- **Reaction channels:** List available reaction channels for a beam and target.
- **Stopping power:** Query tabulated PSTAR and ASTAR stopping powers.
- **Decay data:** Retrieve decay data and Bateman chain results.
- **Simulation comparison:** Compare different simulations side by side.
- **Production curves:** Get isotope production as a function of beam energy.

## Good for

- Estimate isotope activity after an irradiation
- Compare target stack designs for a cyclotron beam
- Look up stopping power in a material
- Inspect the energy budget through a stack

## Install

### Claude Code (Terminal)

```sh
claude mcp add hyrr -- uvx hyrr-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "hyrr": {
      "command": "uvx",
      "args": [
        "hyrr-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hyrr": {
      "command": "uvx",
      "args": [
        "hyrr-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hyrr": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hyrr-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hyrr": {
      "command": "uvx",
      "args": [
        "hyrr-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hyrr": {
      "command": "uvx",
      "args": [
        "hyrr-mcp"
      ]
    }
  }
}
```

## FAQ

### How do I install it?

Run claude mcp add hyrr -- uvx hyrr-mcp.

### Where does the data come from?

A nucl-parquet data directory, fetched once into ~/.hyrr/nucl-parquet unless HYRR_DATA is set.

### Which data library is used?

TENDL 2023 by default, or another such as ENDF/B-8.1 via HYRR_LIBRARY.

### Is the web app open?

Access is restricted because of nuclear-data licensing and needs approval.

### Is HYRR free?

Yes. HYRR is open source, so you can use and self-host it for free.

### How do I add HYRR to Claude Code?

Run this command in your terminal: claude mcp add hyrr -- uvx hyrr-mcp

### What are the best alternatives to HYRR?

The closest alternatives to HYRR are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Petrolytx: decline curves and well economics](https://ai-powered.com/mcp/petrolytx-decline-curves-and-well-economics): Petrolytx: decline curves and well economics is a freemium MCP server for analytics and data.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.

---
Source: https://ai-powered.com/mcp/hyrr
