using-nrf-cloud-mcp

Using nRF Cloud MCP

nRF Cloud MCP is a hosted HTTP MCP server (https://app.memfault.com/mcp, hosted by Memfault, OAuth via your nRF Cloud account). It is a read-only query interface to the single organization + project your token is scoped to.

Authentication & scope

• OAuth 2.0 with PKCE; tokens are scoped to one org + project chosen during authorization. Access tokens expire after 1 hour and are normally refreshed automatically.
• To access multiple projects, configure a separate server entry per project with a distinct name (e.g. nrfcloud-prod, nrfcloud-staging). Name the project in your prompt so the right one is used.

The 12 read-only tools

Device: device_get, device_getAttributes, device_getTimeseries (<=7-day range, CSV), device_getVitals, device_search (SQL-style WHERE clause). Issue & trace: issues_list, issue_get, issue_getTraces, trace_get (stacktrace, registers, optional logs / all threads). Metric: metrics_list. Software version: softwareVersions_list, softwareVersion_getVitals (fleet distribution: p01/p05/p50/p95/p99).

Limits (do not attempt)

• No mutations — cannot close issues, reassign devices, or change any state.
• No bulk export / data dump.
• No cross-issue or fleet-wide log/stack search; enumerate issues and inspect traces one at a time.
• No correlation / auto-clustering (reason over data you fetch; no tool computes it).
• No historical attribute timelines — device_getAttributes returns latest value only.
• Timeseries spans capped at 7 days per call — chunk longer windows into multiple calls.
• Rate-limited per organization; on HTTP 429 respect Retry-After and back off.

Example prompts

• "What are the top 5 open issues by trace count? Show fault reason and latest software version."
• "Pull the most recent trace on issue 12345 and walk me through the stack."
• "Of devices on software version 2.4.1, what's the p50 crashfree-hours vs 2.3.0?"
• "Find devices in cohort pilot-fleet whose battery_soc attribute is below 20."
• "Chart heap_free_bytes over the last 7 days for device ABC123."

Slash command in this plugin

/nrfcloud-fleet — query fleet telemetry with the read-only guardrail built in.