MCP Tools

Catalog of PYNE MCP tools, resources, and prompts. Every tool runs from pyne mcp call; execute / symbols / parity / diagnostics / builtin are first-class CLI commands.

This page

Abstract

Machine-oriented catalog for the PYNE MCP server (pyne-mcp / pyne mcp) and the in-process CLI (pyne mcp call TOOL, plus pyne execute / symbols / parity / diagnostics / builtin). Names match src/pynescript/mcp/catalog.py. Guide: MCP (agents). Tools return JSON {ok, ...}. Inputs accept source (preferred) and/or path. Stdio serving needs hoox-pyne[mcp]; call / execute do not.

CLI parity

ToolCLINotes
pyne_infopyne info --jsonversion, numba, mcp extra, entry points
pyne_checkpyne checkparse-only; source / path / paths
pyne_formatpyne formatreturns formatted source (no write)
pyne_convertpyne convert --toto 5 or 6
pyne_dumppyne parse-and-dumpdump text + JSON tree
pyne_unparsepyne parse-and-unparseround-trip source
pyne_lintpyne lint --jsonfindings array
pyne_compilepyne compileemit prints generated Python
pyne_prewarmpyne prewarmNumba / IR warm
pyne_runpyne runsynthetic OHLCV, compile pipeline
pyne_optimizepyne optimizespace object or space_json
pyne_datapyne datadefault provider mock
pyne_download_builtinspyne download-builtins --listlist only (network)
pyne_runner_deploypyne runner deployPOST /scripts
pyne_runner_listpyne runner list
pyne_runner_showpyne runner show
pyne_runner_deletepyne runner delete
pyne_runner_tickpyne runner tickPOST /cron/run
pyne_runner_jobspyne runner jobs
pyne_runner_historypyne runner historyGET /cron/history
pyne_runner_enablepyne runner enable
pyne_runner_disablepyne runner disable

Runner tools read PYNE_API_URL / ADMIN_TOKEN. They never echo tokens or webhook URLs.

Deeper tools

These also run from the CLI (pyne mcp call TOOL, plus first-class commands where listed).

ToolCLIResult
pyne_parsepyne mcp call parse PATH{version, kind, title, errors[{line,column,message}]}
pyne_symbolspyne symbols PATHfunctions, types, enums, input.*, plots, strategy.entry
pyne_executepyne execute PATHRuntime.run; caller ohlcv rows; truncated plots; strategy extras
pyne_paritypyne parity PATHinterpret vs compile last values (rtol=1e-5, atol=1e-6)
pyne_hoverpyne mcp call hover PATH --arg line=0 --arg character=0markdown at 0-based line / character
pyne_completepyne mcp call complete PATHcompletion items at cursor
pyne_signaturepyne mcp call signature PATHsignature help for the enclosing call
pyne_builtinpyne builtin ta.smabuiltin_metadata.json row (ta.sma, …)
pyne_diagnosticspyne diagnostics PATHparse errors + lint in one list
pyne_axb1pyne mcp call axb1AXB1 encoder vs golden vectors (hex-exact) + fnv1a32 + reject rules
pyne_sessionspyne mcp call sessionspooled live sessions: anchor vs store window, zombie suspects

pyne_execute plot cells: {len, last, na_count, sample} (sample default 8, max 64). Timeout default 30s, cap 120s. Bars cap 5000.

Resources and prompts

URI / nameKind
pyne://inforesource — same as pyne_info
pyne://builtinsresource — compact catalog
pyne://builtins/{name}resource — one builtin
review_pineprompt — lint + convert-to-v6
debug_pineprompt — parse, lint, 50-bar run
convert_to_v6prompt — convert + remaining W002/C002

See also