<h1>Overview</h1>The Customer MCP (Model Context Protocol) server enables customer-facing tools and support systems to access booking and inventory data. It also provides tools for customer support workflows.<blockquote>This MCP is for direct integration with customer-facing tools and has limited access. It includes tools designed for customer support operations, not a general-purpose MCP. Let us know if this is something you want.</blockquote><h1>Finding Your MCP URL</h1><ol class="steps-list"><li>Navigate to Settings → Integrations → Customer Support</li><li>Click "View MCP Details"</li><li>Copy your MCP Server URL</li></ol>Your MCP URL follows this format:<pre class="relative language-plaintext" data-language="plaintext" onmouseenter="initCodeBlockCopy()"><button class="absolute right-2 top-2 flex cursor-pointer items-center gap-1 rounded-lg bg-white px-1.5 py-1.5 text-xs font-medium text-gray-700 shadow-sm dark:bg-gray-800 dark:text-gray-200" onclick="copyCodeBlock(this)"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-copy-icon lucide-copy h-3.5 w-3.5 transition-transform duration-200 ease-in-out hover:scale-110"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg></button><code class="language-plaintext relative">https://[your-api-url]/mcp/customer?companyId=[your-company-id]</code></pre><h1>Connecting Your MCP Client</h1><ol class="steps-list"><li>Configure your MCP client (e.g., Claude Desktop, Cline, etc.)</li><li>Add the MCP server using the URL from your settings</li><li>The server will be available for use</li></ol><h1>Available Tools</h1><h2>1. Get Inventory (<code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">get_inventory</code>)</h2>Retrieves all public products with their available locations.Description: Returns a list of all public, non-archived products with the locations where they are available. Note: This does not show real-time availability, only which locations stock each product.Parameters: NoneReturns:<pre class="relative language-json" data-language="json" onmouseenter="initCodeBlockCopy()"><button class="absolute right-2 top-2 flex cursor-pointer items-center gap-1 rounded-lg bg-white px-1.5 py-1.5 text-xs font-medium text-gray-700 shadow-sm dark:bg-gray-800 dark:text-gray-200" onclick="copyCodeBlock(this)"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-copy-icon lucide-copy h-3.5 w-3.5 transition-transform duration-200 ease-in-out hover:scale-110"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg></button><code class="language-json relative">{<text>
 </text>"products":<text> </text>[<text>
 </text>{<text>
 </text>"id":<text> </text>"product_123",<text>
 </text>"name":<text> </text>"Product Name",<text>
 </text>"description":<text> </text>"Product description",<text>
 </text>"category":<text> </text>"Category Name",<text>
 </text>"locations":<text> </text>[<text>
 </text>{<text>
 </text>"id":<text> </text>"location_456",<text>
 </text>"name":<text> </text>"Location Name"<text>
 </text>}<text>
 </text>]<text>
 </text>}<text>
 </text>]<text>
