---
title: "ServiceFront platform skill"
description: "The one platform skill: tool contract for acting on any ServiceFront business, addressed by businessId."
canonical: "https://servicefront.ai/SKILL.md"
---

# ServiceFront platform skill

ServiceFront is the AI front desk for service businesses. One skill, many businesses. Pass businessId (the business's ServiceFront slug) to every business tool; ServiceFront's own tools take none.

## Endpoint
- MCP: https://servicefront.ai/api/mcp
- Transport: Streamable HTTP (POST JSON-RPC). Anonymous, no auth. Rate-limited per IP.

## Tools (live)
- searchBusinesses(query) — find a business's businessId by name.
- getBusinessInfo(businessId) — owner-verified facts: trade, hours, service area, contact, services with confirmed prices. Absent fields aren't confirmed; don't state them.
- getQuote(businessId, service) — the owner-confirmed price for a named service, or grounded:false. Never invent a price.
- requestCallback(businessId, phone, problem, name?, address?, urgency?, language?) — capture a lead; the business calls the customer back. Write the problem in English; language is the customer's, as a BCP 47 code. Emergencies always page the team. A routine request may be held for the owner's dashboard where the business confirms customer numbers, or past the free plan's monthly lead cap; read paged in the reply.
- confirmCallbackCode(businessId, leadId, code): when requestCallback answered status code_sent, the customer got a texted code. Pass it back, and the request goes to the business.

## ServiceFront's own tools (live, no businessId)
For a business owner, or their AI assistant, shopping for a front desk.
- aboutServiceFront(): what ServiceFront is, who it's for, how setup works, what it answers, and what it doesn't do yet.
- getPricing(): the plans and limits, the same content as /pricing.md.
- howToSetUp(): the setup steps, the <slug>.servicefront.ai address, and the website widget snippet. The owner signs up themselves.
- sampleConversation(trade): a sample homeowner conversation in one trade, with a made-up example business. A trade without a sample yet says so and returns a ready trade's sample as a stand-in.
- tryFrontDesk(trade, message, history?): a live demo chat. You play a homeowner, and a front desk for a made-up example business answers, flags urgent jobs and takes a lead. Pass back the last result's history to keep going. Every reply is labeled as a demo; nothing is saved and nobody is paged. Limited per day.

## Planned (not callable yet)
- getAvailability(businessId, window) — open slots, when the business is bookable.
- bookAppointment(businessId, slot, contact, address) — an owner-approvable request, for an address in the confirmed service area.
These two are not registered on the server; this file carries them the day they answer (never advertised before they act).

## Rules
- Answer from verified facts only. Never invent prices, hours, or claims.
- Booking isn't live. Offer requestCallback instead, and never promise a time slot. No payment in this layer.
