# Ascora MCP by usefulapi

> Ascora MCP by usefulapi is a freemium MCP server for productivity. Hosted connector to read and create quotes, jobs and bookings in Ascora. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API
- **Website:** https://usefulapi.io/ascora/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/ascora
- **MCP Registry name:** io.usefulapi/ascora
- **Categories:** productivity, sales and CRM
- **Listing updated:** 2026-11-14

## About

Built for trades and field-service companies that already run quoting and scheduling in Ascora, this hosted server lets an assistant answer questions such as which quotes are still waiting on a customer or which completed jobs have not been invoiced. It covers customers, contacts, the supplies and kits price list, labour roles, quotes, jobs, bookings, staff and supplier invoices.

Writing is limited to a short set of actions: creating enquiries, customers, notes, quotes, jobs and bookings, changing a quote's status and converting a quote to a job. A quote created this way stays in progress and is not sent to the customer.

You sign in through OAuth with an Ascora API key generated under Administration, API Settings. Generating a new key disconnects anything using the old one. A free tier is metered per month, and the server exposes an `ascora_usage_status` tool to check the meter.

## Features

- **Quotes and jobs:** List and open quotes and jobs, including job labour lines and timesheet entries.
- **Schedule lookups:** Search bookings for jobs, quotes and activities and read the staff member, times and address.
- **Price list access:** Browse supplies, kits, inventory categories and labour roles when building a quote.
- **Customer and enquiry creation:** Create customers, enquiries and notes after searching for duplicates.
- **Quote to job conversion:** Mark a quote as won to create its job, then book staff on it.
- **Usage meter:** Built-in tools report free-tier usage and handle plan upgrades.

## Good for

- Find quotes sent but not yet accepted
- List completed jobs that still need invoicing
- See who is booked next week
- Draft a quote from labour roles and supplies
- Log a new enquiry with a note

## Install

### Claude Code (Terminal)

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

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

