Cloudhil MCP server

Q: How do I add Cloudhil MCP to Claude Code?

Run `claude mcp add --env CLOUDHIL_API_KEY= cloudhildemo -- uvx cloudhil-mcp` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add Cloudhil MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

Commit Sep 11, 2026

tetef/cloudhildemo · python · MIT

Allows LLM agents to flash pre-built STM32 and LPC ELF files onto real Nucleo and Discovery hardware boards via HTTPS.

Also known as Tetef/cloudhildemo, cloudhildemo, cloudhil-mcp

stdio remote Developer Tools

Install GitHub ↗

Stars: 0
Tools: —
Downloads, 30 days: 213
Latest version: 0.8.2
Last commit: Sep 11, 2026
License: MIT

What is Cloudhil MCP?

Cloudhil allows LLM agents to flash pre-built STM32 and LPC ELF files onto real Nucleo and Discovery hardware boards via HTTPS.

Summary generated from the project's README

About Cloudhil MCP server

Cloudhil provides a specialized interface for LLM agents to interact with physical embedded hardware. Instead of simulating environments, this server allows agents to flash pre-built STM32 and LPC ELF files directly onto real Nucleo and Discovery boards using HTTPS. This connection enables an AI to move beyond code generation and perform actual hardware testing on silicon.

The workflow requires the user to compile the firmware locally before sending the ELF file via a POST request. The server handles the flashing process, and the agent monitors the result.mailbox file to confirm success by looking for the NNOK hex code. This setup is designed for developers using tools like Cursor or Claude who want to verify their embedded code on physical microcontrollers.

Because the server never performs compilation itself, it remains a lightweight bridge between the digital agent and the physical MCU. The process is rapid, with the hardware erasure window lasting twenty seconds or less. This makes it a practical tool for rapid prototyping and hardware-in-the-loop validation within an AI-driven development workflow.

What you can do with it

1Automated hardware testingInstruct the AI to perform a hardware test and report the results based on the mailbox status.

Written from the project's README. Every use case is checked against a quote from it.

How to install Cloudhil MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY> cloudhildemo -- uvx cloudhil-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "cloudhildemo": {
      "command": "uvx",
      "args": [
        "cloudhil-mcp"
      ],
      "env": {
        "CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "cloudhildemo": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cloudhil-mcp"
      ],
      "env": {
        "CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "cloudhildemo": {
      "command": "uvx",
      "args": [
        "cloudhil-mcp"
      ],
      "env": {
        "CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
      }
    }
  }
}

~/.codex/config.toml

[mcp_servers.cloudhildemo]
command = "uvx"
args = ["cloudhil-mcp"]

[mcp_servers.cloudhildemo.env]
CLOUDHIL_API_KEY = "<YOUR_CLOUDHIL_API_KEY>"

~/.gemini/settings.json

{
  "mcpServers": {
    "cloudhildemo": {
      "command": "uvx",
      "args": [
        "cloudhil-mcp"
      ],
      "env": {
        "CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>"
      }
    }
  }
}

Set 2 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

CLOUDHIL_API_KEYSecret
Bearer from register_agent (optional; the tool can register)
CLOUDHIL_URL
Cloudhil API base URL

Name	Description
CLOUDHIL_API_KEY	Bearer from register_agent (optional; the tool can register)	Secret
CLOUDHIL_URL	Cloudhil API base URL

README

View on GitHub

cloudhildemo

Kit for LLM agents that want to flash real STM32 / LPC boards on Cloudhil.

Cloudhil never compiles. You compile locally, POST an ELF, read result.mailbox (NNOK = 0x4E4E4F4B), then the MCU is erased (≤20 s smoke window).

Files

AGENTS.md — paste into the firmware repo (AGENTS.md or .cursorrules)
SKILL.md — Cursor / Claude skill (offer hardware test, then say tested on silicon)
hello/ — NNOK hello.c + linker scripts + gcc one-liners (N6 recipe inside AGENTS.md)
mcp/cloudhil_mcp.py — stdio MCP, Python 3, no pip

Official prebuilt hellos (not in git): https://cloudhil.tinab.com/hello/nucleo-n6.elf

Contact: contact@cloudhil.tinab.com

Read full README

Cloudhil MCP questions

How do I add Cloudhil MCP to Claude Code?

Run claude mcp add --env CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY> cloudhildemo -- uvx cloudhil-mcp in your terminal. Add --scope user to make it available in every project.

How do I add Cloudhil MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

How do I know if the flashing was successful?

You can check the result.mailbox for the NNOK value (0x4E4E4F4B) to verify the process.

What happens to the MCU after flashing?

The MCU is erased within a window of 20 seconds or less.

Facts

Nov 13, 2026

Stars: 0
Downloads, 30 days: 213
Latest version: 0.8.2
Last commit: Sep 11, 2026
License: MIT
Transport: stdio, remote
Package: cloudhil-mcp

Tetef ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/tetef/cloudhildemo.svg)](https://hostedmcp.org/servers/tetef/cloudhildemo/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

About Cloudhil MCP server

What you can do with it

1Automated hardware testingInstruct the AI to perform a hardware test and report the results based on the mailbox status.

Written from the project's README. Every use case is checked against a quote from it.

{ "mcpServers": { "cloudhildemo": { "command": "uvx", "args": [ "cloudhil-mcp" ], "env": { "CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>" } } } }

{ "servers": { "cloudhildemo": { "type": "stdio", "command": "uvx", "args": [ "cloudhil-mcp" ], "env": { "CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>" } } } }

{ "mcpServers": { "cloudhildemo": { "command": "uvx", "args": [ "cloudhil-mcp" ], "env": { "CLOUDHIL_API_KEY": "<YOUR_CLOUDHIL_API_KEY>" } } } }

Name

Description

CLOUDHIL_API_KEY

Bearer from register_agent (optional; the tool can register)

Secret

CLOUDHIL_URL

Cloudhil API base URL

Cloudhil MCP questions

How do I add Cloudhil MCP to Claude Code?

Run claude mcp add --env CLOUDHIL_API_KEY=<YOUR_CLOUDHIL_API_KEY> cloudhildemo -- uvx cloudhil-mcp in your terminal. Add --scope user to make it available in every project.

How do I add Cloudhil MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

How do I know if the flashing was successful?

You can check the result.mailbox for the NNOK value (0x4E4E4F4B) to verify the process.

What happens to the MCU after flashing?

The MCU is erased within a window of 20 seconds or less.

Cloudhil MCP server

What is Cloudhil MCP?

About Cloudhil MCP server

What you can do with it

How to install Cloudhil MCP

Install Cloudhil MCP in Claude Code

Install Cloudhil MCP in Cursor

Install Cloudhil MCP in VS Code

Install Cloudhil MCP in Claude Desktop

Install Cloudhil MCP in Codex

Install Cloudhil MCP in Gemini CLI

Configuration

README

cloudhildemo

Files

Cloudhil MCP questions

Cloudhil MCP server

What is Cloudhil MCP?

About Cloudhil MCP server

What you can do with it

How to install Cloudhil MCP

Install Cloudhil MCP in Claude Code

Install Cloudhil MCP in Cursor

Install Cloudhil MCP in VS Code

Install Cloudhil MCP in Claude Desktop

Install Cloudhil MCP in Codex

Install Cloudhil MCP in Gemini CLI

Configuration

README

cloudhildemo

Files

Cloudhil MCP questions