search_particleLABSCO SUMMARY
Reference-grade particle data, addressable the way people say the names.
The input handling is what makes it usable: aliases, natural-language charge, anti-particle forms and MC IDs all resolve to the same record, and anti-particles go through MCID negation rather than string guessing. Every answer carries structured JSON, so it feeds a calculation as easily as a conversation.
What it is
A Python MCP server for particle physics lookups, resolving names, aliases and MC IDs and returning both human-readable text and a structured JSON payload.
What you get
- Particle properties: mass in MeV and GeV, charge, spin, colour, parity, C, I and G, lifetime or width, MCID and review ID
- Decay modes with exclusive and inclusive branching fractions, and the source method named for each
- Natural-language input —
muon plus,positive tau,pion zero,kaon minus— alongside canonical names likemu+,pi0,K- - Anti-particles resolved by MCID negation rather than name guessing, covering
antimuon,ubar,u bar,u_barandu~ - Self-conjugate handling, so
anti photonresolves togammaandanti pi0topi0 - Direct MC ID lookup with values like
11or-2212 - Every response carrying a fenced JSON block next to the prose
Requirements
Python with pip — clone the repository and pip install -e ., then point your client at it through uvx or a local virtualenv. No account and no key.
Setup effort
Build from source — git clone https://github.com/uzerone/particlephysics-mcp-server.git
USE CASES
01
Getting a particle's numbers right in a calculation
Ask for the particle by its usual name and get mass, charge, spin, lifetime and the review ID together.
02
Checking how a particle decays
List the decay modes with exclusive and inclusive branching fractions, with the source method stated for each.
03
Resolving an ID from a simulation output
Query with the MC ID directly — -2212 and 11 work as lookups — instead of hunting through a PDG table.
04
Working with anti-particles without name guessing
Use whichever anti-particle spelling you have to hand; resolution goes through MCID negation, and self-conjugate cases fold back to the particle.
2 tools
Listed in project docs. Your client may show a different list.
list_decaysBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/uzerone/particlephysics-mcp-server.git
cd particlephysics-mcp-server
pip install -e .MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"particlephysics": {
"command": "uvx",
"args": [
"--from",
"<YOUR_PATH_TO_PARTICLEPHYSICS_MCP_SERVER>",
"python",
"-m",
"particlephysics_mcp_server"
]
}
}
}
