Documentation

Quickstart

Get your first API call working in under a minute.

1. Create a free account (no card required).
2. 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.)
3. 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.

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

1. Open Settings → Apps and turn on Advanced (Developer) Mode.
2. Choose Create App.
3. Name it Snipget and set the URL to https://mcp.snipget.ai/mcp.
4. 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

1. Open Skills & Connectors → Connectors and choose New Connector → Custom.
2. Name it Snipget and set the URL to https://mcp.snipget.ai/mcp.
3. 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.

Cursor

One click adds the Snipget server to Cursor; it will prompt for OAuth sign-in on first use.

Or add it manually to ~/.cursor/mcp.json (the same JSON works in any client that reads an mcpServers config):

{
  "mcpServers": {
    "snipget": {
      "url": "https://mcp.snipget.ai/mcp"
    }
  }
}

VS Code

Add Snipget to VS Code (one click), or from a terminal:

code --add-mcp '{"name":"snipget","type":"http","url":"https://mcp.snipget.ai/mcp"}'

Claude Code

claude mcp add --transport http snipget https://mcp.snipget.ai/mcp

Claude, 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.