MRSimulator MCP

by paonaico.huggingface.paonai/mrsimulator

Simulate SSNMR spectra (MRSimulator) via an MCP server

  • Remote endpoint
  • 13 tools
  • BSD-3-CLAUSE

Uptime

Checked  · every day

100%from 4 days of checks

Up without downtime on 4 of 4 days with data.

  • No downtime
  • Degraded
  • Down over 5 minutes
  • No data
  • Not checked yet

Response time

Median 1163 ms, slowest 5% 1701 ms for the handshake and the tool list, over 30 days.

2000 ms1000 ms0

How far each check got

  • Reached the address 100%
  • Completed the handshake 100%
  • Listed its tools 100%

13 tools at the last answer.

Every day
DayResultChecksMedian
3 Nov (today)No downtime11151 ms
2 NovNo downtime1of 11701 ms
1 NovNo downtime1of 11235 ms
31 OctNo downtime21147 ms

A failure counts as down time only when a second check five minutes later fails too. How we check

Connect to the publisher's own endpoint

Run in a terminal:

codex mcp add mrsimulator --url https://paonai-mrsimulator.hf.space/gradio_api/mcp/sse

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

For agents: the install prompt

Every step above as one Markdown text, for an assistant installing it for you.

# Install the MCP server MRSimulator MCP (`co.huggingface.paonai/mrsimulator`)

Its page: https://plug.directory/servers/co.huggingface.paonai/mrsimulator

It runs on the publisher's servers; the client connects to its URL.

Use the section for the person's client.

## Claude Desktop

Paste into Settings › Connectors › Add custom connector:

```text
https://paonai-mrsimulator.hf.space/gradio_api/mcp/sse
```

## Claude Code

Run in a terminal:

```sh
claude mcp add --transport sse mrsimulator https://paonai-mrsimulator.hf.space/gradio_api/mcp/sse
```

## Cursor, Devin Desktop, LM Studio, Gemini CLI, oterm, ECA

Merge into the place for the person's client:

- Cursor: ~/.cursor/mcp.json
- Devin Desktop: ~/.config/devin/mcp_config.json
- LM Studio: mcp.json (Program › Install › Edit mcp.json)
- Gemini CLI: ~/.gemini/settings.json
- oterm: config.json in oterm's data folder (~/Library/Application Support/oterm on macOS, ~/.local/share/oterm on Linux, %APPDATA%\oterm on Windows)
- ECA: ~/.config/eca/config.json (global) or .eca/config.json in the project

