Ask an AI assistant about your devices
The Pinscope MCP server lets Claude, Cursor, Copilot and other assistants read what your devices in the field are doing: their logs, crashes decoded to the line, metrics and the vulnerabilities of their firmware. It changes nothing.
What it is for
An assistant in your editor can read your code, but not the device that is misbehaving at a customer's site. With the Pinscope MCP server it can. You ask in plain words and it fetches what it needs:
- "Why did the device in the warehouse restart three times last night?" It reads the crashes, with the backtrace decoded to functions and lines, and the log lines before them.
- "Is the heap leaking on the gateways?" It compares free and minimum heap over the last days.
- "Which known vulnerabilities in our ESP-IDF build are still open, and which are exploited?" It reads the CVEs matched to the SBOM of each build, with the decision recorded for each.
Combined with your source code in the same editor, the assistant can go from the crash on the device to the line to fix.
Set it up
- In the dashboard open the project, then API tokens, Create token, and tick AI assistant (read only). Copy the token: it is shown once.
- Add the server to your assistant.
Claude Code, in a terminal:
claude mcp add --transport http pinscope https://pinscope.dev/mcp \ --header "Authorization: Bearer pst_..."
Cursor (.cursor/mcp.json), VS Code and other clients that take a URL and headers:
{
"mcpServers": {
"pinscope": {
"url": "https://pinscope.dev/mcp",
"headers": { "Authorization": "Bearer pst_..." }
}
}
}
The server speaks MCP's Streamable HTTP transport at https://pinscope.dev/mcp. Then ask, for example: "Using Pinscope, list my devices and tell me which ones crashed this week."
The tools
| Tool | What it returns |
|---|---|
list_devices | Each device: online or not, last seen, firmware, chip, restarts in 7 days by reason, its HTTPS address. |
get_logs | A device's log lines, newest last, optionally filtered by text or the last N minutes. |
get_crashes | The last crashes, decoded to functions and source lines when the build's ELF was uploaded. |
get_metrics | Each metric over a period: latest, lowest and highest value. |
get_vulnerabilities | CVEs in the project's firmware builds, with severity, exploitation and the VEX decision for each. |
What it can and cannot do
- Read only. The token's scope allows reading and nothing else: no firmware updates, no changes to devices, rules or the project, and no access to the devices' own web pages. Updates stay a decision you make in the dashboard.
- One project. A token belongs to one project and sees nothing of the others.
- Revocable. Revoke the token under API tokens and the assistant loses access at once; the dashboard shows when each token was last used.
- What the assistant reads goes to its provider. Log lines and crashes you ask about are sent to the AI service your assistant uses, under that service's terms. If your logs contain anything that must not leave your company, keep that in mind, or ask only about crashes and metrics.
The MCP server is on every plan, the free one included.
Try it
Three devices are free, and no card is needed. Create an account, or read the five-minute guide first.
More
- Remote access to an ESP32 without TLS: what it measured and what it costs
- Reaching an ESP32 web server from outside its network
- Updating ESP32 firmware over the internet, with rollback
- Guru Meditation Error: decoding the backtrace, and crashes from the field
- Remote logging: ESP_LOG without a serial cable
- Heap and stack monitoring in the field
- An ESP32 behind CGNAT, 4G or Starlink
- TLS memory usage on the ESP32, and how to reduce it
- Sharing an ESP32 sensor page with anyone, without port forwarding
- ArduinoOTA over the internet, with a rollback
- ESP32 remote access compared: port forwarding, ngrok, Cloudflare Tunnel, Tailscale
- esp_http_server slow? The 250 ms delay and the fix
- Before the first ESP32 ships: a field support checklist
- ESP32 exception decoder: a Guru Meditation backtrace to lines, in the browser