Fresha MCP for AI. Analyze your salon data from natural conversation.

Q: Can I use listappointments to check if a staff member is free?

Yes. You can ask your agent to query listappointments combined with liststaff. It checks the scheduled times against registered personnel, letting you see immediate gaps.

Q: Does listsales include details about which services were used?

Yes. When querying listsales, your agent can pull detailed transaction records using listsaleitems. This shows exactly what was purchased or applied for each sale.

Q: How do I check if a specific product is in stock?

You run a query on listinventory. The agent returns the real-time count of that item, ensuring you don't promise a client something you sold out of.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Connect to your AI in seconds.

Fresha allows you to query and analyze your salon or spa data directly through natural conversation. Pull appointments, client histories, sales records, staff details, inventory levels, services offered, and location information instantly from any AI agent.

What your AI can do

List appointment services

Lists the services that are included in a client's booked appointment.

List appointments

Retrieves a list of scheduled appointments, including status and time slots.

List clients

Fetches detailed records for all customers in the system.

+ 8 more capabilities included

Track daily appointments and services

Retrieve detailed lists of scheduled client bookings and the specific services associated with those appointments.

Manage and analyze client data

Access full customer profiles, contact details, and complete service histories for any individual client.

Review sales and financial performance

Get breakdowns of all recorded sales transactions, including itemized receipts and invoice totals.

Inspect business structure details

List physical locations, available products in inventory, service menus, and staff professional profiles across the network.

Monitor staff performance and location assignments

See who works at which site and manage records for all registered staff members.

Ask an AI about this

Included with Plan

Waiting for input…

AI Agent

Fresha: Your Salon Business Connector (11 Tools)

Use these 11 tools to query every core area of your salon business—from client data to daily sales reports.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Fresha on Vinkius

List Appointment Services

Lists the services that are included in a client's booked appointment.

List Appointments

Retrieves a list of scheduled appointments, including status and time slots.

List Clients

Fetches detailed records for all customers in the system.

List Inventory

Shows current stock levels and details for physical products you sell.

List Locations

Retrieves a list of all physical business sites managed by the company.

List Products

Lists retail products available for sale in the salon or spa.

List Reviews

Gets a list of customer feedback and reviews left through the platform.

List Sale Items

Retrieves itemized lists for specific sales transactions, like what was purchased in...

List Sales

Lists all completed sales and revenue records across the business.

List Services

Provides a list of every service that can be offered to clients, including pricing.

List Staff

Lists all registered staff members and their professional profiles within the system.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

Start a conversation

Open a new chat. The Fresha integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "fresha": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the Fresha tools with full Vinkius guardrails applied.

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"fresha": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with Fresha, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 5,100+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Fresha. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 11 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Sifting through end-of-day spreadsheets takes hours.

Right now, figuring out how well your staff performed requires jumping between three tabs: the booking calendar, the sales receipt log, and the inventory count. You're clicking 'Export to CSV,' opening Excel, and then spending an hour writing formulas just to compare what was sold versus what you actually have left on the shelf.

With this MCP connected, you simply ask your agent, 'How much product did we sell from the shampoo line last week?' The answer comes back immediately. You get a clean number, no spreadsheets, and zero manual clicking.

List_clients: See everything about a person's history.

Previously, if you needed to know what a client had done before, you’d have to manually look up their name in the booking system and then cross-reference that with past invoice receipts. It was slow, messy, and easy to miss details.

Now, your agent retrieves the full profile using `list_clients`. You don't just see a contact record; you get a complete history of every visit, service, and item purchased in one place.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

What your AI can actually do with this

Connecting your Fresha workspace gives your AI agent deep insight into every aspect of your salon's operations. You talk to it like a person—you ask questions about business performance or client status, and it pulls the precise data points you need without manual exports or navigating complex dashboards. This capability works by running powerful queries against all core operational tables, making insights available immediately.

Since Vinkius is the central catalog for these connections, you connect once to get access to this Fresha MCP alongside thousands of other industry tools.

It’s about getting answers—like 'What was the total revenue from massages last month?' or 'Who booked an appointment at the Westside Spa location today?'—and having your agent deliver a clean, actionable report right back to you.

Built · Hosted · Managed by Vinkius Fresha MCP - Analyze Salon and Spa Data

Server ID 019ea5ed-ae6a-7058-8fdf-d19175644936

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

What Changes When You Connect

Stop running manual reports. You can ask for the last five completed appointments, including who booked them and what services were performed, all in one prompt using list_appointments and list_appointment_services.

Instantly audit sales data. Get a total count of today's revenue or check individual invoice details by querying list_sales and then drilling down with list_sale_items for deeper insight.

Understand your client base better than ever. You can pull up specific customer profiles using list_clients, view their service history, and track retention patterns without leaving the chat window.

Manage physical assets easily. Check current stock levels in real-time by running a query on list_inventory or review which products are sold most often via list_products.

Get a full picture of your brand's reach. You can check multiple locations using list_locations and verify which staff members (list_staff) work at each site to plan staffing shifts.

See it in action

01 01

The weekly revenue audit

