The endpoint
https://fix-api.onrender.com/api/v1/mcp
Tested with Claude (Settings, Connectors, add a custom connector with that URL) and with Instinct. Any MCP client that supports remote servers with OAuth should work the same way; tell us at [email protected] if yours does not.
How the customer connects
- The assistant discovers fixapp's OAuth server and registers itself (dynamic client registration).
- The customer is sent to a fixapp page, enters their phone number and the SMS code, and chooses what the assistant may do.
- The assistant receives a token for that customer only. It never sees the phone number or the code.
OAuth 2.1 with PKCE (S256) and rotating refresh tokens. Discovery: /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server on fix-api.onrender.com.
What the customer decides
| Mode | What the assistant can do |
|---|---|
| Suggest only | Search and compare. It cannot book. |
| Book with approval | Prepares a booking. The customer approves it from an SMS link before anything is sent to a professional. |
| Book on its own | Books by itself up to an amount per booking and per month that the customer sets. Anything above that waits for the customer's approval. |
These limits are enforced by fixapp's servers, not by the assistant. The customer can disconnect an assistant at any time, which ends its access at once.
Tools
| Tool | What it does |
|---|---|
get_service_catalog | Trades, their services and service ids. |
list_my_addresses | The customer's saved addresses. Bookings use an address id from here. |
get_my_permissions | The mode and spending limits the customer granted this connection. |
search_providers | Professionals for a trade who serve the customer's address, best first, with rating, completed jobs, starting price and next free slot. |
get_provider_profile | One professional's profile and recent reviews. |
get_availability | Bookable start times from the professional's real calendar. |
get_price_estimate | The catalogue price range for a service. An estimate, never a quote. |
book_service | Request a booking with one professional, or offer the job to every matching professional (the first to accept takes it). |
get_approval_status | Whether the customer approved a booking that was waiting for them. |
leave_request | When nobody covers the area: the fixapp team follows up with the customer personally. |
get_booking_status | Where a booking stands, from requested to completed. |
list_my_bookings | The customer's bookings. |
cancel_booking | Cancel while the booking is requested or accepted. |
check_service_coverage | Whether any professional for a trade serves an address or region right now: a yes or no before offering to book. |
reschedule_booking | Move a booking to a new start time while it is requested or accepted. Only for connections allowed to book on their own. |
track_job | Status and arrival estimate in minutes while the professional is on the way. Never their position. |
get_conversation | The chat between the customer and the professional on one booking. |
send_message | Send a practical message to the professional as the customer. The professional sees which assistant sent it. |
The same tools are available as plain HTTP for agents that do not use MCP: GET /api/v1/agent/tools lists them and POST /api/v1/agent/tools/<name> calls one, with the same bearer token.
A typical request
"I have a leaking kitchen sink. Find a plumber who can come tomorrow morning, my budget is 500 shekels." The assistant calls get_service_catalog, list_my_addresses, search_providers, get_availability and get_price_estimate, then book_service. If the estimate can go above the budget, the customer is asked to approve first.
What it does not do
- No online payment. The customer pays the professional directly after the job.
- Prices are estimates from the catalogue. The professional sets the final price on site.
- A booking is a request until the professional accepts it.
get_booking_statussays when they have. - Coverage today is the Sharon and Gush Dan areas, in eight trades: plumbing, electrical, AC, appliance repair, locksmith, handyman, painting and gas.
/public/coverageanswers per trade and area. Elsewhere,leave_requestreaches a person.
Rules for agents
- Every booking, cancellation and request needs an
idempotency_key. Generate one per intended action and reuse it on retries; a retry returns the first answer instead of booking twice. - Never present an estimate as a guaranteed price, and never report a booking as confirmed before the professional accepts.
- About 60 calls a minute and 20 bookings or requests an hour per connection.
Machine-readable
/catalog.json: trades, services, the regions we serve, how to send a request, and the price and payment rules. Public, no token./llms.txt: a plain-text summary of fixapp for language models.
Public API, no token
Read-only, and it names no professional. Described in OpenAPI 3.1 at /api/v1/public/openapi.json.
GET /api/v1/public/coverage?trade=plumber&lat=32.18&lng=34.87(or®ion=sharon): whether anyone for that trade serves there right now. Yes or no, never who. About 60 calls a minute per IP.GET /api/v1/public/directory: trades, services, regions and how many professionals serve each.
Searching professionals, their availability, price estimates and booking are MCP tools, used for a customer who has signed in and agreed.
Questions: [email protected].