# Gajo URL Shortener

> Shorten URLs, manage gajo.io short links, and read click analytics. Free account, no credit card.

- name: io.gajo/url-shortener
- version: 1.1.0
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 96/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.gajo%2Furl-shortener
- tools: https://api.protogrid.dev/v1/servers/io.gajo%2Furl-shortener/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "url-shortener": {
      "type": "http",
      "url": "https://gajo.io/mcp",
      "headers": {
        "x-api-key": "${X_API_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${X_API_KEY}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-3d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 96/100 (new)

### protocol: 100 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- pass `protocol.list_ttl`: tool list is cacheable (ttlMs 3600000)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 7 of 7 tools declare readOnlyHint or destructiveHint
- warn `tools.directory_hints`: 3 of 7 tools declare all four hints; missing: get_usage (destructiveHint, idempotentHint); list_urls (destructiveHint, idempotentHint); get_url (destructiveHint, idempotentHint); …
- pass `tools.token_cost`: about 825 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 6 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 7, about 825 tokens to load them all
- tool set hash: d3053dd2d7010b55bfe23de1f24094e2
- tools last changed: 2026-10-17T19:19:26.550Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.gajo/url-shortener.svg)](https://protogrid.dev/servers/io.gajo/url-shortener)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-17 `get_usage` changed (outputSchema)
- 2026-10-17 `deactivate_url` changed (outputSchema)
- 2026-10-17 `update_url` changed (outputSchema)
- 2026-10-17 `get_url_stats` changed (outputSchema)
- 2026-10-17 `get_url` changed (outputSchema)
- 2026-10-17 `list_urls` changed (outputSchema)
- 2026-10-17 `shorten_url` changed (outputSchema)
- 2026-10-15 `get_url_stats` changed (description)
  - before: Click analytics for one of your links, bots excluded: total clicks and clicks per day. Basic and Pro also get referrers, devices, countries, and regions.
  - after: Click analytics for one of your links, bots excluded: total clicks and clicks per day (7 days on Free, 90 on Basic, every day since the link was created on Pro). Basic and Pro also get referrers, devices, countries, and regions.

Full history: https://api.protogrid.dev/v1/servers/io.gajo%2Furl-shortener/changes

## Remotes

- https://gajo.io/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (7)

- `deactivate_url`: Turn off one of your short links so it stops redirecting. Generated codes are never reassigned.
- `get_url`: Look up one of your short links: destination, click count, status, and expiry.
- `get_url_stats`: Click analytics for one of your links, bots excluded: total clicks and clicks per day (7 days on Free, 90 on Basic, every day since the link was created on Pro). Basic and Pro also get referrers, devices, countries, and regions.
- `get_usage`: Your plan, links created this month, links remaining, and API rate limit.
- `list_urls`: List your short links, newest first, with click counts. Returns one page; use page to see more.
- `shorten_url`: Create a gajo.io short link for a URL and return it as shortUrl. Links follow your plan's code length and lifetime and count against its monthly quota. Pro plans can pass customCode for a branded gajo.io/c/{code} link, or shorten app deep links (myapp://...) with a web fallbackUrl.
- `update_url`: Pro only: point an existing short link at a new destination URL. Takes effect immediately.