--- title: "AI Receptionist MCP Server for Claude and ChatGPT | LobbyStack" canonical: "https://lobbystack.com/features/mcp/" description: "Connect Claude, ChatGPT, Cursor or VS Code to the LobbyStack AI receptionist MCP server. Review calls, book appointments, edit contacts and change your hours." --- # Manage your AI receptionist from the AI tools your team already uses Check calls, book appointments and update your hours from Claude, ChatGPT or any MCP client. You approve what each assistant can do. - Server URL: https://app.lobbystack.com/api/mcp - Try for free: https://app.lobbystack.com/en/signup - Read the setup guide: https://docs.lobbystack.com/ai/mcp - Works in Claude, ChatGPT, Cursor, VS Code and any MCP client - Sign in with LobbyStack or use an API key - One business per connection, with the permissions you approve - Every change it makes goes in your audit log ## Give Claude and ChatGPT access to your calls and appointments With the AI receptionist MCP server, your assistant works from the same calls, contacts and appointments as your dashboard. - **Ask who called and what they needed.** Ask about yesterday and the assistant lists each call with its outcome, such as a message taken or a booking left unfinished. It opens a transcript when you want the details and shows the callbacks your team still owes. - **Book an open time from the chat.** Name the customer, the service and the day. The assistant checks open times, offers a few, and books the one you pick. It cancels and reschedules too. If your receptionist takes booking requests instead, it tells you so and books nothing. ## You decide what the assistant can do When you connect, you sign in on LobbyStack's own page, so the assistant never sees your password. You pick the business, uncheck anything it shouldn't do and click Allow access. The assistant then works on that business and no other. - Only owners and admins of a business can connect an assistant to it - The connection ends after 30 days without use, or when you disconnect it - With an API key, the key's scopes set what the assistant can do ## See every connected assistant and cut one off MCP connections, under Settings > API keys, lists each assistant with who connected it, what it can do and when it last made a request. Click Disconnect and it loses access right away. - Each change goes in the audit log with the connection and the person who approved it - LobbyStack tells the assistant to check with you before it books, cancels, reschedules or replaces your hours - If the person who connected it stops being an owner or admin, the connection stops working ## The tools your assistant gets Your assistant sees only the tools its permissions allow. LobbyStack labels the read-only ones, and flags the tools that cancel, move or replace data so the assistant can ask you first. ### Calls and messages List calls newest first, open one call with its transcript, and read the messages your receptionist took for the team. | Tool | Scope | | --- | --- | | `list_calls` | `calls:read` | | `get_call` | `calls:read` | | `list_messages` | `messages:read` | ### Contacts Find people by phone, email or part of a name, open a contact, add one or change their details. | Tool | Scope | | --- | --- | | `search_contacts` | `contacts:read` | | `get_contact` | `contacts:read` | | `create_contact` | `contacts:write` | | `update_contact` | `contacts:write` | ### Appointments List appointments by status, time or customer, find open times over a span of up to 7 days, then book, cancel or reschedule. | Tool | Scope | | --- | --- | | `list_appointments` | `appointments:read` | | `get_appointment` | `appointments:read` | | `check_availability` | `appointments:read` | | `book_appointment` | `appointments:write` | | `cancel_appointment` | `appointments:write` | | `reschedule_appointment` | `appointments:write` | ### Business and knowledge Read your hours, services, staff and booking mode, replace the week's opening hours, and add an FAQ or text entry your receptionist answers from. | Tool | Scope | | --- | --- | | `get_business` | `business:read` | | `list_services` | `business:read` | | `list_staff` | `business:read` | | `update_business_hours` | `business:write` | | `add_knowledge` | `knowledge:write` | ## Run your white label clients from chat If you resell LobbyStack under your own brand, connect the assistant to your partner instead of one business. Ask it to make a demo from a prospect's website, set up a client from a template on one of your packages, or invite a teammate. It acts with your role on the team. - Sign in and pick your agency on the consent page, or use a partner platform key - Tools for demos, client businesses, packages, templates, branding and your team, with billing for owners - Each client tool takes the business to work on, and reaches only your own clients - Read the agency guide: https://docs.lobbystack.com/white-label/mcp-for-agencies ## Install Server URL: https://app.lobbystack.com/api/mcp ### Claude 1. Copy the server URL above. 2. In Claude, open Customize > Connectors, click + Add, then Add custom connector. Name it LobbyStack, paste the URL and click Continue. 3. Sign in to LobbyStack, pick your business and click Allow access. On Team and Enterprise, an owner adds the connector first under Organization settings > Connectors. ### ChatGPT 1. Copy the server URL above. 2. In ChatGPT, open Plugins, click +, then Add custom MCP server. Name it LobbyStack, paste the URL, choose OAuth and click Create as a plugin. 3. Sign in to LobbyStack, pick your business and click Allow access. In a Business workspace, an admin or owner adds the server. ### Codex 1. Run `codex mcp add lobbystack --url https://app.lobbystack.com/api/mcp`. 2. Run `codex mcp login lobbystack`. Codex opens LobbyStack in your browser. 3. Sign in, pick your business and click Allow access. The ChatGPT desktop app and the Codex IDE extension use the same connection. ### Cursor 1. Add LobbyStack to `~/.cursor/mcp.json` as `"lobbystack": { "url": "https://app.lobbystack.com/api/mcp" }` under `mcpServers`. 2. Open Cursor's MCP settings under Customize. Cursor asks you to sign in. 3. Sign in to LobbyStack, pick your business and click Allow access. ### Any MCP client 1. Copy the server URL above. 2. Add it to your client as a remote MCP server over Streamable HTTP. 3. Sign in to LobbyStack if your client supports OAuth. If it doesn't, send an API key from Settings > API keys as a Bearer token. - Read the full setup guide: https://docs.lobbystack.com/ai/mcp ## Let your AI assistant set it up Copy a prompt and paste it into your assistant. It reads our docs, shows you a plan, and stops when it needs you. ### No coding Your assistant sets up a receptionist for your business or a friend's, and tells you when it needs you. ```text Set up an AI receptionist on LobbyStack for a business, so it answers the phone. I don't code, so do everything you can yourself. Explain only what I have to do, such as signing in or paying, one step at a time and in plain words. Read these first: * `https://docs.lobbystack.com/quickstart` * `https://docs.lobbystack.com/agent/greeting-and-voice` * `https://docs.lobbystack.com/ai/mcp` * `https://docs.lobbystack.com/billing/plans` * `https://app.lobbystack.com/api/v1/openapi.json` Treat the OpenAPI spec as the source of truth. If a page and the spec disagree, follow the spec. Don't use an endpoint or field that isn't in it. Start here: 1. Ask me for the business's name, website, opening hours, main services, callers' language and the phone number that should take urgent calls. Read the website first and ask only for what's missing. 2. Ask whether the business is mine or someone else's. If it's someone else's, ask whether they'll sign up themselves, or I'll set it up and add them from Settings > Team. 3. Reply with a short plan: what you'll do, what I'll do and what it costs. Wait for my OK. Then: 1. Guide me through signing up at `https://app.lobbystack.com/signup` and finishing the onboarding steps. Write the greeting and the business details for me to paste. Only I can create the account, verify my mobile and pay. 2. Connect to the business. If you can add MCP servers, add `https://app.lobbystack.com/api/mcp`, and I'll sign in and pick the business. It lets you read calls, change opening hours and add knowledge. 3. For the greeting, services and rules, use the API with a key I create under Settings > API keys, if you can send web requests. Have me save the key where you can read it, such as an environment variable. I won't paste it into this chat, and it never goes into a website. 4. If you can't do a step, tell me exactly where to click in the dashboard. Treat this as a test business until I approve it. Stay on the free trial and have me run a browser test call. Fix what I don't like. Don't forward the real phone line, buy a plan or buy a number until I say so. If I want the business's own logo and colors, that's white label. Read `https://docs.lobbystack.com/white-label/overview` and `https://docs.lobbystack.com/white-label/branding`, and I'll sign up at `https://app.lobbystack.com/partner/signup` instead. The logo shows on the sign-in page, the dashboard and emails. Callers never see it. Tell me about these limits before I count on them: * The receptionist doesn't reply to text messages. * It can't copy someone's voice. I pick one of the voices on the agent's Name, greeting and voice page. * Website chat isn't part of the hosted plans. ``` ### Add it to your product Build an AI receptionist into your SaaS through the API. Your customers stay in your UI. ```text Add an AI receptionist to our product using LobbyStack as the backend. Our customers should stay in our UI and never need to open LobbyStack. Read these first: * `https://docs.lobbystack.com/api/overview` * `https://docs.lobbystack.com/api/authentication` * `https://docs.lobbystack.com/api/webhooks` * `https://docs.lobbystack.com/white-label/api-keys` * `https://app.lobbystack.com/api/v1/openapi.json` Treat the OpenAPI spec as the source of truth. If a page and the spec disagree, follow the spec. Don't use an endpoint or field that isn't in it. Connect: * Base URL: `https://app.lobbystack.com/api/v1` * Send `Authorization: Bearer $LOBBYSTACK_API_KEY` with an `lsp_` platform key. * Send the `LobbyStack-Business` header on per-business requests. Requests under `/partner` don't take it. * Keep keys on the server. Read them from an environment variable or a secrets manager, and never put one in browser code, a mobile app, a commit, a log or this chat. Build: 1. A typed server client for the API, generated from the spec or checked against it. 2. One LobbyStack business per customer. Call `POST /businesses` with an `Idempotency-Key`, and save the returned ID with the customer. Leave out `owner_email`, so nobody gets an invitation. 3. A settings page for greeting, hours, services and knowledge, using `PATCH /receptionist`, `PATCH /business`, `/services`, `/knowledge` and `/knowledge/sources`. 4. Pages for calls, transcripts, messages taken, contacts and appointments. 5. A `transfer_number` for each business, set with `PATCH /receptionist`. Without one, LobbyStack refuses the calls the receptionist can't take. Finish onboarding with `POST /onboarding/complete`, and send `skip_number: true` if the business has no number. 6. Phone numbers, if our customers need them: `POST /phone-numbers/search`, then `POST /phone-numbers/claims` with an `Idempotency-Key`, then poll `GET /phone-numbers/claims/{claim_id}` until it's `claimed` or `failed`. This needs a paid tier and a key with `phone_numbers:manage` and `phone_numbers:purchase`. Ask before you buy one. 7. A verified, duplicate-safe webhook endpoint for `call.completed`, `appointment.booked`, `appointment.rescheduled`, `appointment.cancelled`, `message.taken` and `contact.created`. Subscribe each business with `POST /webhooks` and store its secret. Verify the signature against the raw body, skip a `webhook-id` you've already processed, and answer `2xx` within 10 seconds. Limits: * The API can't send texts, and no webhook reports incoming texts. The AI doesn't reply to texts. * `GET /messages` returns only the messages the receptionist took for the team. It isn't a text inbox. * Hosted plans use Twilio numbers. * Website chat isn't part of the hosted plans, so `POST /widget-keys` returns `403` there. * LobbyStack has no voice cloning. Pick one of GPT-Live's voices with `voice` on `PATCH /receptionist`. Start with a test business, and run the whole flow on it before you touch real customers. `DELETE /partner/businesses/{business_id}` removes it afterwards and needs `partner.businesses:write`. Ask me first. Only I can sign up as a partner at `https://app.lobbystack.com/partner/signup`, make the platform key on the partner console's API keys page, and pay for a tier. Before you change any code, reply with a short plan: what you'll build, which access the key needs, what I have to do and what will cost money. Wait for my OK. ``` ### Your logo and colors Your assistant sets up a white-label receptionist under your brand. ```text Set up a white-label AI receptionist on LobbyStack with our name, logo and colors. Do everything you can yourself, and ask me only for what you can't do, such as signing up, adding DNS records or paying. Read these first: * `https://docs.lobbystack.com/white-label/overview` * `https://docs.lobbystack.com/white-label/sign-up` * `https://docs.lobbystack.com/white-label/branding` * `https://docs.lobbystack.com/white-label/api-keys` * `https://docs.lobbystack.com/api/authentication` * `https://app.lobbystack.com/api/v1/openapi.json` Treat the OpenAPI spec as the source of truth. If a page and the spec disagree, follow the spec. Don't use an endpoint or field that isn't in it. Connect: * I sign up at `https://app.lobbystack.com/partner/signup`, then make a platform key on the partner console's API keys page. Tell me which access to turn on. * Base URL: `https://app.lobbystack.com/api/v1` * Send `Authorization: Bearer $LOBBYSTACK_API_KEY` with an `lsp_` platform key. * Send the `LobbyStack-Business` header on per-business requests. Requests under `/partner` don't take it. * Keep keys on the server. Read them from an environment variable or a secrets manager, and never put one in browser code, a mobile app, a commit, a log or this chat. * If you can't send web requests, connect to `https://app.lobbystack.com/api/mcp` as the partner. `https://docs.lobbystack.com/white-label/mcp-for-agencies` lists what that connection can do. Tell me which steps then stay for me in the console. Do this: 1. Ask me for our name, logo, favicon, brand color, support email, and our terms, privacy and support links. 2. Set them with `PATCH /partner/brand`. Send the logo and favicon in base64: PNG, JPEG, WebP or SVG, up to 256 KB each. Then give me our dashboard address to check. 3. Start with a test business. Create it with `POST /businesses` and an `Idempotency-Key`, and leave out `owner_email`. Set its greeting, hours, services and knowledge, then finish onboarding with `POST /onboarding/complete`. 4. Have me open it from the partner console's Businesses page and run a browser test call. 5. If we want our own domain, check that we're on a paid tier, call `POST /partner/domain` with a subdomain such as `app.example.com`, and give me the DNS records to add. Check `GET /partner/domain` until the domain is live. Facts to plan around: * A partner has one brand, and all its businesses share it. A business that needs its own logo needs its own partner. * Callers hear the business's name. They never see the logo. * LobbyStack's name still appears in a few places, listed in the white label overview. Tell me about them. * A key can buy numbers only on a paid tier, with `phone_numbers:manage` and `phone_numbers:purchase`. Ask before you buy one. * The API can't send texts, and no webhook reports incoming texts. The AI doesn't reply to texts. * `GET /messages` returns only the messages the receptionist took for the team. It isn't a text inbox. * Hosted plans use Twilio numbers. * Website chat isn't part of the hosted plans, so `POST /widget-keys` returns `403` there. * LobbyStack has no voice cloning. Pick one of GPT-Live's voices with `voice` on `PATCH /receptionist`. Before you do anything, reply with a short plan: what you'll do, which access the key needs, what I have to do and what will cost money. Wait for my OK. ``` ## Questions about the MCP server ### What is the LobbyStack MCP server? It connects Claude, ChatGPT and other AI assistants to your LobbyStack AI receptionist. The Model Context Protocol server lives at https://app.lobbystack.com/api/mcp. Through it, an assistant reads a business's calls, messages, contacts and appointments, books and changes appointments, updates opening hours and adds FAQs. It speaks Streamable HTTP, and assistants sign in with OAuth or send an API key. ### Which AI assistants work with it? Claude (the web and Desktop connectors, Claude Code and the Claude API), ChatGPT, the OpenAI Responses API, Codex, Cursor and VS Code. Any client that supports Streamable HTTP can connect. Clients that only offer the older HTTP+SSE transport can't. ### Is the MCP server included in my plan? Yes. Every LobbyStack plan includes the MCP server, the Free plan too, at no extra cost. ### Do I need a developer to set it up? Not for Claude or ChatGPT. You paste the server URL, sign in to LobbyStack and allow access. ChatGPT supports custom MCP servers on Business, Enterprise and Education plans, and on Pro for read-only tools. Codex and Cursor sign in the same way after one command or config line. ### Can the assistant do more than I allowed? No. It works on the one business you picked and sees only the tools for the permissions you left checked. With an API key, the key's scopes decide the same way. Only owners and admins of a business can connect an assistant to it. ### Can the assistant book appointments? Yes, when Booking is set to Books appointments. If your receptionist takes requests instead, the booking tools return an error and the assistant tells you your team confirms requests from the inbox. If booking is off, it tells you that. Cancelling works in every mode. ### How do I disconnect an assistant? Go to Settings > API keys in LobbyStack and click Disconnect next to it under MCP connections. It loses access right away. For an assistant that uses an API key, revoke the key on the same page. ### Can an agency connect to all of its clients at once? Yes. If you resell LobbyStack under your own brand, sign in and pick your agency on the consent page, or use a platform key from the partner console. The assistant then makes demos, sets up client businesses from your templates and packages, and manages your team, with your role on the team. Each client tool takes the business to work on, and it reaches only your own clients. ### Does it work with a self-hosted LobbyStack? Yes. A self-hosted install serves the same path on its own domain, such as https://lobbystack.example.com/api/mcp. Claude and ChatGPT connect from the internet, so the install needs a public HTTPS address. ### Is it the same as the WebMCP tools on lobbystack.com? No. The website registers a few read-only WebMCP tools in the browser that describe LobbyStack's public pages, features and pricing. They never touch a business. The MCP server works on your own business's data after you sign in. ### Is there a rate limit? Yes, 120 requests per minute. Each tool call counts, and listing the tools doesn't. An API key shares that limit with its REST requests, and each OAuth connection has its own. Past the limit, the tool tells the assistant how many seconds to wait. ## Connect your team's AI tools to your AI receptionist Create a free LobbyStack account and set up your receptionist. Then add the server URL to Claude or ChatGPT and ask who called today. - Try for free: https://app.lobbystack.com/en/signup - Read the MCP docs: https://docs.lobbystack.com/ai/mcp - MCP server: https://lobbystack.com/features/mcp/