fixapp להורדת האפליקציה

Connect an AI assistant to fixapp

An assistant that speaks the Model Context Protocol (MCP) can find a vetted home-repair professional in Israel, check their real availability and book them for a customer, who never has to open the app.

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

  1. The assistant discovers fixapp's OAuth server and registers itself (dynamic client registration).
  2. The customer is sent to a fixapp page, enters their phone number and the SMS code, and chooses what the assistant may do.
  3. 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

ModeWhat the assistant can do
Suggest onlySearch and compare. It cannot book.
Book with approvalPrepares a booking. The customer approves it from an SMS link before anything is sent to a professional.
Book on its ownBooks 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

ToolWhat it does
get_service_catalogTrades, their services and service ids.
list_my_addressesThe customer's saved addresses. Bookings use an address id from here.
get_my_permissionsThe mode and spending limits the customer granted this connection.
search_providersProfessionals for a trade who serve the customer's address, best first, with rating, completed jobs, starting price and next free slot.
get_provider_profileOne professional's profile and recent reviews.
get_availabilityBookable start times from the professional's real calendar.
get_price_estimateThe catalogue price range for a service. An estimate, never a quote.
book_serviceRequest a booking with one professional, or offer the job to every matching professional (the first to accept takes it).
get_approval_statusWhether the customer approved a booking that was waiting for them.
leave_requestWhen nobody covers the area: the fixapp team follows up with the customer personally.
get_booking_statusWhere a booking stands, from requested to completed.
list_my_bookingsThe customer's bookings.
cancel_bookingCancel while the booking is requested or accepted.
check_service_coverageWhether any professional for a trade serves an address or region right now: a yes or no before offering to book.
reschedule_bookingMove a booking to a new start time while it is requested or accepted. Only for connections allowed to book on their own.
track_jobStatus and arrival estimate in minutes while the professional is on the way. Never their position.
get_conversationThe chat between the customer and the professional on one booking.
send_messageSend 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

Rules for agents

Machine-readable

Public API, no token

Read-only, and it names no professional. Described in OpenAPI 3.1 at /api/v1/public/openapi.json.

Searching professionals, their availability, price estimates and booking are MCP tools, used for a customer who has signed in and agreed.

Questions: [email protected].