Tumaro MCP server

Connect AI assistants — Claude, ChatGPT, Cursor, or anything that speaks the Model Context Protocol — directly to Tumaro. Detailers: assistants can find your business, read your services and prices, check your availability, and send customers to book you. Customers: your assistant can find and book detailers and manage your bookings, garage and rewards. Booking and payment always finish on tumaro.app.

Connect

Endpoint

https://tumaro.app/api/mcp

Add the endpoint to any MCP client that supports OAuth — Claude, ChatGPT, Cursor — and it will walk you through Tumaro sign-in and a consent screen, exactly like connecting a Google account. No keys to copy; access tokens expire after an hour and refresh automatically, and you can disconnect anytime below or by revoking the token.

Claude Code example

claude mcp add tumaro https://tumaro.app/api/mcp --transport http
# then: /mcp → tumaro → Authenticate

Manual token (read-only)

For clients without OAuth support, create a token below and send Authorization: Bearer <token> on every request. Manual tokens carry the read scope only.

Permissions (scopes)

read

See detailers, services, availability, and your own bookings

book

Get checkout links and cancel your bookings (payment stays on tumaro.app)

account

View and manage your vehicles, addresses, and rewards

You choose what to grant on the consent screen. Every tool acts only on YOUR account — ids sent by the assistant are never trusted for ownership — and nothing over MCP can move money: booking always hands off to checkout on tumaro.app.

Available tools

For detailers

How AI assistants put your business in front of customers: they find you by location, read your live service menu and prices, check your open times from your published hours, bookings, lunch and blocked time, and hand customers a prefilled checkout for your services. New bookings show up in your appointments like any other. Your menu, hours and availability are managed in the Tumaro app (or with Tumaro AI in your business dashboard). Managing them over MCP isn't available yet.

find_detailers

public

Find detailers near a latitude/longitude (optional radius). Returns ratings, completed washes, insurance-on-file status, distance, and profile links.

get_services

public

A detailer's active service menu — names, prices, durations — plus their add-ons.

get_availability

public

Approximate open 30-minute start times for a date, based on published hours minus existing bookings, lunch, and blocked time.

get_booking_status

public

Status of a booking by its TUM- confirmation code — status, service, detailer, scheduled time, amounts. Never customer details.

start_booking

book

Assemble a booking (detailer, service, add-ons, validated time) and get a prefilled checkout link. Payment always finishes on tumaro.app — assistants can never charge your card.

For customers

Find and book detailers from your assistant, check or cancel your bookings, and manage your garage, saved addresses and rewards.

find_detailers

public

Find detailers near a latitude/longitude (optional radius). Returns ratings, completed washes, insurance-on-file status, distance, and profile links.

get_services

public

A detailer's active service menu — names, prices, durations — plus their add-ons.

get_availability

public

Approximate open 30-minute start times for a date, based on published hours minus existing bookings, lunch, and blocked time.

get_booking_status

public

Status of a booking by its TUM- confirmation code — status, service, detailer, scheduled time, amounts. Never customer details.

get_my_bookings

read

Your own upcoming or past bookings — status, detailer, time, address, totals.

start_booking

book

Assemble a booking (detailer, service, add-ons, validated time) and get a prefilled checkout link. Payment always finishes on tumaro.app — assistants can never charge your card.

cancel_booking

book

Cancel one of your bookings. First call returns the fee/refund quote and a confirmation token; a second call with that token executes it.

list_vehicles / add_vehicle

account

Read or save vehicles in your garage.

list_addresses / add_address

account

Read or save your service addresses.

get_rewards

account

Your reward-coin balances per detailer and their checkout value.

health_check

public

Server version and the scopes your token carries.

Public tools return the same marketplace data any visitor sees on the Tumaro map and business profiles. Scoped tools return only the connected user’s own data. Requests are rate-limited per token and per IP.

Access tokens

Rescheduling through MCP and in-chat slot holds are planned next. Connections made via OAuth appear in the token list above (named “OAuth: <app>”) and can be revoked there at any time.