shorten_link

Shorten a URL into an in.bio short link. Free, no account or token needed. Anonymous links are deleted after 30 days unless claimed via the returned claim_url; claimed/account links also get click analytics.

Parameters1

url

string

required

The long URL to shorten

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The long URL to shorten"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

generate_qr_code

Generate a styled QR code image URL. Free, no token needed. Encodes a URL, text, Wi-Fi credentials, vCard, email, phone, SMS, or WhatsApp payload. Returns a stable image URL (PNG or SVG) that can be embedded or downloaded directly.

Parameters10

type	string	optional	Payload type (default url)
fields	object	required	Payload fields for the type: url→{url}; text→{text}; email→{to,subject?,body?}; phone→{phone}; sms→{phone,body?}; whatsapp→{phone,text?}; wifi→{ssid,password?,encryption?}; vcard→{name,org?,title?,phone?,email?,url?}
dot_style	string	optional	Data-dot style
marker_shape	string	optional	Corner-marker shape
marker_center	string	optional	Corner-marker center
foreground	string	optional	Foreground hex color
marker_color	string	optional	Marker hex color (defaults to foreground)
size	integer	optional	Image size in px (default 512)
transparent	boolean	optional	Transparent background
format	string	optional	Image format (default png)

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "description": "Payload type (default url)",
      "type": "string",
      "enum": [
        "url",
        "text",
        "email",
        "phone",
        "sms",
        "whatsapp",
        "wifi",
        "vcard"
      ]
    },
    "fields": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      },
      "description": "Payload fields for the type: url→{url}; text→{text}; email→{to,subject?,body?}; phone→{phone}; sms→{phone,body?}; whatsapp→{phone,text?}; wifi→{ssid,password?,encryption?}; vcard→{name,org?,title?,phone?,email?,url?}"
    },
    "dot_style": {
      "description": "Data-dot style",
      "type": "string",
      "enum": [
        "square",
        "dots",
        "rounded"
      ]
    },
    "marker_shape": {
      "description": "Corner-marker shape",
      "type": "string",
      "enum": [
        "square",
        "rounded",
        "circle"
      ]
    },
    "marker_center": {
      "description": "Corner-marker center",
      "type": "string",
      "enum": [
        "square",
        "dot"
      ]
    },
    "foreground": {
      "description": "Foreground hex color",
      "type": "string",
      "pattern": "^#?[0-9a-fA-F]{6}$"
    },
    "marker_color": {
      "description": "Marker hex color (defaults to foreground)",
      "type": "string",
      "pattern": "^#?[0-9a-fA-F]{6}$"
    },
    "size": {
      "description": "Image size in px (default 512)",
      "type": "integer",
      "minimum": 64,
      "maximum": 2048
    },
    "transparent": {
      "description": "Transparent background",
      "type": "boolean"
    },
    "format": {
      "description": "Image format (default png)",
      "type": "string",
      "enum": [
        "png",
        "svg"
      ]
    }
  },
  "required": [
    "fields"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_link

Create a short link on the authenticated INBIO account, with full options (custom slug, title, tags, folder, UTM parameters, expiration, password, click limit). Requires the links:write token scope.

Parameters12

destination_url	string	required
slug	string	optional	Custom slug (random if omitted)
title	string	optional
description	string	optional
redirect_type	any	optional
folder_id	integer	optional
tags	array	optional
expires_at	string	optional	ISO 8601 datetime (Pro+)
fallback_url	string	optional	Shown after expiry (Pro+)
click_limit	integer	optional	Pro+
password	string	optional	Password-protect the link (Pro+)
utm	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "destination_url": {
      "type": "string",
      "format": "uri"
    },
    "slug": {
      "description": "Custom slug (random if omitted)",
      "type": "string",
      "minLength": 4,
      "maxLength": 64,
      "pattern": "^[a-zA-Z0-9-_]+$"
    },
    "title": {
      "type": "string",
      "maxLength": 255
    },
    "description": {
      "type": "string",
      "maxLength": 1000
    },
    "redirect_type": {
      "anyOf": [
        {
          "type": "number",
          "const": 301
        },
        {
          "type": "number",
          "const": 302
        },
        {
          "type": "number",
          "const": 307
        }
      ]
    },
    "folder_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "expires_at": {
      "description": "ISO 8601 datetime (Pro+)",
      "type": "string"
    },
    "fallback_url": {
      "description": "Shown after expiry (Pro+)",
      "type": "string",
      "format": "uri"
    },
    "click_limit": {
      "description": "Pro+",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "password": {
      "description": "Password-protect the link (Pro+)",
      "type": "string"
    },
    "utm": {
      "type": "object",
      "properties": {
        "source": {
          "type": "string"
        },
        "medium": {
          "type": "string"
        },
        "campaign": {
          "type": "string"
        },
        "term": {
          "type": "string"
        },
        "content": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "destination_url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_links

List the account's short links with optional filters. Requires links:read scope.

Parameters6

search	string	optional	Matches slug, title, destination URL
status	string	optional
tag	string	optional
folder_id	integer	optional
page	integer	optional
per_page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Matches slug, title, destination URL",
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "disabled",
        "archived",
        "expired",
        "exhausted",
        "blocked",
        "pending_review"
      ]
    },
    "tag": {
      "type": "string"
    },
    "folder_id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_link

Fetch one short link by id. Requires links:read scope.

Parameters1

id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

update_link

Update a short link (any subset of create_link fields, plus slug). Editing destination_url requires the Pro+ edit-destination feature. Requires links:write scope.

Parameters2

id	integer	required
fields	object	required	Fields to update, same names as create_link

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "fields": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Fields to update, same names as create_link"
    }
  },
  "required": [
    "id",
    "fields"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

delete_link

Delete a short link (it stops redirecting). Requires links:write scope.

Parameters1

id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_link_enabled

Enable or disable a short link. Requires links:write scope.

Parameters2

id	integer	required
enabled	boolean	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "enabled": {
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "enabled"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_link_analytics

Click analytics for a link: totals, daily series, top countries, devices, browsers, referrers. Bot traffic is excluded. Requires analytics:read scope.

Parameters3

id	integer	required
from	string	optional	YYYY-MM-DD (default: 30 days before to)
to	string	optional	YYYY-MM-DD (default: today)

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "from": {
      "description": "YYYY-MM-DD (default: 30 days before to)",
      "type": "string"
    },
    "to": {
      "description": "YYYY-MM-DD (default: today)",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_folders

List the account's link folders. Requires links:read scope.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_tags

List the account's link tags. Requires links:read scope.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_account_usage

Current plan, period usage (links created, clicks, API requests), and plan limits for the authenticated account.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

io.github.www-in-bio/inbio

in.bio MCP Server (io.github.www-in-bio/inbio)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

shorten_link

generate_qr_code

create_link

list_links

get_link

update_link

delete_link

set_link_enabled

get_link_analytics

list_folders

list_tags

get_account_usage

inbio-mcp — official INBIO MCP server

Tools

Running your own copy

License

Install

Remote endpoint