Nerdio Manager MCP

Analyze locally synced data with count, group-by, and summary operations. Data must be synced first with the sync command.

Get API domain context: resource taxonomy, auth requirements, query tips, and unique capabilities. Call this first.

fleet subcommands: autoscale-audit, billing-rollup, host-estate

Use this command to audit autoscale posture (on/off, baseline divergence) across customer host pools. Do NOT use it for session-host power state; use 'fleet host-estate' instead. Do NOT use it for billing/cost rollups; use 'fleet billing-rollup' instead. Fans out across customer accounts, lists each account's host pools, reads each pool's autoscale-configuration, and flags pools where autoscale is disabled or diverges from a baseline JSON file (--baseline: top-level keys that must match). Accounts that fail to fetch are reported separately in fetch_failures - a 401'd account is never a silent "all good".

Use this command for a current-period per-account billing/usage rollup. Do NOT use it for month-over-month usage trends; use 'usages drift' instead. Pulls /invoices and /usages for the period, joins them to account names from the synced local store (falling back to the live accounts list), and emits a per-account rollup of invoice totals, unpaid balance, and usage - the PSA-reconciliation view the API never returns assembled. Rows whose amounts cannot be extracted from the payload still count toward invoice_count and a note explains the gap; nothing is silently averaged in as zero.

Use this command for cross-account session-host inventory and power state. Do NOT use it for autoscale configuration posture; use 'fleet autoscale-audit' instead. Fans out across customer accounts, lists each account's host pools, then each pool's session hosts, and emits one table of account / pool / host / power state - the weekend power-sweep view that the NMM web UI only shows one account at a time. Accounts that fail to fetch are reported separately in fetch_failures.

Import data from a JSONL file by issuing POST requests for each record. Each line must be a valid JSON object. Failed records are logged to stderr but do not stop the import.

Execute one nerdio API endpoint by its endpoint_id (from nerdio_search). Params are passed as a JSON object; path placeholders and query strings are resolved automatically.

Search the nerdio API for endpoints matching a natural-language query. Returns a ranked list of {endpoint_id, method, path, summary} entries. Call this first to find the endpoint to execute.

Full-text search across all synced data. Faster than paginating list endpoints. Requires sync first.

Run read-only SQL against local database. Use for ad-hoc analysis, aggregations, and joins across synced resources. Requires sync first.

Sync data from the API into a local SQLite database. Supports resumable incremental sync (only fetches new data since last sync) and full resync. Once synced, use the 'search' command for instant full-text search. Exit codes & warnings: Resources the API denies access to (HTTP 403, or HTTP 400 with an access-policy body) are reported as warnings rather than failing the run. In --json mode each is emitted as a {"event":"sync_warning",...} line carrying status, reason, and message fields, and a final {"event":"sync_summary",...} aggregates the run. Exit 0 when at least one resource synced and no resource flagged in the spec as critical (x-critical: true) failed; non-critical failures emit {"event":"sync_warning","reason":"exit_policy_default_changed", ...} so callers can detect that a partial failure was tolerated. Pass --strict to exit non-zero on any per-resource failure. Exit is always non-zero when every selected resource failed, regardless of --strict. Resource scoping: --resources runs the named top-level resources, plus any parent-keyed dependent whose own name is listed OR whose parent table is listed. Naming a parent therefore cascades to its dependents (so "sync this parent and its children" works without listing every nested resource by hand). There is no flag today to suppress the cascade for a named parent. To run a dependent without re-syncing its parent, list only the dependent by name; the parent table must already be populated from a prior sync.

Tail streams live data changes by polling the API at configurable intervals. Events are emitted as NDJSON to stdout for piping to other tools. Gracefully shuts down on SIGTERM/SIGINT. Note: For APIs with WebSocket or SSE support, a future version will use native streaming instead of polling.

Compound workflows that combine multiple API operations

Archive fetches all syncable resources from the API and stores them in a local SQLite database. Supports incremental sync (only new data since last run) and full resync. After archiving, use 'search' for instant full-text search.

Show local archive status and sync state for all resources