Look up appointments, clients, services, staff and orders, and update clients in Boulevard. Hosted by usefulapi — connect from Claude, Cursor, or any MCP client.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"boulevard": {
"url": "https://boulevard.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
boulevard_get_business | read | Get the business Fetch the Boulevard business the credentials act for — name, timezone, address, phone, website. A cheap way to confirm the setup works. GraphQL: business. |
boulevard_list_locations | read | List locations List the business's locations with id, name, timezone and address. Most other tools need a location id from here. GraphQL: locations. |
boulevard_list_appointments | read | List appointments List appointments at one location, optionally for one client and filtered by a query such as a date range or staff member. Each appointment includes its client, services, staff, state and cancellation. GraphQL: appointments. |
boulevard_get_appointment | read | Get one appointment Fetch one appointment by id — time, state, notes, client, each booked service with its staff and price (in cents), cancellation details and tags. GraphQL: appointment. |
boulevard_list_clients | read | List or search clients List the business's clients, or find them by email, id list, or a query (e.g. name = 'Jane Doe', mobilePhone = '+15551234567'). GraphQL: clients. |
boulevard_get_client | read | Get one client Fetch one client by id, including contact details, appointment count, account balance (cents), scheduling alert, tags and notes. GraphQL: client. |
boulevard_list_services | read | List services List the service menu — name, category, default duration (minutes) and default price (cents), and whether it is an add-on. GraphQL: services. |
boulevard_list_staff | read | List staff List staff members with their role, locations, contact details and whether they are bookable online, optionally filtered by a query. GraphQL: staff. |
boulevard_list_shifts | read | List staff shifts List staff working shifts at one location for a date range — clock-in/out times, weekday, availability and recurrence. GraphQL: shifts. |
boulevard_list_timeblocks | read | List timeblocks List blocked time on staff calendars at one location (breaks, meetings, personal time). GraphQL: timeblocks. |
boulevard_list_orders | read | List orders List checkout orders at one location with totals (cents: subtotal, discount, tax, gratuity, total, refunds), optionally filtered e.g. by closedAt range or clientId. GraphQL: orders. |
boulevard_get_order | read | Get one order Fetch one order by id with its totals and line items (services, products, gratuity, gift cards), amounts in cents. GraphQL: order. |
boulevard_list_products | read | List products List retail products — brand, SKU, barcode, unit price and cost (cents), category. Set include_inactive to include retired products. GraphQL: products. |
boulevard_list_memberships | read | List memberships List client memberships sold by the business — status (ACTIVE, PAUSED, PAST_DUE, CANCELLED), client, price (cents), interval, term and next charge date. GraphQL: memberships. |
boulevard_list_tags | read | List tags List the tags defined for the business (ids to use with boulevard_add_tag). GraphQL: tags. |
boulevard_create_client | write | Create a client Create a new client profile. Check boulevard_list_clients by email or phone first to avoid a duplicate. GraphQL: createClient. |
boulevard_update_client | write | Update a client Change a client's name, email, mobile phone, date of birth, pronoun or external id. Only the fields you pass change. GraphQL: updateClient. |
boulevard_create_client_note | write | Add a client note Add an internal note to a client's profile (visible to staff, e.g. formulas, preferences, allergies). GraphQL: createClientNote. |
boulevard_update_appointment | write | Update an appointment Replace an appointment's internal notes and/or move its state to BOOKED, CONFIRMED, ARRIVED or ACTIVE (e.g. confirm, or check the client in). Does not cancel or reschedule. GraphQL: updateAppointment. |
boulevard_create_timeblock | write | Block staff time Block time on one staff member's calendar at a location (a break, meeting or personal time) so it cannot be booked. One-off only. GraphQL: createTimeblock. |
boulevard_add_tag | write | Apply a tag Apply an existing tag (from boulevard_list_tags) to a taggable record such as a client or appointment. GraphQL: addTag. |
boulevard_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
boulevard_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Boulevard tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Proper user | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.