{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3nf6auk365d2","handle":"esphome-mcp-client","url":"https://wellknown.network/agents/esphome-mcp-client","links":{"self":"https://wellknown.network/agents/esphome-mcp-client/record.json","html":"https://wellknown.network/agents/esphome-mcp-client","markdown":"https://wellknown.network/agents/esphome-mcp-client/record.md","api":"https://wellknown.network/api/v1/agents/esphome-mcp-client","status":"https://wellknown.network/api/v1/agents/esphome-mcp-client/status","claim":"https://wellknown.network/agents/esphome-mcp-client/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/esphome-mcp-client/claim.json","badge":"https://wellknown.network/agents/esphome-mcp-client/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/esphome-mcp-client/history","tools":"https://wellknown.network/api/v1/agents/esphome-mcp-client/tools"},"ard":{"identifier":"urn:air::server:esphome-mcp-client","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"esphome-mcp-client","summary":"Async client for the Home Assistant Supervisor and ESPHome dashboard / Device Builder API","description":"# ESPHome MCP Bridge\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=jrigling&repository=esphome-mcp-integration&category=integration)\n[![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=esphome_mcp_bridge)\n\nDrive a **full ESPHome development cycle from an AI agent** (e.g. Claude Code\nvia Home Assistant's MCP server). This repo ships a Home Assistant custom\nintegration that registers a custom LLM API exposing ESPHome tools, backed by a\nsmall reusable PyPI client library.\n\n```\nAI agent ── MCP ──► Home Assistant ──► ESPHome Builder LLM API\n                                          │\n                          ┌───────────────┴───────────────┐\n                          ▼                                ▼\n                 /config/esphome (files)        ESPHome dashboard add-on\n                                                (stable / beta / dev) via\n                                                Supervisor internal network\n```\n\n## Why this works without sidecars\n\nThe integration runs **inside Home Assistant Core**, so it has:\n\n- **Native filesystem access** to `/config/esphome` for reading, creating, and\n  writing YAML — reliable and independent of which add-on is installed.\n- **Internal network access** to the ESPHome dashboard add-on through the\n  Supervisor, reaching the dashboard's container directly (no ingress auth, no\n  exposed ports) for validate / compile / upload / run / logs.\n\nNo changes to the ESPHome add-on and no external containers required.\n\n## The development-cycle tools\n\nThe `ESPHome Builder` LLM API exposes these tools:\n\n| Tool | Purpose |\n|------|---------|\n| `esphome_list_addons` | Discover installed ESPHome channels (stable/beta/…","publisher":null,"homepage":"https://github.com/jrigling/esphome-mcp-integration#readme","repository":"https://github.com/jrigling/esphome-mcp-integration#readme","version":"0.3.0","license":null,"protocols":["mcp"],"tags":["esphome","home-assistant","mcp","device-builder","iot"],"pricing":null,"endpoints":[{"url":"pypi:esphome-mcp-client","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"},{"slug":"infra.devices","name":"Devices & IoT","confidence":1,"provenance":"declared"}],"categories":["dev","infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"esphome-mcp-client","registry":"pypi","observedAt":"2026-09-15T14:26:55.154Z","publishedAt":"2026-07-19T03:37:54.821003Z","latestVersion":"0.3.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"esphome-mcp-client","url":"https://pypi.org/project/esphome-mcp-client/","firstSeenAt":"2026-09-09T15:21:45.344Z","fetchedAt":"2026-09-15T14:24:52.693Z","normalizedAt":"2026-09-15T14:24:52.693Z"}]},"firstSeenAt":"2026-09-09T15:21:45.344Z","updatedAt":"2026-09-15T14:26:55.154Z"}