Step 1 — Get an API key

Your email App / agent name Get API key

Keys are shown once and stored as a hash. 3 keys per day per IP. Abuse → revoked.

Step 2 — Connect

ChatGPT — Custom GPT Action

1. GPT Builder → Configure → Actions → Import from URL
2. Paste: /openapi-agent.json
3. Authentication → API Key → custom header X-API-Key, value = your key
4. Tell the GPT: ask the consumer for service, vehicle make, ZIP, timing, name, phone, explicit permission to share contact with shops, and TCPA consent for calls/SMS — then call createLead.

Claude — MCP connector

1. Settings → Connectors → add custom remote MCP server
2. URL: /mcp, header X-API-Key: your-key
3. Tools: create_lead (submit), get_lead (status + relay messages), search_providers (ranked shops), list_services. Full list of 26 tools: /.well-known/mcp on the same host.

Gemini / your own agent — REST

Plain-language Q&A: POST /v1/ask on the same host, header X-API-Key, body {"question": "…", "zip": "23059"} — returns Servik's semantic answer (matched problem/service, cost guidance, naming-filtered shops). question max 1000 chars; zip optional but recommended; limit 1–10, default 5. Rate cap: 120/hour per developer key. Keyless MCP access is throttled separately at 300/hour per IP.

Chat sessions are server-issued

• The server ignores any client-supplied session id and returns its own session id in the stream's done event.
• Echo that session id on every follow-up turn. A follow-up without it silently starts a fresh conversation — no error is returned.
• Front-door note: the python-urllib default user agent is blocked (403); browser and requests user agents work.

Embed on your site

Put Servik chat on any https page (same public chat as /chat, keyless):

Framing is allowed for https parents only. The embedded chat hides Servik's top bar via ?embed=1.

The contract (what makes a lead valid)

• Real consumer, specific service, ZIP in a covered metro, timing, vehicle make
• Explicit permission to share contact with matched shops (or chat-relay instead)
• TCPA consent recorded before any call/SMS — ask, don't assume
• Bogus phones/names are rejected automatically and never billed

Consumer site: home · chat agent · form