Metadata-Version: 2.1
Name: cloudhil-mcp
Version: 0.7.0
Summary: MCP stdio server: flash pre-built STM32/LPC ELFs on Cloudhil real hardware. Does not compile.
Author-email: Cloudhil <contact@cloudhil.tinab.com>
License: MIT
Project-URL: Homepage, https://cloudhil.tinab.com
Project-URL: Documentation, https://cloudhil.tinab.com/AGENTS.md
Project-URL: Repository, https://github.com/Tetef/cloudhildemo
Project-URL: Issues, https://github.com/Tetef/cloudhildemo/issues
Keywords: mcp,stm32,lpc,embedded,hil,firmware
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Embedded Systems
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE

# cloudhil-mcp

MCP stdio server for [Cloudhil](https://cloudhil.tinab.com): flash a **pre-built** STM32 / LPC ELF on real boards (NUCLEO-N657X0-Q, STM32H735G-DK, NUCLEO-F429ZI, LPCXpresso55569). Cloudhil **never compiles**.

<!-- mcp-name: io.github.Tetef/cloudhil -->

## Install

```bash
pip install cloudhil-mcp
```

Or without installing globally:

```bash
uvx cloudhil-mcp
```

The same file is also served at https://cloudhil.tinab.com/mcp/cloudhil_mcp.py (Python 3, no pip).

## Cursor / Claude

```json
{
  "mcpServers": {
    "cloudhil": {
      "command": "cloudhil-mcp",
      "env": {
        "CLOUDHIL_URL": "https://cloudhil.tinab.com"
      }
    }
  }
}
```

`CLOUDHIL_API_KEY` is optional: call `register_agent` once, then pass the key or set the env var. Recipe: https://cloudhil.tinab.com/AGENTS.md

## Tools

- `list_boards` — benches, no auth
- `register_agent` — Bearer shown once
- `flash_elf` — local ELF path, mailbox NNOK + UART, ≤20 s then erase
- `get_job` — job JSON
- `send_feedback` — waitlist `kind=agent`

## License

MIT
