Configure MCP
Connect a compatible assistant to the directory or one specific business.
Choose your endpoint
Bookwise uses MCP over Streamable HTTP. In a client that supports remote MCP, choose an HTTP/remote server connection and enter one of these URLs. Field names and configuration-file locations vary by client; these values are transport settings, not a universal client config file.
https://bookwise.live/api/mcphttps://bookwise.live/api/b/your-business-slug/mcp| Endpoint | Available tools | Business selection |
|---|---|---|
| Directory | 27 tools | Pass a business ID or booking-page slug as businessId |
| Business (deprecated) | 25 tools | Scoped to that business; use the directory endpoint with its slug instead |
Connection settings
| Setting | Value |
|---|---|
| Transport | Streamable HTTP |
| URL | Directory or business URL above |
| Public discovery | No account required |
| Booking management | holdToken or accessToken in tool arguments, as described by the tool |
| Owner operations | Valid owner session bearer token or existing signed session cookie |
Use an HTTPS deployment URL for a remote client. A localhost address is reachable only by a client running in an environment that can access that machine. Client support and organization policies determine whether remote MCP connections and custom headers are available.
Owner access is separate
Authorization: Bearer <valid-owner-session-token>The server validates existing owner sessions and business ownership on every owner call. A user ID, business ID or customer booking token is not an owner credential. Expired or revoked sessions stop working. Do not put session tokens in public URLs, repositories, browser-delivered examples or prompts.
Check the connection
- Connect with an MCP client and let it negotiate the protocol.
- Call tools/list and inspect each inputSchema, description and outputSchema.
- On the directory, call search_businesses with a relevant query. On a business endpoint, call get_business with no arguments.
- Use real returned business/offering IDs for the next request. Read get_business.bookingParamsSchema before constructing params.
A business URL returning 404 usually means the slug is wrong or the business is not published. Tool errors are different from connection errors; see Errors and retries.