# Tidy — how to use (mcp.ai)

Connect your Tidy account and use 10 tools for scheduling and booking straight from your AI agent. Connect with your own API key. TIDY helps to maintain a clean house. A rental. Your employee's workspace. Your home. All automated through TIDY.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_tidy?ms=1787291220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `tidy_create_address`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/tidy`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/tidy/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/tidy/create/address` — Tool to create a new address record with location data, parking information, and access instructions. Use when you need to add a new property address to Tidy.
  - body: { city?: string, unit?: string, notes?: object, address: string, country: string, parking: object, postal_code: string }
- `POST https://api.mcp.ai/api/tidy/create/pro` — Tool to add a Pro to the Priority List for all addresses in a customer account. Use when syncing professional service provider information from another application into TIDY.
  - body: { name: string, email: string }
- `POST https://api.mcp.ai/api/tidy/delete/address` — Tool to remove an address from the system by its unique identifier. Use when you need to delete an address that has no active scheduled jobs. Important: Addresses with active jobs cannot be deleted an
  - body: { address_id: string }
- `POST https://api.mcp.ai/api/tidy/list/all/addresses` — Tool to retrieve all addresses sorted by creation date with most recent first. Use when you need to view all property addresses in the Tidy system.
- `POST https://api.mcp.ai/api/tidy/list/all/jobs` — Tool to retrieve all jobs associated with an account with optional filtering by address_id, status, or to_do_list_id. Use when you need to view or manage jobs in the Tidy system.
  - body: { page?: integer, status?: string, per_page?: integer, address_id?: string, to_do_list_id?: string }
- `POST https://api.mcp.ai/api/tidy/list/available/booking/time/slots` — Tool to retrieve available booking time slots from professionals in your network for the next 4 weeks. Use when you need to find instantly available times to book a service.
  - body: { address_id: integer, service_type_key: string }
- `POST https://api.mcp.ai/api/tidy/list/guest/reservations` — Tool to retrieve all guest reservations sorted by creation date with most recent first. Use when you need to view or manage guest bookings in the Tidy system.
- `POST https://api.mcp.ai/api/tidy/list/to/do/lists` — Tool to retrieve all active address to-do lists with optional filtering by address_id, sorted by creation date with most recent first. Use when you need to view or manage to-do lists in the Tidy syste
  - body: { address_id?: string }
- `POST https://api.mcp.ai/api/tidy/retrieve/address` — Tool to retrieve the details of an existing address by its unique identifier. Use when you need to view complete information about a specific address including parking and access notes.
  - body: { address_id: string }
- `POST https://api.mcp.ai/api/tidy/update/address` — Tool to update parking details and access notes for an existing address. Use when you need to modify parking information or property access instructions. Important: Cannot update address, unit, postal
  - body: { notes?: object, parking?: object, address_id: string }

## Example prompts
- "What can I do in Tidy?"
- "Show me a summary of my Tidy account"

## More
- Page: https://mcp.ai/tidy
- Agent spec (llms.txt): https://mcp.ai/tidy/llms.txt
- Postman collection: https://mcp.ai/tidy/postman.json