MCP server and API

LotsBusiness for
your AI agent.

Keep one record per business and let your agent build its website on a lotssite.com address or your own domain, create and post to its Google Business Profile, work through the local directories it should be on and set up email on its domain. The directory listing is free; agencies run their clients' businesses from one workspace.

https://api.lots.business/mcp
125Tools

Ask your agent, for example.

Once LotsBusiness is connected, plain requests like these work.

  • “Build a website for my salon from our listing and send me the preview.”
  • “Post this weekend's offer to our Google Business Profile.”
  • “Which local directories should my plumbing business be on?”

Connect in two minutes.

Claude

Settings → Connectors → Add custom connector. Paste the URL, connect, and sign in with your Lots account.

ChatGPT

Plugins → + → Add custom MCP server. Name it, enter the URL under Connection, choose OAuth, tick I understand and want to continue, then Create as a plugin. Install it, sign in, and type @ in a new chat to pick it. Full MCP is on Business, Enterprise and Edu, on the web; Pro is read and fetch only.

Claude Code

claude mcp add --transport http lots-business https://api.lots.business/mcp

Codex

codex mcp add lots-business --url https://api.lots.business/mcp

Cursor, Windsurf and others

{
  "mcpServers": {
    "lots-business": {
      "url": "https://api.lots.business/mcp"
    }
  }
}

Cloud agents without MCP

Give the agent https://api.lots.business/docs.md and an API key from lotstech.com/api. It calls the REST API with Authorization: Bearer <key>.

Every server uses OAuth: your agent acts as you, inside your own roles and workspaces. You can disconnect it at any time from the app.

125 tools, also REST endpoints.

Each tool is available over MCP and as a REST endpoint under https://api.lots.business/api/v1/lotsbusiness.

Accept Business Handover

For the client: accept a hand-over into one of your workspaces (personal by default). Your workspace's plan or credits pay for the business from now on.

Accept Workspace Invitation

Accept a workspace invitation with the token from its link. You must be signed in with the invited email.

Activate Business

Make a business a paid unit, which unlocks its website, custom domain, Google Business Profile creation and posts, the directory list and business email. Uses a free place on the workspace owner's plan, or credits. Owners and admins only.

Add Business Photo

Attach a photo or video URL to a business you own. Upload the file first; only the resulting URL is stored.

Add Contact Recipient

Send website messages to another address (up to 3). The address must confirm by a link first. Without any, messages go to the business email, or the workspace owner.

Answer A Question

Answer a question asked on a business you own. The answer becomes public.

Archive Business

Archive a business you own instead of deleting it. It stops being paid (its website goes offline), leaves the directory and nobody can open it. Nothing is deleted, and the owner can restore it for 30 days with restore_business. Owner only. Confirm with the person first; confirm_name must be the business name.

Archive Workspace

Archive an agency workspace you own once it holds no active businesses (move or archive them first). Nobody can open it until it is restored. Nothing is deleted; the owner can restore it for 30 days with restore_workspace. confirm_name must be the workspace name. Confirm with the person first.

Ask A Business A Question

Ask a public question on a business profile. The owner is notified and can answer.

Autofill A Business From Its Website

Read a business's own website and return the facts it states (name, description, phone, email, address, hours from schema.org), each with its source. Saves nothing: create_business or update_business with the values the owner confirms.

Cancel Business Handover

Cancel a pending hand-over.

Cancel Business Team Invitation

Cancel a pending invitation. This does not remove an accepted member.

Cancel Workspace Invitation

Cancel a pending workspace invitation.

Check Site

Run the quality and safety check on a version (latest by default). Errors block publishing; warnings are advice.

Claim A Business

Claim a business listing that has no owner yet. Verification is by matching email domain, a token on the business website, or manual review. The strongest method your evidence supports is chosen automatically.

Complete Google Business Verification

Submit a verification PIN the owner received for a pending Google verification. Never guess a PIN.

Connect Google Business Profile

