Developer Portal — Free & Keyless

Build on the Local Service API

The developer API for real local service data

One MCP endpoint returns real businesses on Lokuli with their actual services, prices and durations, open times from each shop's live calendar, and local price ranges built from Lokuli's own call-arounds. It can hold a real slot, confirmed by text. About 900 service types. Prices from local pros anywhere in the US; businesses you can book on Lokuli are mostly in California. The data is real and live. No API key. No cost.

~900
Service Types
MCP
Streamable HTTP
$0
API Cost
0
Keys Required
Quick Start Full Documentation List Your Service
Quick Start

Connect in 30 Seconds

Point any MCP client that supports remote servers to the endpoint below. Your client discovers every tool and its input schema. No registration. No API key. Claude, ChatGPT, Gemini and Grok users can add it as a custom connector: setup steps.

MCP Server Configuration// Add this to your MCP client config (remote server, Streamable HTTP, no authentication) { "mcpServers": { "lokuli": { "httpUrl": "https://lokuli.com/mcp" } } }
⚡

No API Key

MCP access is open. Connect and start querying immediately. No sign-in, no OAuth, no registration.

📦

JSON-RPC and JSON

Requests are JSON-RPC 2.0 messages. Every tool returns a text summary and structured JSON with typed fields.

📲

Confirmed by Text

book_appointment and request_quotes only text the person a link. Nothing is booked, and no business is called, until they tap it.

Available API Tools

The Local Service API exposes these six tools through MCP. Agents discover them automatically on connection.

Tool Referencefind_businesses // Real businesses on Lokuli near a US ZIP code or city, with services and prices params: service, zip or city, limit? get_business // Services, prices, team, hours, address, Lokuli reviews params: business get_available_times // Open times from the live Lokuli calendar params: business, service_id, date?, days?, staff_id? book_appointment // Hold a time for 15 minutes; the person confirms by text params: business, service_id, start, name, phone, email?, staff_id?, notes? request_quotes // Lokuli phones pros and texts the person their prices (any US ZIP code) params: service, zip, date, time, phone, name?, details?, business? check_coverage // Any US ZIP code: place, state and time zone params: zip

Find a House Cleaner Near San Diego

The same read-only call in four formats. Each one asks for house cleaning in San Diego. The data shown under each example is real: it is what the live server returned on Oct 31, 2026. Run these from a server or script: browser calls are limited to allowed origins.

