# HOA.to MCP by usefulapi

> HOA.to MCP by usefulapi is an MCP server. Read units, owners, charges and requests, and record payments and violations in HOA.to. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/hoa-to/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/hoa-to
- **MCP Registry name:** io.usefulapi/hoa-to
- **Listing updated:** 2026-11-13

## About

Read units, owners, charges and requests, and record payments and violations in HOA.to.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hoa-to https://hoa-to.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://hoa-to.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hoa-to": {
      "url": "https://hoa-to.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hoa-to": {
      "type": "http",
      "url": "https://hoa-to.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hoa-to": {
      "serverUrl": "https://hoa-to.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hoa-to": {
      "type": "http",
      "url": "https://hoa-to.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `hoato_ping`: Show the association this key belongs to, whether it is a live or test key, and its scopes. Write tools need write: true. Call this first. Uses GET /ping.
- `hoato_list_units`: List every unit in the association, ordered by unit number. Uses GET /units.
- `hoato_get_unit`: Fetch one unit by id, with its current owners and residents. Uses GET /units/{id}.
- `hoato_create_unit`: Add a unit to the association. unitNumber must be unique; a duplicate returns 409. Needs a write key. Uses POST /units.
- `hoato_update_unit`: Change the fields you send on one unit. Omitted fields stay as they are. Needs a write key. Uses PATCH /units/{id}.
- `hoato_list_owners`: List owners and residents, optionally for one unit. Past owners appear only when includeEnded is true. Uses GET /owners.
- `hoato_add_owner`: Attach an owner, co-owner, tenant, occupant or property manager to a unit, matched by email. Needs a write key. Uses POST /owners.
- `hoato_update_owner`: Change the relation, primary flag or notes of one ownership, or end it with endDate and endReason. Ending an ownership removes it from current owners. Needs a write key. Uses PATCH /owners/{id}.
- `hoato_list_requests`: List maintenance and architectural review (ARC) requests. Filter by kind, status, unit or open (not finished). This list pages by limit only; it has no cursor. Uses GET /requests.
- `hoato_get_request`: Fetch one maintenance or ARC request by id. Uses GET /requests/{id}.
- `hoato_create_request`: Open a maintenance request, or an ARC request (which needs unit and description). Defaults: NEW for maintenance, SUBMITTED for ARC. Needs a write key. Uses POST /requests.
- `hoato_update_request`: Change the fields you send on one request, such as status, priority, schedule, cost or decision note. Omitted fields stay as they are. Needs a write key. Uses PATCH /requests/{id}.
- `hoato_list_charges`: List assessments and other charges. status "open" covers OPEN and PARTIAL charges. Uses GET /charges.
- `hoato_list_payments`: List payments recorded for the association, newest first. Uses GET /payments.
- `hoato_record_payment`: Record a payment that was already collected elsewhere, for example by check or bank transfer. It applies to the unit's open charges, oldest first. It does NOT charge a card or move money. Needs a write key. Uses POST /payments.
- `hoato_get_ledger`: Get every charge and payment for one unit as a dated ledger with a running balance and the outstanding total. Charges are debits, payments are credits. Uses GET /ledger/{unit}.
- `hoato_list_violations`: List open and past violations, newest first. Uses GET /violations.
- `hoato_file_violation`: Record a violation against a unit, with photo URLs. It records the violation only: it sends no notice and sets no fine. A person decides the next step in HOA.to. Needs a write key. Uses POST /violations.
- `hoato_list_documents`: List published association documents, optionally in one category. Uses GET /documents.
- `hoato_publish_document`: Publish a document that is already hosted at a URL, and set who can see it with visibility. Owners with that access can see it at once. Needs a write key. Uses POST /documents.
- `hoato_list_meetings`: List board, annual, special and committee meetings with their minutes. upcoming true returns future meetings, oldest first. Uses GET /meetings.
- `hoato_get_meeting`: Fetch one meeting by id, with its agenda and minutes. Uses GET /meetings/{id}.
- `hoato_schedule_meeting`: Schedule a meeting with an agenda and an optional quorum. Needs a write key. Uses POST /meetings.
- `hoato_list_announcements`: List published announcements to owners, newest first. Uses GET /announcements.

## FAQ

### How do I add HOA.to MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http hoa-to https://hoa-to.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/hoa-to-mcp-by-usefulapi
