Skip to content
MCP server

HYRR

Radio-isotope production, activity and dose calculations for beams on stacked targets

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.22.0
Listing updated
1 day ago

About HYRR

HYRR is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add hyrr -- uvx hyrr-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "hyrr": {
      "command": "uvx",
      "args": [
        "hyrr-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hyrr": {
      "command": "uvx",
      "args": [
        "hyrr-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • HYRR_DATAnucl-parquet data directory. Unset: the matching data release is fetched once into ~/.hyrr/nucl-parquet
  • HYRR_LIBRARYNuclear data library id, e.g. tendl-2023-iso (default) or endfb-8.1

What it does

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

Pricing

Open source

Python package on PyPI; web calculator access is by request.

Prices change. Check exoma-ch.github.io before you buy.

HYRR 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 to HYRR

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science