{
  "info": {
    "name": "Tidy — mcp.ai",
    "description": "REST API for the Tidy MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/tidy",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "tidy_create_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "address"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"city\": \"\",\n  \"unit\": \"\",\n  \"notes\": {},\n  \"address\": \"\",\n  \"country\": \"\",\n  \"parking\": {},\n  \"postal_code\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "tidy_create_pro",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/pro",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "pro"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"email\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "tidy_delete_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "address"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"address_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "tidy_list_all_addresses",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/all/addresses",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "all",
            "addresses"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "tidy_list_all_jobs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/all/jobs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "all",
            "jobs"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"status\": \"\",\n  \"per_page\": 0,\n  \"address_id\": \"\",\n  \"to_do_list_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "tidy_list_available_booking_time_slots",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/available/booking/time/slots",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "available",
            "booking",
            "time",
            "slots"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"address_id\": 0,\n  \"service_type_key\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "tidy_list_guest_reservations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/guest/reservations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "guest",
            "reservations"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "tidy_list_to_do_lists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/to/do/lists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "to",
            "do",
            "lists"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"address_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "tidy_retrieve_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "address"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"address_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "tidy_update_address",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/address",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "address"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"notes\": {},\n  \"parking\": {},\n  \"address_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}