Create a short-lived Google consent URL. Call this when Google is not connected; return the URL to the owner and stop retrying until they finish consent.

Connect Site Domain

Connect a domain the owner already owns (e.g. www.example.com). Returns the one DNS record they add. Then poll get_site_domain_status. Owners and admins; paid businesses only.

Create Approval Link

Create a link the client can open without an account to review the draft website (scope site), the business details (profile) or both (all), and approve or ask for changes. Valid 14 days by default. Nothing is published by the client's answer.

Create Business

List a business you own. Set business_type to physical, service_area or online; an online business stores no street address at all. Pass city_slug to attach it to a known city. A new listing is reviewed before it is public, and goes live as soon as the business is made paid.

Create Checkout

Get a checkout link for a LotsBusiness plan (plan starter|pro|business, cycle annual|monthly; annual by default) or a LotsTech Credits top-up (amount_usd 10 to 1000). Only the workspace owner pays. Give the link to the person; never pay for them.

Create Google Business Post

Post an update to the business's Google Business Profile: STANDARD (news, with an image or a button), EVENT (title and dates) or OFFER (title, dates, coupon, terms). One public https image. Buttons: BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP (with url) or CALL. Ask the owner to approve the text first. Google reviews posts; a rejected post is reported as an error.

Create Google Business Profile

Create exactly the previously previewed Google profile. Requires the single-use confirmation token returned by preview after the owner explicitly approves that exact data. It is idempotent and must not be retried with a new preview after an uncertain result.

Create Site

Create the business's website on its LotsBusiness address (<name>.lotssite.com). Optionally start from a kit (from_kit) with a theme; otherwise write every file yourself with create_site_version. Requires a paid business. Idempotent: returns the existing site.

Create Site Version

Save a new draft version of the site and get its check result and a private preview_url. files: [{path, content}] for text files, [{path, blob}] for images from upload_site_image. With base_version, unchanged files carry over and you send only what changed (delete_paths removes files). Nothing goes live until publish_site.

Create Workspace

Create an agency workspace that holds client businesses and your team. You become its owner and pay for its businesses.

Deactivate Business

Stop paying for a business. Its free directory listing stays; its website goes offline and paid features stop. Ask the owner before calling this.

Delete Business Media

Remove one photo or video from the business.

Delete Google Business Post

Delete a post from the business's Google Business Profile. name is the post's resource name from list_google_business_posts. Ask the owner first.

Edit Site Texts

Change editable texts by key (from get_site_editables). Creates a new draft version with a preview; publish it to go live.

Export Site

Download a version (live by default) as a zip. Returns a link valid for one hour.

Find Businesses In A City

Find businesses of a given category in a given city, for example plumbers in chennai. Matches businesses based in the city and those that declare it as a service area.

Get Billing

The workspace owner's LotsBusiness plan or credits, today's funding state, how many businesses are paid, and the plans (Starter 1, Pro 5, Business 25 businesses; yearly is the better price). Defaults to your personal workspace.

Get Business

Get the full public profile of one business by slug: contact details, location, hours, categories, media, service areas and rating summary.

Get Business Analytics

Daily views, clicks, calls and direction requests for a business you own.

Get Business Category

Get one category by slug, including its child categories.

Get Business Completeness

What the record still needs for a good website, a Google Business Profile and directory listings. Ask the owner only for what is listed as missing; never invent it.

Get Business Email Status

Business email setup status: domain, ownership, funding, receiving and sending setup, and the records still needed.

Get Business Handover

For the client: what is being handed over and the workspaces they can receive it into.

Get Collection

Get one collection by slug with the businesses in it.

Get Google Business Connection

Check whether Google is connected and list only the Google accounts and existing locations available to the signed-in owner. Use this before preparing a new profile and inspect likely duplicates.

Get Google Business Profile Status

Read the persisted creation state and Google Voice of Merchant status for an owner's business.

Get Google Verification Options