Pythonimport requests # Find house cleaning near San Diego (read-only) response = requests.post( "https://lokuli.com/mcp", headers={"Accept": "application/json, text/event-stream"}, json={ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "find_businesses", "arguments": {"service": "house cleaning", "city": "San Diego"}, }, }, ) result = response.json()["result"] for shop in result["structuredContent"]["shops"]: print(shop["name"], shop["city"]) for s in shop["services"]: print(" ", s["name"], s["price"], s["durationMinutes"], s["id"]) # Real data, fetched Oct 31, 2026: # Coastal Maid San Diego Cleaning Services La Jolla # Move-out cleaning, $220, 180 min, id 9XNkTdpiKIdxhBWFF4J5 # Office cleaning, $180, 150 min, id BEAA4nO2Iv7EQcisWdfr # Standard cleaning, $140, 60 min, id eE9ZIxwzVktPArKkcheK # Standard cleaning, $150, 120 min, id gsvLUYFHUQVOm0j4tpeB
JavaScript / Node.js// Find house cleaning near San Diego (read-only) const response = await fetch("https://lokuli.com/mcp", { method: "POST", headers: { "Content-Type": "application/json", "Accept": "application/json, text/event-stream" }, body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "find_businesses", arguments: { service: "house cleaning", city: "San Diego" } } }) }); const { result } = await response.json(); result.structuredContent.shops.forEach(shop => { console.log(shop.name, shop.city); shop.services.forEach(s => console.log(" ", s.name, s.price, s.durationMinutes, s.id)); }); // Real data, fetched Oct 31, 2026: // Coastal Maid San Diego Cleaning Services La Jolla // Move-out cleaning, $220, 180 min, id 9XNkTdpiKIdxhBWFF4J5 // Office cleaning, $180, 150 min, id BEAA4nO2Iv7EQcisWdfr // Standard cleaning, $140, 60 min, id eE9ZIxwzVktPArKkcheK // Standard cleaning, $150, 120 min, id gsvLUYFHUQVOm0j4tpeB
cURL# Find house cleaning near San Diego (read-only) curl -X POST "https://lokuli.com/mcp" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_businesses","arguments":{"service":"house cleaning","city":"San Diego"}}}' # The text of the real result, fetched Oct 31, 2026 (result.content[0].text, shortened): # On Lokuli and bookable (1). Services marked * matched: # 1. Coastal Maid San Diego Cleaning Services, La Jolla (business: coastal-maid-san-diego-cleaning-services; ...). # Move-out cleaning $220 (180 min); Office cleaning $180 (150 min); # *Standard cleaning $140 (60 min); *Standard cleaning $150 (120 min)
MCP JSON (Tool Call)// Request: POST https://lokuli.com/mcp { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "find_businesses", "arguments": { "service": "house cleaning", "city": "San Diego" } } } // Real response, fetched Oct 31, 2026 (shortened): { "jsonrpc": "2.0", "id": 1, "result": { "content": [{ "type": "text", "text": "On Lokuli and bookable (1). Services marked * matched: ..." }], "structuredContent": { "shops": [{ "name": "Coastal Maid San Diego Cleaning Services", "slug": "coastal-maid-san-diego-cleaning-services", "city": "La Jolla", "zip": "92037", "bookable": true, "matched": "synonym", "services": [ { "id": "9XNkTdpiKIdxhBWFF4J5", "name": "Move-out cleaning", "price": 220, "durationMinutes": 180 }, { "id": "BEAA4nO2Iv7EQcisWdfr", "name": "Office cleaning", "price": 180, "durationMinutes": 150 }, { "id": "eE9ZIxwzVktPArKkcheK", "name": "Standard cleaning", "price": 140, "durationMinutes": 60 }, { "id": "gsvLUYFHUQVOm0j4tpeB", "name": "Standard cleaning", "price": 150, "durationMinutes": 120 } ] }], "listings": [], "understood": { "words": ["house", "clean"], "services": ["house-cleaning"], "trades": ["Cleaning"], "known": true } }, "isError": false } }

Businesses you can book on Lokuli are mostly in California, with a few in other states; what you get is real and live. A search can return businesses you can book, public-record businesses (marked not bookable) with local price ranges, or nothing yet. When nothing is bookable, request_quotes works anywhere in the US: Lokuli phones pros near any US ZIP code and texts the person their prices.

Open times and local price ranges: more real results

Real results, fetched Oct 31, 2026// get_available_times (read-only) get_available_times({ "business": "coastal-maid-san-diego-cleaning-services", "service_id": "gsvLUYFHUQVOm0j4tpeB", "date": "2026-11-02", "days": 3 }) // Real result, fetched Oct 31, 2026 (open times change): // Standard cleaning, $150 (120 min). Times are America/Los_Angeles. // 2026-11-02: 8:00 AM, 8:30 AM, 9:00 AM ... 4:00 PM (every 30 minutes) // Each slot: { "start": "2026-11-02T16:00:00.000Z", "label": "8:00 AM" } // find_businesses (read-only) find_businesses({ "service": "barber", "zip": "90640" }) // Real result, fetched Oct 31, 2026: // Not on Lokuli yet, from public business records (not bookable): // six barbershops in Montebello, each with "Local Barbershop quotes: $20–$40" // priceRange: { "low": 20, "high": 40, "quotes": 3, "month": "Oct 2026", // "note": "What local shops quoted Lokuli customers for this trade nearby; // not this business's own price" }

Local price ranges are built from quotes Lokuli collected in its own call-arounds. They appear only when there are 3 or more quotes for the same job in the same city, and they are what local shops quoted, not any one business's own price.

