The fastest path to the right ServiceAgent endpoint.
Use this page as the human-friendly API entry point for installs, widgets, booking, realtime voice, and MCP. For full machine-readable context, pair it with llms.txt and llms-full.txt.
Base URLs
Runtime API base: https://process.serviceagent.ai
Docs base: https://docs.serviceagent.ai
Voice stream: wss://process.serviceagent.ai/v1/voice/stream
What this page covers
Public install, widget, and booking routes.
MCP and voice entry points used by AI tools and realtime apps.
The right docs path when you need SDK-specific or auth-specific details.
Public endpoints
These are the fastest routes to understand if you are embedding widgets, creating booking experiences, or provisioning an install flow without a custom backend first.
| Method | Path | Use it for |
|---|---|---|
| POST | /v1/install/start | Provision a demo widget or starter install flow. |
| GET | /v1/api/widget/:widgetKey/config | Fetch public widget configuration for a widget key. |
| POST | /v1/api/widget/:widgetKey/session | Create a public chat session for widget-driven conversations. |
| GET | /v1/public/book/:bookingKey/slots | Return available booking slots for a public booking key. |
| POST | /v1/public/book/:bookingKey/appointments | Create a public booking appointment. |
Voice and MCP entry points
| Protocol | Path | Use it for |
|---|---|---|
| POST | /v1/mcp | Model Context Protocol server endpoint for Cursor, Claude, and other MCP clients. |
| GET | /.well-known/oauth-authorization-server | OAuth discovery metadata for MCP and secure client setup. |
| WSS | /v1/voice/stream | Realtime voice transport endpoint for low-latency audio sessions. |
Auth and private APIs
For authenticated backend workflows, prefer the typed SDKs instead of stitching private routes together by hand. The SDKs give you stronger defaults, clearer auth handling, and a much better path for AI codegen tools.
- Use @serviceagent/sdk for server-to-server access.
- Use @serviceagent/nextjs when your app is already on Next.js and needs frontend plus server helpers.
- Use @serviceagent/mcp when Cursor, Claude, or ChatGPT should drive setup and operations.
Recommended integration path
Start with Quickstart if you want the shortest working path.
Move to Packages when you need the right SDK or UI layer for your stack.
Use Prompt Builder when you want Cursor or Claude to generate integration code with the right endpoints and implementation steps.