Authentication

All API requests require an API key. Get yours from the Account page.

X-API-Key: utg_your_api_key_here

API keys have the prefix utg_. You can also use Bearer token authentication with a JWT from the login endpoint.

Base URL

https://utils.bithub.org/api/v1

Short URLs

POST /api/v1/urls

Create a shortened URL.

Request Body

{
  "url": "https://example.com/very-long-page",
  "custom_code": "my-brand"  // optional, paid tiers only
}

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "code": "2BKxmR",
  "short_url": "https://u.bithub.org/s/2BKxmR",
  "target_url": "https://example.com/very-long-page",
  "created_at": "2026-02-28T12:00:00+00:00"
}

Examples

curl

curl -X POST https://utils.bithub.org/api/v1/urls \
  -H "X-API-Key: utg_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Python

import httpx

resp = httpx.post(
    "https://utils.bithub.org/api/v1/urls",
    headers={"X-API-Key": "utg_your_key"},
    json={"url": "https://example.com"}
)
print(resp.json()["short_url"])

JavaScript

const resp = await fetch("https://utils.bithub.org/api/v1/urls", {
  method: "POST",
  headers: {
    "X-API-Key": "utg_your_key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ url: "https://example.com" })
});
const data = await resp.json();
console.log(data.short_url);

GET /api/v1/urls

List your short URLs with click counts.

GET /api/v1/urls/{id}/stats

Get analytics for a short URL. Detail level depends on your tier:

Free: Total click count
Starter: Click count + device breakdown + top referrers
Pro: Full analytics (daily time series, devices, referrers, countries)

DELETE /api/v1/urls/{id}

Delete a short URL and all its click data.

MCP Integration

UtilsToGo exposes a Model Context Protocol server. Connect any MCP-compatible AI tool.

Claude Desktop / Cursor

Add to your MCP configuration:

{
  "mcpServers": {
    "utilstogo": {
      "url": "https://utils.bithub.org/mcp",
      "transport": "streamable-http"
    }
  }
}

WebMCP (Browser)

AI browser extensions can discover our MCP server automatically via:

GET https://utils.bithub.org/.well-known/mcp.json

Available MCP Tools

create_short_url(url, custom_code?) — Create a shortened URL
get_url_stats(code) — Get click statistics
list_services() — List available utilities

OpenAPI Specification

Auto-generated OpenAPI 3.0 spec available at:

Rate Limits

Tier	URLs / month	Redirects / month	Custom aliases
Free	3	1,000	No
Starter	100	20,000	Yes
Pro	1,000	100,000	Yes

When limits are reached, requests return 429 Too Many Requests.

API Documentation