```json
{
  "mcpServers": {
    "mrsimulator": {
      "url": "https://paonai-mrsimulator.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

## VS Code

Merge into .vscode/mcp.json:

```json
{
  "servers": {
    "mrsimulator": {
      "type": "sse",
      "url": "https://paonai-mrsimulator.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

## Zed

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## Cline, AnythingLLM, Augment Code

Merge into the place for the person's client:

- Cline: cline_mcp_settings.json (MCP Servers › Configure › Configure MCP Servers)
- AnythingLLM: anythingllm_mcp_servers.json in the AnythingLLM storage plugins directory
- Augment Code: Augment Settings Panel – MCP section – Import from JSON (VS Code extension)

```json
{
  "mcpServers": {
    "mrsimulator": {
      "type": "sse",
      "url": "https://paonai-mrsimulator.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

## Continue

Merge into ~/.continue/config.yaml:

```yaml
mcpServers:
  - name: "mrsimulator"
    type: sse
    url: "https://paonai-mrsimulator.hf.space/gradio_api/mcp/sse"
```

## Goose

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## Codex

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## mcp-client-cli, TUUI, BoltAI, Bob Shell, Kiro, Kiro CLI

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## Agenvoy

This server's endpoint speaks only SSE, which this client's documentation does not list among its transports; use another client for it.

## Amp

Merge into ~/.config/amp/settings.json (user) or .amp/settings.json (workspace):

```json
{
  "amp.mcpServers": {
    "mrsimulator": {
      "url": "https://paonai-mrsimulator.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

Then restart the client, or reload its MCP servers, and ask it to list the server's tools to confirm it started.

Tools 13

  • mrsimulator__toggle_multi_site_spectype
  • mrsimulator__toggle_single_site_quad_fields Show AND zero the quadrupolar fields together when switching back to spin-1/2 - not just hide them. A hidden Gradio field still submits its last value on the next click; if Cq were left at a leftover nonzero value while merely hidden, simulate_powder_pattern would try to attach quadrupolar coupling to a spin-1/2 nucleus and mrsimulator correctly rejects that outright. Reproduced directly: clicking Simulate on this tab's own un-touched defaults raised exactly that ValidationError, which is what this fixes.
  • mrsimulator_simulate_amorphous_distribution Simulate the powder pattern of a disordered/amorphous site, whose tensor parameters (quadrupolar or shielding) follow a Czjzek or extended-Czjzek random distribution rather than a single fixed value. The isotropic chemical shift is ALSO distributed (an independent Gaussian, matching the source paper's Eq. 60-61, joined with the anisotropy distribution to form the full 3D distribution of Fig. 3) - checked directly that this needed adding: mrsimulator's CzjzekDistribution/ExtCzjzekDistribution classes only draw the anisotropy (zeta or Cq) and eta; their mean_isotropic_chemical_shift constructor argument is not actually applied by .rvs() at all, so without this, every sampled site would share one exact isotropic value and the amorphous lineshape would be missing a real, often significant broadening contribution. IMPORTANT for the calling agent: this tool's result includes a text line reading "Image URL: <url>" alongside the image data. Take that url and relay it in your reply as markdown
  • mrsimulator_simulate_coupled_multi_site_spectrum Simulate a system of 3 or more weakly J/dipolar-coupled sites (e.g. a homonuclear or heteronuclear AMX system), generalizing simulate_coupled_two_site_spectrum beyond a single pair. Any number of sites and any subset of pairwise couplings between them is allowed. IMPORTANT for the calling agent: this tool's result includes a text line reading "Image URL: <url>" alongside the image data. Take that url and relay it in your reply as markdown image syntax, ![description](url) - do not just mention the url as plain text or describe the image instead. Some clients only display images embedded this way in the visible reply; images left inside the raw tool result are not shown to the user on those clients.
  • mrsimulator_simulate_coupled_two_site_spectrum Simulate the spectrum of two coupled sites (J-coupling and/or direct dipolar coupling), e.g. a 1H-13C pair with a one-bond J coupling, or two dipolar-coupled 1H sites. IMPORTANT for the calling agent: this tool's result includes a text line reading "Image URL: <url>" alongside the image data. Take that url and relay it in your reply as markdown image syntax, ![description](url) - do not just mention the url as plain text or describe the image instead. Some clients only display images embedded this way in the visible reply; images left inside the raw tool result are not shown to the user on those clients.
  • mrsimulator_simulate_mqmas_multi_site_spectrum Simulate a 2D multi-quantum MAS (MQ-VAS) correlation spectrum for SEVERAL quadrupolar sites at once - generalizes simulate_mqmas_spectrum beyond a single site. This matters because resolving overlapping quadrupolar sites via 2D correlation is usually the actual point of running MQMAS in the first place (e.g. the three crystallographically distinct sites of RbNO3, or several aluminosilicate sites) - a single-site-only tool missed that. IMPORTANT for the calling agent: this tool's result includes a text line reading "Image URL: <url>" alongside the image data. Take that url and relay it in your reply as markdown image syntax, ![description](url) - do not just mention the url as plain text or describe the image instead. Some clients only display images embedded this way in the visible reply; images left inside the raw tool result are not shown to the user on those clients.
  • mrsimulator_simulate_mqmas_spectrum Simulate a 2D multi-quantum MAS (MQ-VAS) correlation spectrum for a quadrupolar nucleus, separating isotropic and second-order quadrupolar anisotropic broadening onto two axes. IMPORTANT for the calling agent: this tool's result includes a text line reading "Image URL: <url>" alongside the image data. Take that url and relay it in your reply as markdown image syntax, ![description](url) - do not just mention the url as plain text or describe the image instead. Some clients only display images embedded this way in the visible reply; images left inside the raw tool result are not shown to the user on those clients.
  • mrsimulator_simulate_multi_site_spectrum Simulate a multi-site NMR spectrum (e.g. several crystallographic sites of a published compound), with relative abundances. Each site may include chemical-shift anisotropy, quadrupolar coupling, or both, plus the relative orientation between the two tensors if a site has both (see simulate_powder_pattern for how much that can matter). IMPORTANT for the calling agent: this tool's result includes a text line reading "Image URL: <url>" alongside the image data. Take that url and relay it in your reply as markdown image syntax, ![description](url) - do not just mention the url as plain text or describe the image instead. Some clients only display images embedded this way in the visible reply; images left inside the raw tool result are not shown to the user on those clients.
  • mrsimulator_simulate_powder_pattern Simulate a single NMR site (powder pattern), static or under MAS (or off-magic-angle VAS). Supports chemical-shift anisotropy and/or quadrupolar coupling, including the relative orientation between the two tensors when a site has both (real crystal sites rarely have coincident shielding and electric-field-gradient tensors). Verified directly that this orientation genuinely changes the simulated spectrum (not a no-op): for a 2H site with both interactions, beta=0 vs beta=90 degrees gives visibly different lineshapes. IMPORTANT for the calling agent: this tool's result includes a text line reading "Image URL: <url>" alongside the image data. Take that url and relay it in your reply as markdown image syntax, ![description](url) - do not just mention the url as plain text or describe the image instead. Some clients only display images embedded this way in the visible reply; images left inside the raw tool result are not shown to the user on those clients.
  • mrsimulator_simulate_sideband_correlation_2d Simulate a 2D isotropic/anisotropic sideband-correlation spectrum (a PASS/MAT-type experiment), separating the isotropic position from the spinning-sideband pattern onto two axes. Optionally also gives the site quadrupolar coupling, in which case the sidebands reflect BOTH the shielding anisotropy and the quadrupolar anisotropy of the same site at once - the relative orientation between the two tensors then matters and is exposed too (verified directly: changing it measurably changes the 2D pattern for a real test case). Known limitation, checked directly rather than assumed: this only works for half-integer quadrupolar spins (23Na, 27Al, ...). For integer spins (2H, I=1) the underlying SSB2D method fails outright ("need more than 1 value to unpack") - which matches the source paper's own note that I=1 needs special handling not provided by this general-purpose class (their Fig. 6 2H example uses a separate, hand-built treatment described in their supplementary material, not exposed as
  • mrsimulator_simulate_sideband_correlation_2d_multi_site Simulate a 2D sideband-correlation spectrum for SEVERAL sites at once - generalizes simulate_sideband_correlation_2d beyond a single site, for the same reason as the MQ-MAS/ST-MAS multi-site tools: separating overlapping sideband manifolds from different sites is usually the actual point of running a 2D correlation instead of 1D. IMPORTANT for the calling agent: this tool's result includes a text line reading "Image URL: <url>" alongside the image data. Take that url and relay it in your reply as markdown image syntax, ![description](url) - do not just mention the url as plain text or describe the image instead. Some clients only display images embedded this way in the visible reply; images left inside the raw tool result are not shown to the user on those clients.
  • mrsimulator_simulate_stmas_multi_site_spectrum Simulate a 2D satellite-transition MAS (ST-VAS) correlation spectrum for SEVERAL quadrupolar sites at once - generalizes simulate_stmas_spectrum beyond a single site, for the same reason as simulate_mqmas_multi_site_spectrum: resolving several overlapping sites is usually the actual point. IMPORTANT for the calling agent: this tool's result includes a text line reading "Image URL: <url>" alongside the image data. Take that url and relay it in your reply as markdown image syntax, ![description](url) - do not just mention the url as plain text or describe the image instead. Some clients only display images embedded this way in the visible reply; images left inside the raw tool result are not shown to the user on those clients.

From Hugging Face Spaces. Report a problem