llms.txt Content
# SynthPilot
> Let AI build your FPGA designs.
SynthPilot is an MCP (Model Context Protocol) server that gives AI assistants full control over AMD Vivado. With 500+ tools covering the entire FPGA development flow, you can create projects, write RTL, run synthesis, analyze timing, configure IPs, build Block Designs, simulate, debug on hardware, and program devices — all through natural language.
## Architecture
```
AI Tool (Claude / Cursor / Codex) <--MCP (stdio)--> SynthPilot <--TCP:9999--> Vivado (tcl_server)
```
All communication is local. No design data is sent to the cloud. SynthPilot translates AI tool calls into Vivado Tcl commands, executes them inside the running Vivado instance, and returns structured results.
## Requirements
- Windows x64 (Windows 10/11)
- AMD Vivado 2018.1+ (any edition including WebPack)
- uv package manager (https://docs.astral.sh/uv/)
## Installation
**Step 0: Install uv (if not already installed)**
Check if uv is available:
```bash
uv --version
```
If the command is not found, install uv:
```powershell
# PowerShell (recommended)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
After installation, close and reopen the terminal so the PATH takes effect.
**Step 1: Install SynthPilot**
```bash
uv tool install synthpilot
```
## Quick start (recommended)
After installing, run one guided command:
```bash
uv tool install synthpilot
synthpilot setup
```
`synthpilot setup` is one guided command that detects Vivado, installs the Tcl
server, activates your license, and registers SynthPilot in your AI editor
(Claude Code, Claude Desktop, Cursor, Codex) with NO hand-edited JSON, then runs
a health check. If something is off later, `synthpilot doctor` diagnoses it and
`synthpilot doctor --fix` self-heals.
This is the recommended path. The Activation, Vivado Integration, and MCP Client
Configuration sections below are for manual / advanced setups.
## Activation
Get a license key at https://