Ask Google which verification methods are currently eligible. For a service-area business, pass its private verification address only when the owner explicitly supplies it; it is used for Google verification and is never copied to the public LotsBusiness listing.

Get Listing Pack

Everything a directory asks for, worded the same way every time (name, phone, address or service area, website, categories, descriptions of 80/160/750 characters, hours, services, photos), built only from the record, plus what is missing.

Get Location

Get one location by slug, with its parent and children. US city slugs carry a state suffix (austin-tx); Indian city slugs do not (chennai).

Get My Business

Get the full record of a business you own, including categories, service areas and media.

Get My Profile

Your personal LotsBusiness member profile (display name, bio, avatar), not a business. For a business use get_my_business.

Get Site

The business's website: address, live and latest version, recent versions with check results, connected domains, kit and theme.

Get Site Analytics

Page views by day, top pages and top referrers (cookieless) for up to 90 days.

Get Site Domain Status

Status of the site's domains and their certificates, with the DNS record each needs. The first domain to go active becomes the primary address.

Get Site Editables

The editable text regions (data-lb-edit) of a version, for changing texts without code.

Get Site File

Read one file of a version (latest by default).

Get Site Files

List the files and pages of a version (latest by default). Read before editing.

Get Site Guide

Read this before writing a website: the build loop, live-fact markers (data-lb), editable regions, what blocks publishing, the quality bar and what each kind of business needs. Also lists the starter kits and limits.

Get Workspace

Get one workspace: members and roles, pending invitations (admins), and its businesses with whether each is paid.

Invite Business Team Member

Invite a person to assist with a business as admin, manager, or viewer. Never assign ownership through this tool.

Invite Workspace Member

Invite a teammate to a workspace as admin (manages team and billing), manager (edits every business) or viewer (reads). Returns an accept link valid for 7 days. To give a client access to one business only, use invite_business_member instead.

Leave Workspace

Leave a workspace you are a member of. Owners cannot leave their own workspace.

Link CRM Workspace

Send this business's website messages into a LotsCRM workspace as well as by email: each sender becomes a lead contact (or is matched by email or phone) with the message on their timeline. Give workspace_id to link (you need write access to that LotsCRM workspace; messages are written as you), or unlink: true to stop.

Link Google Business Location

Link a Google Business Profile that already exists (managed by the connected Google account) to this business, instead of creating a new one. location_name comes from get_google_business_connection_status.

List Approval Links

Approval links for a business with each client's decision and comment.

List Business Categories

List every business category, with parent/child structure and how many businesses each holds.

List Business Directories

The audited local directories that fit this business (its country and trade), with how to submit to each and this business's progress. The owner or agency submits; give them the listing pack.

List Business Handovers

Hand-overs of a business and their status.

List Business Media

List the business's photos, logo, cover and videos in display order.

List Business Reviews

List published reviews for a business, with the owner reply where one exists. Only reviews that passed moderation are returned.

List Business Services

List the business's services in display order.

List Business Team

List the owner, team members, roles, and pending invitations for a business the caller can access.

List Businesses

Browse published businesses in the Lots Business directory. Filter by category, city, country, business type or price range. Business types are physical (customers visit an address), service_area (travels to the customer) and online (no customer-facing premises).

List Collections

List curated collections and city guides.

List Contact Messages

Messages sent through the website's contact form, newest first (spam hidden unless status=spam).

List Directory Submission Targets

The public catalogue of business directories LotsBusiness knows about. For the directories that fit one business, with how to submit and its progress, use list_business_directories. LotsBusiness does not submit listings on anyone's behalf.

List Directory Submissions

This business's directory progress, newest first.

List Google Business Posts

The latest posts on the business's Google Business Profile, with Google's state (LIVE, PROCESSING, REJECTED).

List Locations

List countries, states or cities in the directory. Filter by type and country code (IN, US).

List My Businesses

List every business you own, with status, claim state, completeness score and whether it is indexable.

List My Claims