```sh
https://ascora.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "ascora": {
      "url": "https://ascora.usefulapi.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "ascora": {
      "serverUrl": "https://ascora.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `ascora_list_customers`: Search Ascora customers (sites and billing customers): id, number, name, contact, email, phone, addresses, on-hold flags, customer type, lead source, billing customer and assigned user. GET /Customers/Customers.
- `ascora_get_customer`: One Ascora customer by id (GUID from ascora_list_customers), including custom fields. GET /Customers/Customer/{id}.
- `ascora_list_contacts`: Search contacts across all customers by name, email or phone. GET /Customers/Contacts.
- `ascora_list_customer_contacts`: All contacts of one customer, with role and default-contact flag. GET /Customers/GetContactsForCustomer/{customerId}.
- `ascora_list_supplies`: Search the inventory price list: materials and services with part number, description, cost, sell price ex/inc tax, supplier, categories and reorder flags. Use the supply id to add items to quotes. GET /Inventory/Supplies.
- `ascora_list_kits`: Search kits (bundles of supplies and labour) with part number, description, markup, sell price and pricing method. GET /Inventory/Kits.
- `ascora_list_categories`: Inventory categories (Category 1 or 2, top-level or sub-categories) used to filter supplies and kits. GET /Inventory/Categories.
- `ascora_list_labour_roles`: Labour roles with their hourly rate ex tax, ordered by name. Use the role id to add labour to a quote. GET /Quotes/LabourRoles.
- `ascora_list_quotes`: Search quotes: number, name, status, date, totals ex/inc tax, pricing method, job type and site/billing customer. Status defaults to OPEN (in progress or sent) when omitted. GET /Quotes/Quotes.
- `ascora_get_quote`: One quote by its full number (e.g. Q57): status, dates, totals, pricing method, addresses, job type, customers and custom fields. GET /Quotes/Quote/{quoteNumber}.
- `ascora_list_jobs`: Search jobs: number, name, status, totals, pricing method, job type, site/billing customer, secondary status and pipeline phase. Status defaults to OPEN when omitted. GET /Jobs/Jobs.
- `ascora_get_job`: One job by its full number (e.g. J112): status, dates, totals, pricing method, job type, customers, secondary status and pipeline phase. A deleted job reads as not found. GET /Jobs/Job/{jobNumber}.
- `ascora_get_job_labour`: Labour lines on a job: role, hours, hourly rate, totals, staff member, chargeable and invoiced flags. GET /Jobs/JobLabour/{jobNumber}.
- `ascora_get_job_timesheets`: Timesheet entries on a job: staff member, start/end, hours, meal break and payroll-sent flag (pay and cost rates are not returned). GET /Jobs/JobTimesheets/{jobNumber}.
- `ascora_list_bookings`: Search the schedule: bookings of jobs, quotes and activities with staff member, start/end, notes, arrival window and the job or quote they belong to. Archived bookings are excluded unless include_archived. GET /Bookings/Bookings.
- `ascora_get_booking`: One booking by id: type, times (local and UTC), staff member, job/quote/activity, customers, address, notes, arrival window, rates and reminder flags. GET /Bookings/Booking/{bookingId}.
- `ascora_list_activity_types`: Activity types that non-job bookings (training, leave-style activities, etc.) can be made with. GET /Bookings/ActivityTypes.
- `ascora_list_users`: Staff users of the Ascora company (archived users excluded): id, name, email, mobile, job title, team, scheduler group, licence and access flags. Pay rates are not returned. GET /Users/Users.
- `ascora_list_suppliers`: Search suppliers by name, supplier number or exact business number (ABN). GET /Suppliers/Suppliers.
- `ascora_list_supplier_invoices`: Search supplier invoices and credit notes: supplier, dates, tracking number, lines and totals. GET /SupplierInvoices/SupplierInvoices.
- `ascora_create_enquiry`: WRITE: create a new enquiry (lead) in Ascora. Every call creates another enquiry (not idempotent; Ascora allows 500 enquiries an hour per company), so do not repeat it. Needs at least a name, company, email, phone or mobile. POST /Enquiry.
- `ascora_create_customer`: WRITE: create a new customer (site or billing) in Ascora. Always creates a new record (it never updates an existing customer), so search with ascora_list_customers first to avoid duplicates. A customer type or lead source name that does not exist is created. POST /Customers/Customer.
- `ascora_add_note`: WRITE: add a note to an enquiry, job, quote, invoice or customer (the entity must already exist). Notes cannot be edited or removed through this server, and every call adds another note. POST /Notes/Note.
- `ascora_create_quote`: WRITE: create a new quote (status In Progress; it is NOT sent to the customer) for a site customer, optionally with supplies, kits and labour from the price list. Ids that Ascora cannot find are skipped silently when creating, so check the totals in the reply. Every call creates another quote. POST /Quotes/Quote.
- `ascora_update_quote_status`: WRITE: change a quote's status to IN-PROGRESS, SENT-TO-CUSTOMER, LOST or WON. WON converts the quote into a new Job (the same as ascora_convert_quote_to_job; a second WON returns the existing job). Ascora's reference documents only a status change, not an email to the customer. POST /Quotes/UpdateStatus.
- `ascora_convert_quote_to_job`: WRITE: convert a quote into a Job (what Convert to Job does in Ascora): supplies, labour, notes, bookings and attachments carry over and the quote is marked converted. Never forces a new job: a variation quote is added onto its original job, a quote whose job still exists is reconnected to it, and a quote already converted is refused with a message naming the existing job. Specify the parent quote
- `ascora_create_job`: WRITE: create a new job for a site customer (it never updates an existing job). Every call creates another job; add work with a quote or in Ascora. The job is not booked and nothing is sent to the customer. POST /Jobs/Job.
- `ascora_create_booking`: WRITE: schedule staff on a job or a quote (give exactly one of job_number / quote_number). One booking is created per staff member and the job or quote moves to Booked; the bookings show on the Scheduler and the staff mobile apps, and Ascora's own reminder settings may notify the customer or staff. Repeating the identical request returns the existing booking. By default a clash with another bookin

## FAQ

### What credential does Ascora need?

An Ascora API key from Administration, API Settings. The login page asks for it when you connect.

### Will a quote I create be emailed to the customer?

No. Per the site, the quote stays in progress and is not sent.

### How many calls does the free tier allow?

50 tool calls a month; paid plans raise this to 10,000 or 100,000.

### Which clients can connect?

Claude, ChatGPT, Cursor, VS Code, Codex and other clients that accept a remote Streamable HTTP server.

### Is Ascora MCP by usefulapi free?

Ascora MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

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

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

### What are the best alternatives to Ascora MCP by usefulapi?

The closest alternatives to Ascora MCP by usefulapi are Ha MCP, Concord MCP, Calven, CompanyData and note1.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

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