Connecting AI Agents and Bots (MCP)
You can connect your own chatbot or AI agent to LaundryVerse. A Messenger bot that tells customers when their laundry is ready, takes bookings, or quotes your prices can read and update your shop's data directly, with no copying between apps. LaundryVerse speaks MCP (Model Context Protocol), the open standard most AI agent tools support. This page shows how to create a key, where to point your bot, and what it can do. About 5 minutes.
Only the account owner can create and revoke API keys, from Settings > API Keys. API access is included on the Business plan and above, and during your free trial.
Before you start
- A key belongs to your business, not to a branch. A bot connected with your key sees every store on your account. Tell it which branch to use when a customer asks.
- Pick only the permissions the bot needs. A bot that only answers "is my laundry ready?" needs Read Orders and Read Stores, nothing else.
- The key is shown once. Copy it right after you create it and store it somewhere safe, such as your bot platform's secret settings. If you lose it, revoke it and create a new one.
- Treat a key like a password. Anyone holding it can act on your shop's data within the permissions you chose. Never paste it into a public page or a group chat.
1. Create an API key
- Open Settings > API Keys in the dashboard.
- Click Create Key.
- Give it a name you will recognize later, for example
Messenger Bot. - Tick the permissions the bot needs (see the table below).
- Click Create, then copy the key. It starts with
mcp_lv_.
2. Point your bot at LaundryVerse
The Connection details card at the top of Settings > API Keys shows your MCP server URL with a copy button:
https://laundryverse.app/api/mcp
In your bot or agent tool, add an MCP server (it may be called a "remote MCP server" or "Streamable HTTP" connection) with:
| Setting | Value |
|---|---|
| Server URL | https://laundryverse.app/api/mcp |
| Header | Authorization: Bearer <your key> |
Once connected, the tool lists the actions below and your bot can start using them.
What a bot can do
| Permission | What it allows |
|---|---|
| Read Orders | List and search orders, look up one order, and preview the next available finish date for a branch |
| Write Orders | Create a new unpaid order (the reply includes the customer's tracking link), mark an order paid, partially paid, or claimed |
| Read Customers | Search customers by name or phone and look up their details |
| Write Customers | Add a new customer and add or deduct loyalty points |
| Read Items | Read your price list: services, products, and their prices |
| Read Stores | Read your branches' names, contact details, and hours |
| Create Notifications | Send a notification that your staff see on the POS |
A bot cannot see reports or sales totals, shifts, expenses, or staff, and cannot change your prices or items. Those stay in the dashboard.
Plan limits
| Plan | API keys | Requests per minute |
|---|---|---|
| Starter | Not included | Not included |
| Business | 2 | 60 |
| Pro | 5 | 180 |
| Enterprise | Unlimited | 600 |
Your free trial includes API access, so you can build and test a bot before you subscribe. If your subscription lapses to Starter, connected bots stop working until you renew. See Subscription & Billing.
Common issues
"My bot gets Unauthorized"
The key is missing, mistyped, or revoked. Check that the header reads exactly Authorization: Bearer followed by the full key, with no extra spaces. If you are unsure, revoke the key and create a new one.
"My bot says API access requires a Business plan"
Your account is on Starter, or your trial or subscription has ended. Upgrade to Business or above on Subscription & Billing.
"My bot says the rate limit is exceeded"
The bot sent more requests in one minute than your plan allows. It can retry after a minute. If this happens often, upgrade for a higher limit.
"My bot says a permission is missing"
The key does not include the permission that action needs. Create a new key with the right permissions, update your bot, then revoke the old key.
What's next?
- Multi-store: how branches work, so your bot can answer for the right one.
- Customer Order Tracking: the tracking page your bot can send customers.
- Items: keep your price list current so the bot quotes the right prices.
Stuck? Email [email protected]. The founder reads every message.