How to Use the Particle IoT MCP in Claude

Q: Can I trigger firmware functions on Particle IoT from Claude Desktop?

Yes. By using callfunction, Claude Desktop sends the command and payload directly to the Particle Cloud, which executes it on your physical hardware.

Q: How does Claude Desktop handle offline Particle IoT devices?

The agent runs pingdevice first to check if the board is online. If the device is unreachable, Claude Desktop tells you immediately rather than waiting for a cloud timeout.

Q: Can I broadcast events to my webhooks?

Absolutely. Use the publishevent tool to send custom event payloads to the Particle Cloud, triggering any active integrations or webhooks.

Control your Particle IoT hardware fleet directly from Claude Desktop with real-time sensor reads and instant cloud function execution.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Particle IoT MCP to Claude Desktop

Create your Vinkius account to connect Particle IoT to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Particle IoT with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Pull Live Telemetry Into Claude Desktop

Stop jumping between your terminal and the Particle console to check sensor values. This MCP Server lets your agent use `read_variable` to fetch live data like temperature or humidity directly inside your Claude Desktop chat window. You get the actual numbers instantly, meaning you can diagnose Photon firmware issues without leaving your Claude Desktop workspace. Before pulling data, Claude Desktop runs `get_devices` to check which hardware is active and online. Your agent uses this live context to map out your fleet, ensuring you don't query a dead sensor or ask Claude Desktop to command an offline Photon.

Run Device Functions From Chat

Triggering physical actions shouldn't require writing manual curl scripts inside Claude Desktop. With `call_function`, you can instruct Claude Desktop to toggle relays, open valves, or run calibration routines on any claimed device. The agent passes the exact string argument required by your Particle firmware and reports the execution code right in your Claude Desktop thread. To avoid sending commands to unresponsive hardware, Claude Desktop runs `ping_device` to check the current connection state of your board. This step prevents useless timeouts and keeps your Claude Desktop automation loops fast.

Organize Your Fleet via MCP Server Tools

Managing a growing batch of Particle IoT microcontrollers in Claude Desktop gets messy fast. Use `rename_device` through Claude Desktop to keep your console clean, assigning clear names to new hardware as you deploy them. If you need to retire a board, Claude Desktop can invoke `unclaim_device` after you confirm the action in chat. To understand what a specific board can do, Claude Desktop uses `get_device_info` to pull the exact variables and functions exposed by that firmware. You can also broadcast custom messages across your entire system using `publish_event` directly from your Claude Desktop interface.

Setup guide

Set up Particle IoT MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Particle IoT MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Particle IoT MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under particle-iot-mcp.

json

{
  "mcpServers": {
    "particle-iot-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Particle IoT. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Particle IoT now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Particle IoT MCP in Claude Desktop

You just ask Claude Desktop to check a variable. The agent invokes `read_variable` with the device name and the variable identifier defined in your C++ firmware, returning the value instantly.

Yes. By using `call_function`, Claude Desktop sends the command and payload directly to the Particle Cloud, which executes it on your physical hardware.

The agent runs `ping_device` first to check if the board is online. If the device is unreachable, Claude Desktop tells you immediately rather than waiting for a cloud timeout.

Absolutely. Use the `publish_event` tool to send custom event payloads to the Particle Cloud, triggering any active integrations or webhooks.

Vinkius handles your authentication securely in an isolated sandbox. Your raw Particle IoT access tokens and device variables never pass through Claude's servers directly, keeping your hardware credentials safe.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript