Skip to main content
Documentation

Developer & AI platform

Every function in the shop, available to your code and to your AI.

Service VIN publishes one capability registry — a typed description of every operation the product can perform. The REST API, both MCP servers, the Claude connector, the in-app copilot and this reference are all generated from it, so none of them can drift from the software.
capabilities
222
domains
25
endpoints answering
4/5
guides
9

Base URLs

REST
https://www.servicevin.com/api/v1
Shop MCP
https://www.servicevin.com/api/mcp

Zero to an authenticated call

Mint a key in Settings → API keys, put it in your shell, and call /me. A 200 naming your shop means you are connected.

Your first request
export SERVICEVIN_API_KEY=svk_live_…

curl https://www.servicevin.com/api/v1/me \
  -H "Authorization: Bearer $SERVICEVIN_API_KEY"

Then read Getting started, which explains what a capability is before you call one.

The surfaces

Five ways in, one registry behind them, and one audited path through the same four gates — ring, plan, permission, scope — whichever door a call comes through.

/api/v12 endpoints
/api/v1
Live

REST resourcesLeads, customers, vehicles, quotes, invoices, jobs, appointments, messages, services and staff, with cursor pagination and signed webhooks.

/api/v1/<domain>/<verb>
Shipping

Capability endpointsOne POST per capability, taking the capability's own input schema and answering with its output shape.

/api/mcp2 endpoints
/api/mcp
Live

Shop MCP serverStreamable HTTP MCP. Every capability this account may reach, as a tool, filtered by scope, permission, plan and release ring.

/api/mcp/booking
Live

Booking MCP serverAvailability and booking only, on a fixed allowlist, reached with a booking token — the surface an AI voice platform connects to.

/.well-known/oauth-authorization-server1 endpoint
/.well-known/oauth-authorization-server
Live

Claude connector (OAuth 2.1)The same shop server reached through OAuth with dynamic client registration and PKCE, so a shop owner clicks Connect instead of pasting a key.

A shipping endpoint is documented here because its contract is settled and generated from the same registry — build against it, and it answers the day it lands. The status on this page is read from the route file itself, not from a note somebody remembered to update.

Guides

Capability domains

Grouped the way the registry groups them: the customer and their car, the money funnel, the day on the floor, the shop itself, then everything that reaches outward.

For a reader that is not a person

Half the traffic here is an agent, a crawler or an answer engine. Four documents exist for them, and every one is generated from the registry rather than written beside it.