Documentation
Quickstart
Get your first API call working in under a minute.
- Create a free account (no card required).
- After signing in, your first key is created automatically and shown on your dashboard. Copy the plaintext — it's shown only once. (More keys anytime under Dashboard → API Keys.)
- Make a request.
curl -X POST https://api.snipget.ai/v1/phone/format \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"phone": "800 555-1234", "country": "US"}'Response:
{
"status": "ok",
"confidence": 1.0,
"result": {
"e164": "+18005551234",
"national": "(800) 555-1234",
"country_code": "US",
"valid": true
},
"meta": {
"version": "0.1.0",
"elapsed_ms": 2,
"cost_units": 1,
"request_id": "req_abc123..."
}
}Response envelope
Every endpoint returns the same shape. Successful responses have status: "ok", errors have status: "error". Every response includes a confidence score and meta block.
Authentication
Send your API key via the Authorization: Bearer ... header, or alternatively X-API-Key.
Rate limiting
Limits depend on your tier. 429 responses include exact retry_after_seconds, limit_type, and current_tier so your agent can back off correctly.
Full API reference
Every endpoint is documented in the interactive OpenAPI spec.
Open API Reference ↗MCP integration
Snipget exposes the full utility catalog as an MCP server. Point any MCP-aware client at the server URL and your agent discovers every utility automatically. The server URL is:
https://mcp.snipget.ai/mcp
ChatGPT
- Open Settings → Apps and turn on Advanced (Developer) Mode.
- Choose Create App.
- Name it Snipget and set the URL to
https://mcp.snipget.ai/mcp. - Sign in with your Snipget account and approve access when prompted. ChatGPT registers itself automatically — there's no client ID or secret to copy.
Grok
- Open Skills & Connectors → Connectors and choose New Connector → Custom.
- Name it Snipget and set the URL to
https://mcp.snipget.ai/mcp. - Sign in with your Snipget account when prompted to finish.
For a quick one-off, Grok also accepts the same URL plus an API key as the connector's auth token — a single-session connection that doesn't persist. The sign-in connector above is the better fit for repeated use.
Claude, Cursor, Windsurf, and other MCP clients
Point the client at the same server URL and authenticate with your Snipget account, or supply an API key where the client expects a static token.