</text>}
</code></pre>Use Cases:<ul class="accent-bullets"><li>Help customers find products</li><li>Check which locations carry specific items</li><li>Provide product information during support calls</li></ul><h2>2. Get Booking by Details (<code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">get_booking_by_details</code>)</h2>Retrieves booking information using customer last name and booking number.Description: Returns booking details including links to confirmation, return, and extend pages. Useful for redirecting customers to complete their requests.Parameters:<ul class="accent-bullets"><li><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">lastName</code> (string, required): Customer's last name</li><li><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">bookingNumber</code> (number, required): The booking/order number</li></ul>Returns:<pre class="relative language-json" data-language="json" onmouseenter="initCodeBlockCopy()"><button class="absolute right-2 top-2 flex cursor-pointer items-center gap-1 rounded-lg bg-white px-1.5 py-1.5 text-xs font-medium text-gray-700 shadow-sm dark:bg-gray-800 dark:text-gray-200" onclick="copyCodeBlock(this)"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-copy-icon lucide-copy h-3.5 w-3.5 transition-transform duration-200 ease-in-out hover:scale-110"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg></button><code class="language-json relative">{<text>
 </text>"id":<text> </text>"booking_private_id",<text>
 </text>"number":<text> </text>12345,<text>
 </text>"status":<text> </text>"confirmed",<text>
 </text>"priceInCents":<text> </text>10000,<text>
 </text>"startHireDate":<text> </text>1234567890,<text>
 </text>"endHireDate":<text> </text>1234567890,<text>
 </text>"product":<text> </text>{<text>
 </text>"name":<text> </text>"Product Name"<text>
 </text>},<text>
 </text>"location":<text> </text>{<text>
 </text>"name":<text> </text>"Location Name"<text>
 </text>},<text>
 </text>"confirmationPageLink":<text> </text>"https://...",<text>
 </text>"extendBookingPageLink":<text> </text>"https://..."<text>
</text>}
</code></pre>Use Cases:<ul class="accent-bullets"><li>Look up bookings when customers call</li><li>Provide booking details and status</li><li>Direct customers to confirmation or extension pages</li><li>Verify booking information</li></ul>Error Handling:<ul class="accent-bullets"><li>Returns an error if no booking matches the provided details</li><li>Last name matching is case-insensitive</li></ul><h2>3. Send Booking Lookup Email (<code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">send_booking_lookup_email</code>)</h2>Sends a booking lookup email to a customer when they can't provide booking details.Description: Sends the standard "can't find booking" email to a customer's email address. This is used when the customer doesn't have their booking details or can't provide accurate enough information to retrieve their booking.Parameters:<ul class="accent-bullets"><li><code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">email</code> (string, required): Customer's email address (must be a valid email format)</li></ul>Returns:<pre class="relative language-json" data-language="json" onmouseenter="initCodeBlockCopy()"><button class="absolute right-2 top-2 flex cursor-pointer items-center gap-1 rounded-lg bg-white px-1.5 py-1.5 text-xs font-medium text-gray-700 shadow-sm dark:bg-gray-800 dark:text-gray-200" onclick="copyCodeBlock(this)"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-copy-icon lucide-copy h-3.5 w-3.5 transition-transform duration-200 ease-in-out hover:scale-110"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg></button><code class="language-json relative">{<text>
 </text>"success":<text> </text>true,<text>
 </text>"message":<text> </text>"If there's an email address associated with this company, you'll receive an email with your order details."<text>
</text>}
</code></pre>Use Cases:<ul class="accent-bullets"><li>Help customers who lost their booking confirmation</li><li>Provide booking information via email</li><li>Support customers who can't remember their booking number</li></ul>Security Notes:<ul class="accent-bullets"><li>Always returns a success message (does not reveal whether the email exists)</li><li>Only sends email if a matching customer and order are found</li><li>Email errors are not exposed to the client</li></ul><h1>Example Workflows</h1><h3>Workflow 1: Customer Can't Find Their Booking</h3><ol class="steps-list"><li>Customer calls support without booking details</li><li>AI uses <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">send_booking_lookup_email</code> with the customer's email</li><li>Customer receives an email with their booking information</li></ol><h3>Workflow 2: Customer Wants to Extend Booking</h3><ol class="steps-list"><li>Customer provides last name and booking number</li><li>Use <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">get_booking_by_details</code> to retrieve booking information</li><li>AI provides the <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">extendBookingPageLink</code> to the customer</li><li>Customer can extend their booking directly</li></ol><h3>Workflow 3: Customer Asks About Product Availability</h3><ol class="steps-list"><li>Customer asks about a product</li><li>Use <code class="inline-code-shadow bg-gray-100 border border-gray-200/60 dark:border-gray-800 font-medium dark:bg-gray-700/60 text-gray-700 dark:text-gray-200 font-mono text-md px-1 py-0.5 rounded-[0.2rem] [&amp;::before]:content-none [&amp;::after]:content-none">get_inventory</code> to find products and locations</li><li>AI provide information about which locations carry the product</li><li>Note: This shows locations, not real-time availability</li></ol><h2>Error Handling</h2>All tools return errors in a consistent format:<pre class="relative language-json" data-language="json" onmouseenter="initCodeBlockCopy()"><button class="absolute right-2 top-2 flex cursor-pointer items-center gap-1 rounded-lg bg-white px-1.5 py-1.5 text-xs font-medium text-gray-700 shadow-sm dark:bg-gray-800 dark:text-gray-200" onclick="copyCodeBlock(this)"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewbox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-copy-icon lucide-copy h-3.5 w-3.5 transition-transform duration-200 ease-in-out hover:scale-110"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg></button><code class="language-json relative">{<text>
 </text>"error":<text> </text>"Error type",<text>
 </text>"message":<text> </text>"Human-readable error message"<text>
</text>}
</code></pre><h2></h2><h1>Security &amp; Privacy</h1><ul class="accent-bullets"><li>This MCP can safely be publicly exposed to AI &amp; customer facing tools without risking security.</li><li>No privileged customer information is available without customer details</li><li>The MCP only accesses data for your specific company</li><li>Customer email lookups always return success (doesn't reveal if email exists)</li><li>All data access is scoped to your company ID</li><li>No sensitive customer data is exposed beyond what's necessary for support</li></ul><h1>Future Enhancements</h1>We are expanding the Customer MCP with:<ul class="accent-bullets"><li>Additional customer support tools</li><li>Enhanced booking management capabilities</li><li>More detailed inventory information</li><li>Additional integration options</li></ul>Check back regularly for updates as we continue to improve the Customer MCP.

Integrations

We currently support connecting to AI support tools via a customer specific MCP

Connecting Customer Support Tools

Setting Up Your Account

Getting Started With Self Hire

What Is Lockii?

Getting Started

Embedding On Your Site 

Analytics Integration

Websites & Embeds

Connecting Stripe Identity

Connecting Stripe Payments

Connecting An SMS Provider

Connecting A GPS Provider

Connecting iglooHome Locks

Connecting Zapier

Get an overview of how to setup and connect Lockii to all your tools.

Docs

Lockii