List the claims you have submitted and their current state.

List My Orders

Orders for the retired one-time services (placed before 2026-10-18), with their status. New work is done with a paid business: see activate_business.

List My Reviews

Reviews you have written about other businesses. For the reviews of a business you own, use list_business_reviews with its slug.

List Notifications

List your LotsBusiness notifications: claim outcomes, questions and order updates.

List Site Versions

Version history with source, message, check summary and which one is live.

List Starter Kits

Industry starter kits (salon, clinic, restaurant, trades, professional, agency) with their default theme and pages.

List Workspaces

List the LotsBusiness workspaces you belong to, with your role, how many businesses each holds and how many are paid. Every account has a personal workspace; agencies create more for their team.

Move Business To Workspace

Move a business between two workspaces you administer that have the same owner. To give a business to a client, use start_business_handover.

Pay For Business Service

Get a payment link for an order of the retired one-time services that was agreed but not paid yet. Do not use for new purchases: plans and credits are bought with create_checkout, and a business is made paid with activate_business.

Post Business Update

Post a short update or announcement on a business you own.

Preview Google Business Profile

Build an immutable, evidence-labelled preview without writing to Google. Only owner listing facts and explicit owner confirmations are accepted. Online-only businesses are rejected. Show the exact preview before asking for confirmation. Listing lat/lng of 0 is not a map pin. If Google cannot geocode a physical address, the preview returns pin_drop_required; parse an owner Maps URL or confirmed pin into latitude and longitude and retry with duplicate_acknowledged=true. If public duplicate search is unavailable, check Google Maps and retry with duplicate_acknowledged=true. Create only with the returned preview_id and confirmation_token within 30 minutes.

Preview Site

Get a fresh private preview link for a version (latest by default), valid for 7 days and never indexed. Share it with the owner before publishing.

Publish Site

Make a version live (latest by default) on the site's address and connected domains, within a minute. Refused if the version has check errors. Ask the owner first.

Recommend Business

Toggle your recommendation on a business. Calling it again removes the recommendation.

Record Directory Submission

Track progress on one directory: not_started, in_progress, needs_action, submitted, live (with listing_url), rejected or skipped, with notes.

Remove Contact Recipient

Stop sending website messages to an address.

Remove Site Domain

Disconnect a domain from the site.

Reorder Business Media

Set the display order of the business's media by listing their ids in order.

Reply To A Review

Reply publicly to a review left on a business you own. One reply per review; calling again updates it.

Restore Business

Restore an archived business within 30 days of archiving it. Owner only. It comes back as a free listing with its earlier directory status; make it paid again (activate_business) for its website and paid tools. list_my_businesses with archived: true lists archived businesses and how long each can be restored.

Restore Workspace

Restore an archived workspace within 30 days of archiving it. Owner only. list_workspaces with archived: true lists archived workspaces and how long each can be restored.

Revoke Approval Link

Withdraw an approval link.

Rollback Site

Make an earlier version live again.

Search Businesses

Search businesses, categories and cities by keyword. Use for autocomplete or when the exact slug is unknown.

Search Google Business Categories

Search Google's live category catalog. Never invent a category ID; show the returned exact categories and ask the owner when more than one is plausible.

Seed An Unclaimed Listing (staff)

Staff only. Create an unclaimed listing from a business's own website.

Set Business FAQs

Replace the FAQ list on a business you own. Pass the complete list: it overwrites what is there.

Set Business Hours

Set weekly opening hours, special hours (holidays, closures, one-off times) and the timezone. The website, schema and llms.txt update within a minute, with no new site version. hours: {"mon":[{"open":"09:00","close":"17:30"}], ...}; a missing day is closed. special_hours: [{"date_from":"2026-12-25","date_to":"2026-12-25","closed":true}].

Set Business Links

Set social profile links (facebook, instagram, x, linkedin, youtube, tiktok, pinterest, threads, bluesky, whatsapp, yelp, tripadvisor, google), the booking link and the website URL. Empty values clear a link.

