{
  "info": {
    "name": "Ascora — mcp.ai",
    "description": "REST API for the Ascora 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/ascora",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "ascora_create_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "note"
          ]
        },
        "description": "Creates a note on an entity (customer, job, quote, etc.) in Ascora. Use this when you need to add comments, updates, or documentation to any entity in the system. Requires a valid entity ID from the A",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"Note\": \"\",\n  \"EntityId\": \"\",\n  \"EntityType\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_create_or_update_contact",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/or/update/contact",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "or",
            "update",
            "contact"
          ]
        },
        "description": "Tool to create a new contact or update an existing contact for a customer. Use when you need to add or modify contact information for a specific customer in Ascora. Requires a valid customer ID and ac",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"Email\": \"\",\n  \"Phone\": \"\",\n  \"LastName\": \"\",\n  \"FaxNumber\": \"\",\n  \"FirstName\": \"\",\n  \"customerId\": \"\",\n  \"MobileNumber\": \"\",\n  \"DefaultContact\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_create_or_update_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/or/update/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "or",
            "update",
            "customer"
          ]
        },
        "description": "Tool to create a new customer or update an existing customer in Ascora. Use when you need to add a new customer with company name and optional contact details, address information (street and postal),",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"CompanyName\": \"\",\n  \"PhoneNumber\": \"\",\n  \"PostalLine1\": \"\",\n  \"PostalLine2\": \"\",\n  \"PostalState\": \"\",\n  \"StreetLine1\": \"\",\n  \"StreetLine2\": \"\",\n  \"CustomerName\": \"\",\n  \"EmailAddress\": \"\",\n  \"MobileNumber\": \"\",\n  \"PostalSuburb\": \"\",\n  \"StreetSuburb\": \"\",\n  \"PostalCountry\": \"\",\n  \"StreetCountry\": \"\",\n  \"PostalPostcode\": \"\",\n  \"StreetPostcode\": \"\",\n  \"ContactLastName\": \"\",\n  \"ContactFirstName\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_create_or_update_supplier",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/or/update/supplier",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "or",
            "update",
            "supplier"
          ]
        },
        "description": "Tool to create a new supplier or update an existing supplier in Ascora. Use when you need to add a new supplier with contact and address details, or modify an existing supplier's information by provid",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"fax\": \"\",\n  \"Name\": \"\",\n  \"notes\": \"\",\n  \"phone\": \"\",\n  \"mobile\": \"\",\n  \"supplierId\": \"\",\n  \"postalLine1\": \"\",\n  \"postalLine2\": \"\",\n  \"postalState\": \"\",\n  \"streetLine1\": \"\",\n  \"streetLine2\": \"\",\n  \"streetState\": \"\",\n  \"emailAddress\": \"\",\n  \"postalSuburb\": \"\",\n  \"streetSuburb\": \"\",\n  \"businessNumber\": \"\",\n  \"expenseAccount\": \"\",\n  \"postalPostcode\": \"\",\n  \"streetPostcode\": \"\",\n  \"supplierNumber\": \"\",\n  \"contactLastName\": \"\",\n  \"contactFirstName\": \"\",\n  \"invoiceDueDaysType\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_create_quotation",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/quotation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "quotation"
          ]
        },
        "description": "Creates a new quotation/enquiry in Ascora for a customer. Use this tool when you need to submit a quote request with customer details (name, email, contact info), optional address information, work de",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\",\n  \"phone\": \"\",\n  \"mobile\": \"\",\n  \"lastName\": \"\",\n  \"firstName\": \"\",\n  \"companyName\": \"\",\n  \"addressLine1\": \"\",\n  \"addressLine2\": \"\",\n  \"addressState\": \"\",\n  \"customFields\": \"\",\n  \"addressSuburb\": \"\",\n  \"addressCountry\": \"\",\n  \"addressPostcode\": \"\",\n  \"enquiryDescription\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_delete_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "customer"
          ]
        },
        "description": "Tool to delete a specific customer by ID. Use when you need to remove a customer after confirming its existence.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"customer_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_contact",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/contact",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "contact"
          ]
        },
        "description": "Tool to retrieve details of a specific contact by their unique identifier. Use when you need to fetch information about a contact including their name, contact details, address, and customer associati",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"contact_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_customer",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/customer",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "customer"
          ]
        },
        "description": "Tool to retrieve details of a specific customer by their unique identifier. Use when you need to fetch information about a single customer including contact details, addresses, and status.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"customer_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_customers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/customers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "customers"
          ]
        },
        "description": "Retrieves all customers from the Ascora system. Returns a list of customer records including contact information (name, email, phone) and address details (street, city, state, postcode, country). This",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_inventory_categories",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/inventory/categories",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "inventory",
            "categories"
          ]
        },
        "description": "Retrieves all inventory categories used to organize supplies and kits in Ascora. Returns a paginated list of categories with their IDs, names, and numeric identifiers. Use this when you need to list a",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_inventory_kits",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/inventory/kits",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "inventory",
            "kits"
          ]
        },
        "description": "Retrieves all inventory kits from Ascora. Returns a paginated list of kit items that bundle multiple supplies together. Use this when you need to list available inventory kits or access kit details fo",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_inventory_supplies",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/inventory/supplies",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "inventory",
            "supplies"
          ]
        },
        "description": "Retrieves all inventory supplies with pricing and stock information from Ascora. Returns a paginated list of supply items. Use this when you need to list available inventory supplies or access supply ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"pageSize\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_job",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/job",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "job"
          ]
        },
        "description": "Retrieves details of a specific job by its unique identifier. Returns comprehensive job information including job number, name, status, customer details, dates, and other job-specific data. Use this w",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_jobs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/jobs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "jobs"
          ]
        },
        "description": "Retrieves a paginated list of jobs from Ascora with optional filtering by job type, status, secondary status, and date range. Returns job details including job number, name, status, customer informati",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"endDate\": \"\",\n  \"jobType\": \"\",\n  \"pageSize\": 0,\n  \"jobStatus\": \"\",\n  \"startDate\": \"\",\n  \"secondaryStatus\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_quote_labour_roles",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/quote/labour/roles",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "quote",
            "labour",
            "roles"
          ]
        },
        "description": "Retrieves labour roles available for use in quotes from Ascora. Use this when you need to list available labour roles with their hourly rates for quotation purposes.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_quote_standard_sections",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/quote/standard/sections",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "quote",
            "standard",
            "sections"
          ]
        },
        "description": "Retrieves standard sections that can be used in quotes. Returns a list of pre-configured standard sections that can be included in quotations. This is a read-only operation that requires authenticatio",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_quote_standard_stages",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/quote/standard/stages",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "quote",
            "standard",
            "stages"
          ]
        },
        "description": "Retrieves standard stages that can be used in quotes for progress tracking. Use this when you need to list available quote stages, display progress tracking options, or reference standard stages for q",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_quotes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/quotes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "quotes"
          ]
        },
        "description": "Retrieves a paginated list of quotes from Ascora with optional filtering by status, date range, or customer. Returns quote details including quote number, customer information, status, creation date, ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"status\": \"\",\n  \"endDate\": \"\",\n  \"pageSize\": 0,\n  \"startDate\": \"\",\n  \"customerId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_supplier",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/supplier",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "supplier"
          ]
        },
        "description": "Tool to retrieve details of a specific supplier by ID. Use when you need to fetch supplier information including contact details, address, and business information.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_supplier_invoices",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/supplier/invoices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "supplier",
            "invoices"
          ]
        },
        "description": "Retrieves supplier invoices from Ascora with optional pagination. Returns invoice details including invoice number, supplier name, dates, amounts, and status. Use this when you need to list, search, o",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"pageSize\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_get_suppliers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/suppliers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "suppliers"
          ]
        },
        "description": "Retrieves a list of suppliers from the Ascora system. Returns supplier details including name, contact information (email, phone), address details, ABN, and activity status. Use this when you need to ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"pageSize\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_search_jobs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/jobs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "jobs"
          ]
        },
        "description": "Search for jobs by various criteria including job number, customer, or address. Use this when you need to find specific jobs based on identifiers or search terms rather than filtering by status or typ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"address\": \"\",\n  \"customer\": \"\",\n  \"pageSize\": 0,\n  \"jobNumber\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ascora_upload_attachment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/upload/attachment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "upload",
            "attachment"
          ]
        },
        "description": "Tool to upload an attachment to an entity (quote, job, customer, etc.) in Ascora. Use when you need to attach files like documents, images, or plans to existing entities in the system.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file\": {},\n  \"entity_id\": \"\",\n  \"entity_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}