# AVentTech x402 MCP Server

**AV/IT device integration knowledge, sold to AI agents. $0.03 per answer. No API keys, no signups.**

[AVentTech P.C.](https://aventtech.com) is a professional systems integrator (Crestron, Lutron, KNX — superyachts, hotels, auditoriums) in Athens, Greece. Twenty years of commissioning knowledge — control protocols, ports, and the field-tested gotchas that cost an integrator a day on site — published as a machine-payable API on the [x402 protocol](https://x402.org): agents pay per lookup in USDC on Base.

This repo is the **MCP server** that puts those tools inside Claude Desktop, Claude Code, Cursor, or any MCP client.

## Tools

| Tool | Price | What it does |
|---|---|---|
| `avt_device_catalog` | **free** | Full list of every make/model in the KB — check coverage before buying |
| `avt_device_lookup` | $0.03 | Control protocol, transport, TCP/UDP port, field-tested integration notes |
| `avt_fx_rates` | $0.002 | ECB daily EUR reference rates |

Payment happens automatically via x402 (HTTP 402 → signed USDC payment → data). Fund a small dedicated buyer wallet and pass it as `AVT_BUYER_PRIVATE_KEY`. Without a key, the free catalog tool still works.

## Install

### Claude Code
```bash
git clone https://github.com/ttsempelis/avt-x402-mcp
cd avt-x402-mcp && npm install
claude mcp add aventtech -e AVT_BUYER_PRIVATE_KEY=0x... -- node $(pwd)/server.mjs
```

### Claude Desktop / Cursor
```json
{
  "mcpServers": {
    "aventtech": {
      "command": "node",
      "args": ["/path/to/avt-x402-mcp/server.mjs"],
      "env": { "AVT_BUYER_PRIVATE_KEY": "0x..." }
    }
  }
}
```

## Use it without MCP

Plain HTTP with any x402 client:

```
GET https://api.aventtech.com/integration/device?make=lg&model=commercial-display-network-control
→ 402 with USDC quote → pay → answer
```

Machine faces: [llms.txt](https://api.aventtech.com/llms.txt) · [OpenAPI](https://api.aventtech.com/openapi.json) · [free catalog](https://api.aventtech.com/integration/catalog)

## What's in the knowledge base right now

Every entry is authored from first-hand commissioning experience or verified vendor documentation — never scraped, never guessed. Growing weekly.

| Make | Model/slug | Entry |
|---|---|---|
| `audinate` | `dante-network-design` | Dante audio-over-IP network design facts |
| `biamp` | `tesira-ttp` | Biamp Tesira DSPs (Tesira Text Protocol) |
| `bluesound` | `bluos-custom-integration` | BluOS multi-zone audio (Bluesound/NAD) third-party control |
| `crestron` | `din-dali-2` | Crestron DIN-DALI-2 lighting interface |
| `crestron` | `3-4-series-processor` | Crestron 3-Series / 4-Series control processors |
| `crestron` | `tsw-x70-touchpanel` | Crestron TSW-x70 series touch screens (custom CH5 UI) |
| `crestron` | `airmedia-am-3200` | Crestron AirMedia AM-3200 / AM-3100 wireless presentation |
| `crestron` | `cresnet-bus` | Crestron Cresnet device bus (keypads, dimmers, sensors) |
| `crestron` | `dm-nvx-avoip` | Crestron DM NVX AV-over-IP endpoints |
| `denon-marantz` | `avr-ip-control` | Denon / Marantz AV receivers (IP control + HEOS) |
| `epson` | `projectors-escvp21` | Epson projectors (ESC/VP21 over network) |
| `globalcache` | `itach-flex-family` | Global Caché iTach / Flex IP-to-IR/serial/relay bridges |
| `huawei` | `s310-series` | Huawei S310 series access switches (VRP V600R023–R025) |
| `knx` | `knxnet-ip-integration` | KNX/EIB integration over KNXnet/IP (Crestron and other controllers) |
| `lg` | `commercial-display-network-control` | LG commercial/signage displays (network control) |
| `mikrotik` | `routeros-v7` | MikroTik RouterOS v7 routers/switches |
| `netgear` | `m4250-av-line` | NETGEAR M4250 AV Line managed switches |
| `peplink` | `5g-cellular-wan` | Peplink 5G cellular WAN routers (remote-site links) |
| `pfsense` | `site-to-site-wireguard` | pfSense site-to-site WireGuard (yacht/branch to office) |
| `pjlink` | `projector-control-standard` | PJLink projector control (cross-vendor standard: Epson, NEC, Panasonic, Sony and others) |
| `powersoft` | `armonia-plus-amps` | Powersoft install amplifiers (ArmoníaPlus workflow) |
| `qsc` | `q-sys-external-control` | QSC Q-SYS cores (external control) |
| `samsung` | `commercial-display-mdc` | Samsung commercial displays (MDC protocol family) |
| `shure` | `p300-intellimix` | Shure P300 IntelliMix audio conferencing processor |
| `shure` | `mxwapx8` | Shure Microflex Wireless MXWAPX8 access point transceiver |
| `somfy` | `tahoma-local-api` | Somfy TaHoma local API (Developer Mode) |
| `sony` | `bravia-professional-ip-control` | Sony BRAVIA professional displays (Simple IP Control / REST) |
| `vitalpbx` | `vitalpbx-4-deployment` | VitalPBX 4.x IP-PBX deployment (Asterisk-based) |
| `wireguard` | `constrained-wan-tunnels` | WireGuard tunnels over constrained WANs (5G, satellite, maritime) |
*(This table lists what exists — the protocols, ports and notes are behind the paid endpoint. That's the shop.)*

## Trust

- Operator: AVentTech P.C., Nea Erythrea, Athens — [aventtech.com](https://aventtech.com)
- Public on-chain revenue ledger: [BaseScan](https://basescan.org/address/0x5100a134d768415cc4a25d7bdbcfc44394d62282)
- Settlement: Coinbase CDP facilitator · USDC on Base (`eip155:8453`)

MIT licensed (the server code — not the knowledge base it sells).