Set Business Services

Replace the business's list of services, in display order, with optional prices (price, optional price_max for a range, currency, price_note like 'from') and durations. Only real services and prices the owner confirmed.

Set Primary Site Domain

Choose which active domain is the main address (the others redirect to it). hostname null returns to the LotsBusiness address.

Set Up Business Email

Set up business email (LotsMail) on the business's own domain, included with a paid business. Needs the website's own domain connected first. Returns the TXT record that proves ownership; mailboxes are then created in LotsMail.

Start Business Handover

Start handing a business (record, website, domains) over to the client's own LotsBusiness account. Returns a link for the client. The client signs in with that email, picks a workspace that pays for the business, and accepts. keep_agency_access (default true) keeps your agency as manager if the client agrees.

Start Google Business Verification

Start one of the verification methods returned by Google. Do not choose a delivery destination or method that Google did not return.

Suggest Site Kit

The starter kit that best fits the business's categories and type.

Track My Order

One order for the retired one-time services (placed before 2026-10-18). New work is done with a paid business: see activate_business.

Unpublish Site

Take the website offline without deleting anything. Owners and admins only; ask first.

Update Business

Update the business record: name, type, contact details, address (physical only), city, categories, descriptions, logo and cover. Prefer set_business_hours for hours, special hours and timezone, set_business_links for social profiles and the booking link, and set_business_services for services.

Update Business Team Member

Change a non-owner team member role or remove the member. Business ownership is handled only through the ownership/claim flow.

Update Contact Message

Mark a contact message read, archived, spam or new.

Update My Profile

Update your personal LotsBusiness member profile (display name, bio, avatar). Not the business record: use update_business for that.

Update Site Settings

Change the site's settings without touching files: whatsapp_button, call_bar, verification (google, bing, yandex, pinterest, facebook codes), verification_file, analytics (ga4, gtm, meta_pixel, clarity), consent_banner, default_description, share_image, favicon, redirects, announcement, open_badge, map, badge. Also indexable and subdomain. Applies to the live site within a minute.

Update Site Theme

For kit sites: change colours, font, sections and pages, or switch kit. Creates a new draft version.

Update Workspace

Rename a workspace. Owners and admins only.

Update Workspace Member

Change a workspace member's role or remove them. The owner cannot be changed. Owners and admins only.

Upload Site Image

Upload an image for the site from an https image_url or image_base64 (PNG, JPEG, WebP, GIF, AVIF, SVG; up to 5 MB, under 300 KB is best). Returns a blob to include in create_site_version.

Verify A Claim

Check whether the verification token is now present on the business website and complete the claim if it is.

Verify Business Email

Check the ownership TXT record for the business's email domain after the owner adds it.

Write A Review

Write a 1-5 star review of a business. One review per person per business. Every review is checked before it appears publicly, and you cannot review a business you own.

Questions, answered.

What is the LotsBusiness MCP server URL?

https://api.lots.business/mcp. Add it as a remote MCP server (custom connector) in your AI agent and sign in with your Lots account.

Which agents work with LotsBusiness?

Claude, ChatGPT (Business, Enterprise and Edu, from Plugins), Claude Code, Codex, Cursor, Windsurf and any other client that supports remote MCP with OAuth. Agents without MCP use the REST API with an API key.

Where are the LotsBusiness API docs?

https://api.lots.business/docs.md: Markdown written so an AI agent can read it. Requests go to https://api.lots.business/api/v1/lotsbusiness with Authorization: Bearer <your key>.

How do I get a LotsBusiness API key?

Use Generate key on this page or at lotstech.com/api. Sign in with your LotsTech account, name the key and copy it once. You can revoke it there at any time.

Does MCP or API access cost extra?

No. It is included with LotsBusiness. You pay only for LotsBusiness's own plan or usage, and your AI provider bills its own usage.

All MCP servers · All APIs and keys