A manager needs to confirm total sales last week. Instead of pulling the bulky reports, they ask their agent to run a query on list_sales for the date range, immediately getting a summarized financial overview and spotting any unusual dips in certain service lines.

02 02

Checking staff availability

An owner needs to know if enough licensed therapists are available next Tuesday. They ask their agent to cross-reference list_staff records with the upcoming appointments listed by list_appointments, ensuring they schedule properly.

03 03

Investigating a specific client's history

A consultant needs context on a returning high-value client. They use their agent to query list_clients and immediately see every service the person has ever booked, helping them tailor a personalized recommendation.

04 04

Inventory mismatch check

An operations analyst suspects products sold aren't being tracked right. They ask the agent to compare sales data from list_sale_items against current stock levels using list_inventory for immediate discrepancies.

The honest tradeoffs

Manual spreadsheet cross-referencing

Anti-pattern

Trying to reconcile staff schedules (from one sheet) with booked appointments (from another system), leading to missed conflicts and inaccurate capacity planning.

The Fix

Use your agent to query list_staff against list_appointments. You ask for 'all unassigned shifts next week,' and it pulls the conflict data immediately.

Over-relying on printed reports

Anti-pattern

Printing out a full list of every sale from last quarter, only to realize you need to filter by one specific service type that wasn't in the report.

The Fix

Ask your agent to query list_sales and then specifically check the itemized details using list_sale_items to narrow down exactly what was purchased.

Forgetting location context

Anti-pattern

Assuming that a client's history is always tied to one specific store, even when they visit multiple branches.

The Fix

Use list_locations first. Then ask the agent to pull a filtered list of appointments using list_appointments specifically for 'Downtown Salon'.

When It Fits, When It Doesn't

Use this MCP if your workflow requires asking complex, cross-functional questions about operational data—like 'Show me all clients who booked a haircut and bought product X at the Westside Spa location last month.' You need an AI agent to stitch together multiple data points (clients, appointments, locations, sales) on demand. Don't use this if you only need to view a single list of static information, like just listing available products (list_products)—a basic database tool would handle that fine. If your core job is writing new service definitions or managing employee payroll outside of the existing data structure, you might need a dedicated HR system API instead.

Questions you might have

Can I use list_appointments to check if a staff member is free? +

Yes. You can ask your agent to query list_appointments combined with list_staff. It checks the scheduled times against registered personnel, letting you see immediate gaps.

Does list_sales include details about which services were used? +

Yes. When querying list_sales, your agent can pull detailed transaction records using list_sale_items. This shows exactly what was purchased or applied for each sale.

How do I check if a specific product is in stock? +

You run a query on list_inventory. The agent returns the real-time count of that item, ensuring you don't promise a client something you sold out of.

Is list_services limited to only appointment services? +

No. While it lists core service types, you can also ask about retail products by querying list_products for the full menu.

When I use list_clients, can my agent pull together a client's full history of appointments using their ID? +

Yes, the agent compiles that data for you. You provide the client name or ID, and we cross-reference records from list_appointments to give you a complete service timeline.

If I use list_staff, can I specify which physical location (via list_locations) an employee is assigned to? +

You absolutely can filter by location. We combine data from list_staff and list_locations, so you only see staff working at a specific branch or spa.

When running list_inventory, what filters are available if I want to group items by category rather than searching by name? +

The tool supports structured filtering. You can apply OData filters to narrow the search results down to specific categories or supplier groups within the inventory.

If list_sale_items is run with an invoice number that doesn't match any record in list_sales, how does the system handle it? +

The agent will return a clear error message. It confirms the mismatch and advises you on correcting the invoice ID or checking the date range for the transaction.

Can I filter appointments by status or date using this server? +

Yes! The list_appointments tool supports standard OData $filter parameters. For example, you can pass Status eq 'Completed' or filter by start times to isolate specific booking periods.

How do I retrieve the specific services booked within an appointment? +

You can use the list_appointment_services tool, or use the $expand parameter in list_appointments to load related service details in a single query.

Can I view financial transactions and checkout details? +

Yes. Use the list_sales tool to query invoices and transactions, and the list_sale_items tool to inspect individual line items, products, or services sold during checkout.

Connect to your AI in seconds.

List appointment services

List appointments

List clients

Fresha: Your Salon Business Connector (11 Tools)

Make your AI actually useful.

List Appointment Services

List Appointments

List Clients

List Inventory

List Locations

List Products

List Reviews

List Sale Items

List Sales

List Services

List Staff

Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI

Define the Tool

Execute Task

Choose How to Get Started

Build Your Own

Make Your AI Do More

Works with Claude, ChatGPT, Cursor, and more

Sifting through end-of-day spreadsheets takes hours.

List_clients: See everything about a person's history.

What your AI can actually do with this

Here's how it actually works

Who is this actually for?

What Changes When You Connect

See it in action

The weekly revenue audit

Checking staff availability

Investigating a specific client's history

Inventory mismatch check

The honest tradeoffs

Manual spreadsheet cross-referencing

Over-relying on printed reports

Forgetting location context

When It Fits, When It Doesn't

Questions you might have