Ideas

4 Ideas You Could Build on This API

These are ideas, not shipped products. Each follows the same pattern: your app reads real data and holds a time or asks for prices, and the person confirms by text. Businesses you can book on Lokuli are mostly in California, so plan for searches that return no bookable business; request_quotes works anywhere in the US.

🤖

1. AI Personal Assistant

Build an assistant that finds a business, reads its prices and open times, and holds a time. The person confirms by text. Works with any MCP-compatible model; the agent discovers the tools automatically.

📞

2. Voice or Chat Concierge

Use the same flow behind a voice or chat interface. It collects the person's name and US mobile number, holds a time with book_appointment, and tells them a text is coming.

🏢

3. Maintenance or Property Helper

A tenant or fleet app can look up a business and its open times, then hold a time for the person to confirm, or ask Lokuli for prices with request_quotes. The person always confirms; quotes work for any US ZIP code, and businesses you can book are mostly in California.

💵

4. Price Comparison Helper

Combine find_businesses (prices set by businesses on Lokuli, and local price ranges for public-record businesses) with request_quotes for exact prices at the person's day and time.

What the Tools Return

Every tool returns a text summary in result.content and structured JSON in result.structuredContent. The fields below come from real responses (and, for holds, from the server's documented behavior). Optional fields appear only when there is data.

Shop (find_businesses → shops[])

Businesses on Lokuli that can be booked. Returned by find_businesses.

FieldTypeDescription
namestringBusiness name as set on its Lokuli page.
slugstringPass as business to the other tools.
urlstringThe business's lokuli.com/shop/... page.
trade, city, zipstringKind of business and location.
bookablebooleantrue for businesses on Lokuli.
matchedstringHow it matched the search: name, service, synonym or trade.
matchedServiceIdsstring[]Ids of the services that matched.
addressstringStreet address.
servicesarrayEach service: id, name, price (USD) and durationMinutes.
ratingobjectaverage, count and source, only when the business has Lokuli reviews.

Listing (find_businesses → listings[])

Businesses built from public records. They are not on Lokuli and cannot be booked here.

FieldTypeDescription
name, slug, urlstringAs for shops.
trade, city, zipstringKind of business and location.
addressstringStreet address, when known.
matchedstringHow it matched the search, for example name.
bookablebooleanAlways false.
priceRangeobjectlow, high, quotes, month, note. Present only when Lokuli has 3 or more quotes for the same job in the same city.
notestringSays it is not on Lokuli yet and points to request_quotes.

Business details (get_business)

For a business on Lokuli (kind: "shop"). For a public-record business, kind is "listing" and the result has its category, location, status and priceRange instead.

FieldTypeDescription
kind, name, slug, urlstringIdentity of the business. urlEs is its Spanish page.
bookablebooleanWhether it can be booked through book_appointment.
bookingobjectvia, instantBook, payment and confirmation: how booking works there.
address, phone, citystringIncluded when the business has them.
timezonestringIANA time zone of the business.
hoursobjectHours by day, for example "monday": "8:00 AM–6:00 PM" or "Closed".
servicesarrayid, name, price, durationMinutes, and a short description when the business wrote one.
teamarrayBookable team members (id, name), when there are any. Pass an id as staff_id.
ratingobjectLokuli reviews summary, when there are reviews.

Open times (get_available_times)

Open slots from the business's live Lokuli calendar.

FieldTypeDescription
businessstringThe business slug.
serviceobjectid, name, price, durationMinutes.
timezonestringIANA time zone of the business.
daysarrayFor each date: date (YYYY-MM-DD) and slots. Days with no openings say why.
days[].slots[].startstringISO time. Pass it unchanged to book_appointment.
days[].slots[].labelstringThe time as shown in the business's time zone, for example "8:00 AM".
bookingobjectHow booking works at this business.

Hold (book_appointment)

Returned when a time is held. Not run in the examples on this page, because it texts a real person.

FieldTypeDescription
ok, statusboolean, stringtrue and "held".
holdExpiresAtstringISO time when the hold is released if the person has not tapped Confirm (15 minutes).
business, url, servicestring, objectWhich business and service.
start, when, timezonestringThe held time.
instantBookbooleanWhether the business confirms at once after the person taps Confirm.
staffstringName of the team member, when one was picked.
no hold: ok false, urlboolean, stringA business that takes a card when booking cannot be held. The result has ok: false, an error message and that business's booking page as url; isError is not set.

Coverage (check_coverage)

Real results, fetched Oct 31, 2026: ZIP 75024 returned {"ok": true, "zip": "75024", "city": "Plano", "state": "TX", "tz": "America/Chicago"} and the text “Yes, Lokuli covers 75024 (Plano, TX). Calls to pros go out Monday–Saturday, 11am–6pm local time.”; ZIP 00000 returned {"ok": false, "zip": "00000", "reason": ...} with the reason “00000 isn't a US zip code Lokuli can find. Check the 5 digits.”

FieldTypeDescription
okbooleanWhether Lokuli can call pros near the ZIP code (any US ZIP code).
zip, city, statestringThe ZIP code, and the city and state it is in.
tzstringIANA time zone of the ZIP code, for example America/Chicago. Calls go out in this time zone.
reasonstringWhy not, when ok is false.
Cost & Limits

Free. No Key. Limits on Texts.

Using the API costs nothing and needs no key. MCP calls have no per-IP limit. What is limited is what Lokuli texts and who may call from a browser. The full list is in auth.md.

LimitValue
Confirmation texts3 per phone number per day for price requests, and 3 for bookings
Bookings waiting for confirmationOne per phone number, and at most 3 per business
Lokuli's texts overallA daily cap
Phone numbersA 10-digit US mobile number that can receive texts; toll-free numbers are refused
AreaQuotes: any US ZIP code (the 50 states and DC). Booking: businesses on Lokuli, most of them in California
Calls to businessesMonday to Saturday, 11am to 6pm in the ZIP code's local time; a request made outside those hours waits for the next opening
Browser (CORS) callsclaude.ai, claude.com, anthropic.com, chatgpt.com, openai.com, gemini.google.com, grok.com, x.ai and lokuli.com. Server-to-server calls without an Origin header are accepted.
Plain HTTP API and /ask chat10 requests per day per IP address (MCP calls have no per-IP limit)

What Happens After book_appointment

There are no webhooks. A hold moves forward by text to the person, not by callback to your app.

StepWhat happensWho is told
book_appointmentThe time is held for 15 minutes and Lokuli texts the person a link.The person. The business is not told.
Person taps ConfirmThe hold becomes a request, or is confirmed at once at instant-book businesses.The business
Business accepts or declinesThe same link shows the answer.The person
15 minutes pass without a tapThe hold is released and the business never hears about it.No one
Clients & Libraries

Integration Methods

Lokuli has no SDK of its own. Use any MCP client library, or send JSON-RPC 2.0 messages with any HTTP client.

MCP Native Available

Connect any MCP client that supports remote servers. It discovers the tools and their input schemas. Claude, ChatGPT, Gemini and Grok can add the URL as a custom connector.

// MCP config: add to your client { "mcpServers": { "lokuli": { "httpUrl": "https://lokuli.com/mcp" } } }

Plain HTTP (JSON-RPC) Available

POST JSON-RPC 2.0 messages to the same endpoint from any language. Responses are plain JSON (not streamed). The endpoint is for POST requests.

# tools/list returns the six tools and their schemas curl -X POST https://lokuli.com/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

HTTP API for Prices Available

A small HTTP API covers price requests and ZIP coverage. It is described by an OpenAPI file. Booking is on the MCP server only.

# Coverage check (read-only) GET https://lokuli.com/ask/coverage?zip=90640 # Price request (texts the person a link) POST https://lokuli.com/ask/start

SDKs and Webhooks None

There is no npm or Python SDK and there are no webhooks today. Poll the read-only tools when you need fresh data.

Errors & Responses

Two kinds of problem. A problem with a tool's arguments comes back as a normal JSON-RPC result with isError: true and a message you can read. A protocol problem comes back as an HTTP error or a JSON-RPC error. The examples below are real responses from the live server, fetched Oct 31, 2026.

WhereCodeWhen It Happens
Tool resultisError: trueAn argument is missing or wrong (for example an unknown business slug or service id, or a time that is no longer open), or a limit was reached. Read the message and fix the call. The HTTP status is 200.
HTTP 400-32700The body is not a JSON-RPC 2.0 message.
HTTP 403-32600A browser request came from an origin that is not allowed. Server-to-server calls are not affected.
JSON-RPC-32601An unknown method, or an unknown tool name (-32602).
HTTP 500-32603Internal error. Retry the request.

Tool error: unknown business (real response)

get_business with a slug that does not exist{ "jsonrpc": "2.0", "id": 61, "result": { "content": [{ "type": "text", "text": "No business found for that. Use a slug or lokuli.com/shop/... link from find_businesses." }], "structuredContent": { "ok": false, "error": "No business found for that. Use a slug or lokuli.com/shop/... link from find_businesses." }, "isError": true } }

Protocol errors (real responses)

POST with a body that is not JSON-RPC → 400{"jsonrpc":"2.0","id":null,"error":{"code":-32700,"message":"Expected a JSON-RPC 2.0 message"}}
POST from a browser origin that is not allowed → 403{"jsonrpc":"2.0","id":null,"error":{"code":-32600,"message":"Origin not allowed"}}
Unknown method → JSON-RPC error{"jsonrpc":"2.0","id":1,"error":{"code":-32601,"message":"Method not found: nope/nope"}}
Input Formats

How to Write the Arguments

The tools are strict about a few formats. They are the same in every tool.

zip

String of 5 digits, for example "90640". Any US ZIP code works for check_coverage and request_quotes; find_businesses also takes a city.

date

YYYY-MM-DD. For get_available_times, today up to 90 days ahead. For request_quotes, today through 60 days ahead.

time (request_quotes)

"10:00 AM" or "14:30", in the person's local time.

phone

A 10-digit US mobile number that can receive texts. Toll-free numbers are refused.

start (book_appointment)

The slot's start exactly as get_available_times returned it, for example "2026-11-02T16:00:00.000Z" (real value, fetched Oct 31, 2026).

business, service_id

business is a slug from find_businesses or a lokuli.com/shop/... link. service_id comes from get_business.

What You Can Look Up Through the API

From emergency plumbing to wedding photography. find_businesses searches the businesses on Lokuli for any of them, and request_quotes has Lokuli phone local pros for the rest. Browse every service type at lokuli.com/services.

Plumbing Electrical HVAC Auto Repair Mobile Detailing House Cleaning Beauty & Wellness Personal Training Tutoring Pet Grooming Photography DJ Services Legal Services Tax Preparation Moving & Hauling Landscaping Pool Maintenance Pest Control Roofing Painting and many more
Developer FAQ

Frequently Asked Questions

What is the Local Service API?

The Local Service API is the developer-facing interface to Lokuli: an MCP server at lokuli.com/mcp with six tools, plus a small HTTP API for price requests and ZIP coverage. It returns real businesses on Lokuli with their actual services, prices and durations, open times from each shop's live calendar, and local price ranges built from Lokuli's own call-arounds. It can hold a slot that the person confirms by text. It works for any US ZIP code for price requests; businesses you can book on Lokuli are mostly in California.

Which businesses can I actually book?

Businesses you can book on Lokuli are mostly in California, with a few in other states, and the list changes. The data is real and live. For example, on Oct 31, 2026 a search for house cleaning near San Diego returned one bookable business with its actual services, prices and open times. A search for barbers near Montebello (90640) returned public-record barbershops, not bookable, with a local price range of $20–$40 built from 3 quotes. A search for a plumber near San Jose (95112) returned no business on Lokuli yet. Where nothing is bookable, request_quotes works anywhere in the US: Lokuli phones pros near any US ZIP code and texts the person their prices.

Do I need an API key?

No. MCP access is open: no API key, no registration, no OAuth. Connect an MCP client to https://lokuli.com/mcp, or POST JSON-RPC 2.0 messages to it. Don't send passwords, tokens or other secrets to the endpoint.

What programming languages can I use?

Any. MCP is protocol-level, so any MCP client library works, and any HTTP client can POST JSON-RPC 2.0 messages. The code examples below use Python, JavaScript (Node.js), cURL and raw MCP JSON. Responses are JSON.

Where do local price ranges come from?

From Lokuli's own call-arounds. Local price ranges are built from quotes Lokuli collected in its own call-arounds. They appear only when there are 3 or more quotes for the same job in the same city, and they are what local shops quoted, not any one business's own price. They appear as a priceRange on the public-record businesses that find_businesses and get_business return, marked not bookable.

What does a result look like?

Every tool returns a text summary and structured JSON (structuredContent). find_businesses returns shops (businesses on Lokuli, with services that carry an id, price and durationMinutes) and listings (public-record businesses, with a priceRange when there are enough quotes). See the result reference and the real example on this page.

What errors does the API return?

Problems with a tool's arguments come back as a normal result with isError set to true and an error message (for example, an unknown business or service id). Protocol problems come back as JSON-RPC errors: 400 for a message that is not JSON-RPC 2.0, 403 for a browser origin that is not allowed, -32601 for an unknown method and -32602 for an unknown tool name. The endpoint is for POST requests; opening the address in a browser shows a short information page.

How do booking and payments work?

book_appointment holds a time for 15 minutes and texts the person a link. It is booked only when they tap Confirm; then the business accepts or declines the request (instant-book businesses confirm at once). Payment is at the business. A business that takes a card when booking returns a link to its own booking page instead of a hold. The API does not process payments.

Are there webhooks or SDKs?

No. Lokuli has no webhooks and no SDK today. Use any MCP client library, or plain HTTP, and read the tools again when you need fresh data. The hold and confirmation steps happen by text to the person, not by callback.

Can I build a product on the API?

There is no API fee and no key. Read Lokuli's terms (lokuli.com/terms) and the limits in auth.md first: the tools that text a person are limited per phone number, and browser-based calls are limited to a list of allowed origins.

Where is the API available?

Quotes: any US ZIP code (the 50 states and DC), with calls Monday to Saturday, 11am to 6pm in the ZIP code's local time. Booking: businesses on Lokuli, most of them in California and a few in other states. Check a ZIP code with check_coverage (or GET https://lokuli.com/ask/coverage?zip=90640), which returns the place, state and time zone. On Oct 31, 2026, check_coverage for 75024 returned: “Yes, Lokuli covers 75024 (Plano, TX). Calls to pros go out Monday–Saturday, 11am–6pm local time.” For 00000 it returned: “00000 isn't a US zip code Lokuli can find. Check the 5 digits.”

Is there a test environment?

For price requests, start the service name with the word "test" (for example "test house cleaning"). The text and link still go to the number given, but no business is called. Use only your own number. The search and availability tools read live data.

What is the difference between LocalServiceAPI.com and Lokuli?

Lokuli is the platform where businesses keep their services, prices and calendars. LocalServiceAPI.com is developer documentation for the endpoints that read them: the MCP server at lokuli.com/mcp and the small HTTP API. BookingClaw is Lokuli's AI-native directory of local services.

Can AI agents use this API on their own?

Agents can do the reading and the holding on their own, but not the deciding. book_appointment and request_quotes only text the person a link. Nothing is booked, and no business is called, until the person taps it.

Part of the Lokuli Network

The Local Service API is one part of the Lokuli ecosystem for local services. Explore the other platforms and entry points.

Start Building on the Local Service API

Real businesses, prices and open times. About 900 service types. MCP over Streamable HTTP. $0 cost. No API key. The person confirms by text. Businesses you can book on Lokuli are mostly in California, and the data is real.

Get Started Full Documentation List Your Service