---
title: "Vulpo developer resources"
description: "Vulpo is a Home Assistant client, not a platform: there is no public HTTP API, no webhook API and no MCP server. What follows is the whole surface a developer or an agent can integrate with, and the requirements Vulpo places on a Home Assistant server."
canonical: "https://vulpo.app/developers"
url: "https://vulpo.app/developers.md"
last-updated: "2026-08-26"
version: "1.2"
---

# Vulpo developer resources

> Vulpo is a Home Assistant client, not a platform: there is no public HTTP API, no webhook API and no MCP server. What follows is the whole surface a developer or an agent can integrate with, and the requirements Vulpo places on a Home Assistant server.

## There is no public API

Vulpo does not expose an HTTP API, an OpenAPI specification, webhooks, an SDK or an MCP server, and there is no developer account, API key or sandbox to request. Nothing in the app can be driven from a server you control.

This is a deliberate consequence of the architecture: Vulpo holds no data of its own. It reads and writes your Home Assistant server directly and stores dashboards in your private iCloud database, so there is no backend for a third party to call. If you need programmatic access to a home, call the Home Assistant REST and WebSocket APIs on that server.

## Machine-readable endpoints on this site

Every page of vulpo.app is static HTML at its own URL and is also available as markdown. Append .md to any page path, or send an Accept: text/markdown request header to the HTML URL and the same document comes back as text/markdown; charset=utf-8.

- https://vulpo.app/llms.txt: index of the site with a when-to-use section
- https://vulpo.app/llms-full.txt: the FAQ, comparison, feature pages, pricing and changelog as one document
- https://vulpo.app/sitemap.xml: every published page with a real lastmod
- https://vulpo.app/robots.txt: crawl policy, every AI search and training agent allowed
- https://vulpo.app/faq.md and the .md twin of any other page

## Automating Vulpo on device

The supported way to drive Vulpo from other software is App Intents. Vulpo ships intents for Siri, the Shortcuts app, the Action button and Spotlight that read entity state and run actions, so a Shortcut, an automation or an Apple Intelligence request can query the home and control it without touching Home Assistant directly.

HomePass exports a complete Vulpo setup, dashboards, cards, renames, icons and appearance, as a file that another device or another person can import. It is the supported way to move or clone a configuration; the format is internal and is not a public interchange format.

## Home Assistant requirements

Vulpo works with any current Home Assistant release, running as Home Assistant OS, Container, Core or Supervised. It needs no custom integration, add-on or HACS component on the server.

- WebSocket API for live state, REST and history APIs for charts and logbook
- The mobile_app integration for push notifications, device sensors and location reporting
- A reachable URL: a local address, an external address, or both with automatic switching
- Features that depend on newer Home Assistant capabilities, such as the Energy dashboard or areas and floors, need a server version that provides them

## Sign-in contract (IndieAuth)

Vulpo signs in with the standard Home Assistant IndieAuth flow. The client identifier is the site itself, https://vulpo.app, and the page advertises its redirect target with a link rel=redirect_uri tag pointing at vulpo://auth. Home Assistant fetches the site during sign-in and reads that tag, so the page is part of the auth contract rather than only marketing.

No credentials ever reach Joshua Dessol Design. The access token Home Assistant issues is stored in the device Keychain and is never synced to iCloud or sent anywhere else.

Vulpo 1.2. Last updated 2026-08-26. Source: https://vulpo.app/developers

---

- HTML version of this page: https://vulpo.app/developers
- Site index for agents: https://vulpo.app/llms.txt
- Everything in one document: https://vulpo.app/llms-full.txt
- All pages: https://vulpo.app/sitemap.xml