Skip to content
MCP server

AgendaPro MCP by usefulapi

Hosted MCP server for AgendaPro salon and spa bookings, clients, slots and sales

Status and history

Answered our latest tool-list check 3 hours ago with 24 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.21.0
Listing updated
2 days ago

About AgendaPro MCP by usefulapi

AgendaPro MCP by usefulapi is a freemium MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

Aimed at salons, spas and other appointment businesses, this connector lets an assistant answer the questions a front desk asks all day: what is booked at a location tomorrow, which provider still has an afternoon slot, and which sales are only partly paid. It can also book, move or cancel appointments, so it is one of the few servers in its family with write tools.

Booking is a two-step flow: it first checks open slots for a location, service and provider, then creates the booking for an existing client. Cancellation cannot be undone through the AgendaPro API. Client records can be searched by name, email, phone or identification number, and created or updated.

Setup needs an AgendaPro API key, which requires AgendaPro's Pro plan and is shown only once when created. A company can have two active keys, so a dedicated one is easy to revoke, and a key limited to some scopes limits the tools the same way. It must include at least one of the locations, providers or services read scopes.

Install

Run in a terminal

claude mcp add --transport http agendapro https://agendapro.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://agendapro.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agendapro": {
      "url": "https://agendapro.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "agendapro": {
      "type": "http",
      "url": "https://agendapro.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agendapro": {
      "serverUrl": "https://agendapro.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "agendapro": {
      "type": "http",
      "url": "https://agendapro.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (24)

Read directly from the server.

agendapro_list_locations
List the business's locations (sucursales / locales): id, name, address, phone, email, timezone, opening hours and country. Location ids are needed for bookings, slots and sales filters. GET /v3/locations.
agendapro_get_location
One location by id, with address, coordinates, timezone and weekly opening hours. GET /v3/locations/{id}.
agendapro_list_services
List the services (treatments, classes, sessions) the business offers: id, name, price, duration, type, category, whether online booking/payment is on, and the location. Service ids are needed to book. GET /v3/services.
agendapro_get_service
One service by id, including its category, images and the providers who perform it. GET /v3/services/{id}.
agendapro_list_service_categories
List service categories, ordered as the business arranges them. GET /v3/categories.
agendapro_list_providers
List service providers (the staff who take bookings): id, public name, location, active flag, online-booking flag and working hours. Provider ids are needed to book. GET /v3/providers.
agendapro_get_provider
One service provider by id, with biography, images and working hours including breaks. GET /v3/providers/{id}.
agendapro_list_bookings
List bookings (reservas / appointments) with time, status, service, provider, client id, location, price and the linked sale. AgendaPro requires at least ONE of client_id, location_id, service_id or service_provider_id; dates only narrow the result. A sale may be a membership covering several bookings, so do not total amounts by sale id. GET /v3/bookings.
agendapro_get_booking
One booking by id with status, service, provider, client id, location, prices, notes and the linked sale. GET /v3/bookings/{id}.
agendapro_list_available_slots
Free booking time windows at a location on one date (optionally for one service and/or provider): start/end time, provider, plus a metadata summary (service duration, slot count). Use before creating a booking. GET /v3/available_slots.
agendapro_create_booking
WRITE: create a booking for an existing client, service, provider and location. Check agendapro_list_available_slots first. status_id must be a non-cancelled status: copy the status.id of an existing booking (agendapro_list_bookings). AgendaPro does NOT send email/SMS/WhatsApp notifications for bookings created through the API. Not idempotent: calling twice books twice. POST /v3/bookings.
agendapro_update_booking
WRITE: change an existing booking (partial update: only the fields you pass change): move it, switch service/provider/location, change status, price or notes. The merchant's customer policy applies: a change too close to the start time, or past the maximum number of changes, is refused with HTTP 422 and must not be retried. PATCH /v3/bookings/{id}.
agendapro_cancel_booking
WRITE: cancel a booking. This cannot be undone through the API. The merchant's customer policy applies: a cancellation that is disabled, too close to the start time or past the maximum number of changes is refused with HTTP 422 (tell the user the merchant does not allow it; do not retry). Confirm with the user before calling. PATCH /v3/bookings/{id}/cancel.
agendapro_list_clients
List the business's clients (customers) page by page: name, email, phone, identification number, address, birth date, record number, active flag. Personal data: only use it for the task at hand. To find one person use agendapro_search_clients. GET /v3/clients.
agendapro_search_clients
Find clients by free text (name, email, phone, identification number or record number): a short ranked list with id, full name, email, phone. The fastest way to get a client_id. GET /v3/clients/quick-search.
agendapro_get_client
One client by id with contact details, address, birth date, record number and active flag. GET /v3/clients/{id}.
agendapro_list_client_custom_attributes
The custom attribute values stored for one client (id, name, datatype, value). GET /v3/clients/{id}/custom_attributes.
agendapro_list_custom_attributes
The custom client fields the business defined (id, name, datatype, mandatory, group, choices). Use the template ids when setting custom_attributes on a client. GET /v3/custom_attributes.
agendapro_create_client
WRITE: create a new client. first_name is required and at least one of last_name, email or phone must also be given (AgendaPro's rule). Search first (agendapro_search_clients) to avoid duplicates; not idempotent. No message is sent to the client. POST /v3/clients.
agendapro_update_client
WRITE: change an existing client (partial update: only the fields you pass change; it overwrites the stored value). PATCH /v3/clients/{id}.
agendapro_list_sales
List sales (ventas): status (partially_paid, paid, canceled, refunded), paid and pending amounts, paid-at time, location, client id and the payment transactions. Filter by paid date range, location or client. GET /v3/sales.
agendapro_get_sale
One sale by id with amounts, status, location and its payment transactions (amount, paid-at, payment method). GET /v3/sales/{id}.
agendapro_list_products
List retail products in the catalog: name, SKU, price, active flag, category, brand and display. GET /v3/products.
agendapro_get_product
One catalog product by id with description, SKU, price, category, brand and display. GET /v3/products/{id}.

What it does

Day view of bookings
Lists a location's bookings with time, status, service, provider and price.
Open slot search
Finds free time windows by location, date, service or provider.
Client search
Searches clients by name, email, phone or identification number and lists their bookings.
Sales review
Shows paid, partially paid, canceled and refunded sales with pending amounts.
Create and change bookings
Books, reschedules, edits or cancels appointments for existing clients.
Catalogue reads
Lists locations, services, categories, providers and products.

Good for

  • Check tomorrow's appointments at a branch
  • Find an afternoon slot with a given provider
  • Book a service for a returning client
  • Find unpaid or partly paid sales from last week
  • Look up a client's upcoming bookings

Pricing

Freemium, from $9 a month

Free: 50 tool calls a month; Pro $9/mo (10,000 calls); Pro+ $39/mo (100,000 calls).

Prices change. Check usefulapi.io before you buy.

AgendaPro MCP by usefulapi FAQ

What do I need to connect?

An AgendaPro API key, created under Configuraciones and Integraciones. API access needs AgendaPro's Pro plan.

Can it cancel bookings?

Yes, but a cancellation cannot be undone through the API.

Can I limit what it does?

Yes. A key restricted to certain scopes restricts the tools in the same way.

What does the connector cost?

Free for 50 tool calls a month, then $9 or $39 a month per user for larger quotas.

Is AgendaPro MCP by usefulapi free?

AgendaPro 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 AgendaPro MCP by usefulapi to Claude Code?

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

What are the best alternatives to AgendaPro MCP by usefulapi?

The closest alternatives to AgendaPro MCP by usefulapi are Ha MCP, Concord MCP, note1, Later Stages and CalderFlow.

Alternatives to AgendaPro MCP by usefulapi

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. Virkly CVR

    MCP server

    Czech property marketplace for AI agents that draft sales and bids, with people deciding

    • Remote
    • Free
    • Local services