Skip to content
Developer platform

Build with Klipo.

A tiny, honest REST API for short links and rescue analytics — plus an MCP server so AI assistants can create and manage links for you. One Bearer key, scoped permissions, and the same webview-rescue data the dashboard shows.

Bearer-key authOpenAPI 3.1MCP · stdioself-hostable
requestPOST
POST /api/v1/shorten
Authorization: Bearer klipo_sk_••••
{ "url": "https://your-shop.com/sale" }
response201
201 Created
{ "shortUrl": "https://api.klipo.eu/sale" }
one POST · one short link
Quick start

From zero to a short link in one request.

  1. Create a key

    Generate a scoped API key from your dashboard. It’s shown once — store it like a password.

  2. Send the request

    Call POST /api/v1/shorten with your key as a Bearer token and a JSON body.

  3. Ship the link

    Get the short URL back instantly — with webview-rescue analytics on every click.

shorten a link
curl -X POST https://klipo.eu/api/v1/shorten \
  -H 'Authorization: Bearer klipo_sk_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://your-shop.com/spring-sale"}'
response
201 Created
{
  "shortUrl": "https://api.klipo.eu/spring-drop",
  "code": "spring-drop",
  "analytics": true
}
Authentication & capabilities

One Bearer key. Clear scopes.

authentication
Authorization: Bearer klipo_sk_••••
links:readlinks:write
  • SHA-256 hashed at rest
  • shown once at creation
  • scoped per key
  • revocable anytime

Shorten

Create links with custom aliases, expiry, and private visibility.

links:write

Manage

List, update, delete, and claim the links your account owns.

links:write

Rescue analytics

Clicks, referrers, geography, and the webview-vs-native split.

links:read

API keys

Create, scope, and revoke keys from the authenticated dashboard.

session
Model Context Protocol

Let AI assistants work your links.

The Klipo MCP server speaks the Model Context Protocol over stdio and calls the same REST API with your key. Every tool call inherits your key’s scopes, ownership, and quotas — and no administrative actions are ever exposed.

Your client launches the server locally; it opens no network port of its own.

shorten_urllist_linksget_link_statsupdate_linkdelete_link ·
claude_desktop_config.json
{
  "mcpServers": {
    "klipo": {
      "command": "node",
      "args": [".../app/dist/mcp/server.js"],
      "env": {
        "KLIPO_API_BASE_URL": "https://klipo.eu",
        "KLIPO_API_KEY": "klipo_sk_YOUR_KEY"
      }
    }
  }
}
Keep going

Everything you need to build.

API reference

The full OpenAPI 3.1 spec — every endpoint, schema, scope, and example, rendered for reading.

Open the reference

MCP integration

Install the stdio server, configure your key, and wire it into Claude Desktop in minutes.

Set up MCP

Ready to build with Klipo?

Create a scoped key, send one request, and watch the rescues roll in.