{"name":"io.github.Jayzilva/helionyx","slug":"jayzilva-helionyx","title":"Helionyx","description":"Size hybrid solar PV, wind, battery, diesel and grid systems: hourly simulation, NPC ranking.","url":"https://mcp.market/server/jayzilva-helionyx","rating":null,"grade":"B","score":83,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":26,"stars":0,"forks":0,"downloads_week":132,"last_push_at":"2026-10-07T14:05:09.000Z","license":"Apache-2.0"},"uptime":null,"claimed":false,"transport":"pypi","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/Jayzilva/helionyx","website":null,"version":"0.3.0","remotes":[],"packages":[{"registryType":"pypi","identifier":"helionyx","version":"0.3.0","runtimeHint":"uvx","transport":{"type":"stdio"},"packageArguments":[{"value":"serve","type":"positional"}],"environmentVariables":[{"description":"Workspace directory for the database, artefacts and exports (default ~/.helionyx)","name":"HNX_WORKSPACE"},{"description":"Set to 1 to use only cached and bundled data (no network calls)","name":"HNX_OFFLINE"},{"description":"Optional NREL REopt API key for the reopt cross-check solver","isSecret":true,"name":"HNX_REOPT_API_KEY"}]}],"tools":[{"name":"cancel_job","description":"Cancel a queued or running job.","write_action":true,"price_micros":0,"input_schema":null},{"name":"compare_runs","description":"Side-by-side sizes and key metrics of several runs (e.g. native vs REopt), with differences.","write_action":false,"price_micros":0,"input_schema":null},{"name":"compute_bill","description":"Monthly and annual bill for a load with no system (baseline), or for import/export series.","write_action":false,"price_micros":0,"input_schema":null},{"name":"create_scenario","description":"Combine site, loads, resource, grid/tariff, components and search space into a scenario. Unset fields take pack defaults; call validate_scenario next to see them.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_site","description":"Register a site (location, time zone and country pack). Returns site_id.","write_action":true,"price_micros":0,"input_schema":null},{"name":"explain_run","description":"Structured facts about one design: NPC breakdown and shares, top cost drivers, binding constraints, dispatch statistics, differences from the next design or base case, and the most uncertain inputs.","write_action":true,"price_micros":0,"input_schema":null},{"name":"export_homer_csv","description":"Write HOMER-importable load and resource series (8,760 rows) plus a parameter sheet.","write_action":true,"price_micros":0,"input_schema":null},{"name":"export_report","description":"Write a client report as Markdown or Excel: scenario, assumptions, top designs, cost breakdown, monthly table, sensitivities, provenance and disclaimer.","write_action":true,"price_micros":0,"input_schema":null},{"name":"fetch_resource","description":"Get one year of hourly GHI, temperature and wind for a site, aligned to local civil time. Returns summary statistics only; the hourly series is available as a resource.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_job_status","description":"Poll a job: state (queued, running, completed, failed, cancelled, interrupted), progress %, ETA, run_id.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_monthly_summary","description":"Twelve months of energy flows and, for grid-connected runs, the bill before and after.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_pareto_front","description":"Designs on the Pareto front of NPC, annual CO2 and capacity shortage, including designs that break a constraint (flagged), to show cost versus emissions versus reliability trade-offs.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_results","description":"Ranked feasible designs with sizes and key metrics, the base case, provenance and disclaimer. The full table is the resource hnx://runs/{run_id}/results.csv.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_sensitivity_results","description":"Optimal design for each sweep value and the NPC elasticity at the base point.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_tariff","description":"Show a tariff's charge structure, TOU periods, export schemes, provenance and staleness warnings.","write_action":false,"price_micros":0,"input_schema":null},{"name":"import_timeseries","description":"Import a measured load or resource series from CSV (one year, 15/30/60-minute resolution), or extend at least four weeks of measured load to a full year.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_components","description":"Browse the component library: technical parameters, costs, currency, cost year and source.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_tariffs","description":"Browse the tariff pack (utility, category, effective dates, export schemes).","write_action":false,"price_micros":0,"input_schema":null},{"name":"run_optimization","description":"Start an asynchronous run that simulates every candidate for 8,760 hours and ranks feasible ones. Returns job_id and run_id; poll get_job_status, then call get_results.","write_action":true,"price_micros":0,"input_schema":null},{"name":"run_sensitivity","description":"Re-optimise the scenario for each value (or each pair of values in a two-variable grid) and compute NPC elasticities. Returns job_id and batch_id; then call get_sensitivity_results.","write_action":true,"price_micros":0,"input_schema":null},{"name":"synthesize_load","description":"Build an 8,760-hour load from pack archetypes, optionally calibrated to monthly bills.","write_action":false,"price_micros":0,"input_schema":null},{"name":"validate_scenario","description":"Check a scenario: errors block a run, warnings do not; assumptions list every value with its origin (user, pack_default or system_default), source and date.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":83,"grade":"B","scanned_at":"2026-10-13T23:18:33.647Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-13T23:18:33.671Z","components":{"code":{"score":25,"max":25,"notes":["88 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 6 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"pypi","identifier":"helionyx","version":"0.3.0","found":true,"weeklyDownloads":132,"license":"Apache-2.0","dependencyCount":24,"publishedAt":"2026-10-07T12:37:32.985734Z","repositoryUrl":"https://github.com/Jayzilva/helionyx"}],"repo":{"found":true,"owner":"Jayzilva","repo":"helionyx","archived":false,"pushedAt":"2026-10-07T14:05:09Z","stars":0,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/116673159?v=4","ownerCreatedAt":"2022-10-25T17:57:40Z","license":"Apache-2.0"},"icon":{"url":null,"source":"none"},"presence":{"stars":0,"forks":0,"downloadsWeek":132,"license":"Apache-2.0","lastPushAt":"2026-10-07T14:05:09.000Z","score":26}}}},"grade_history":[],"reviews":[]}