Skip to content
MCP server

HOA.to MCP by usefulapi

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

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About HOA.to MCP by usefulapi

HOA.to MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://hoa-to.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hoa-to": {
      "url": "https://hoa-to.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (24)

Read directly from the server.

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.

HOA.to MCP by usefulapi 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