AI apps (MCP)

Tools AI apps can use

View as Markdown Open in Claude Open in ChatGPT

In short

Clikso gives AI apps 20 tools to read, create, change and delete links, folders and tags. You can set each one to Always allow, Needs approval or Blocked. Reading and creating are allowed at first, while changing and deleting need your approval.

How tools work

Your AI app sees a list of tools, each with a name and a short description. When you ask for something, the app picks a tool and fills in the details. Clikso checks your settings, your role and your plan, then runs it.

Read and search tools only look. They never change anything.
Create tools add new links, folders and tags. New links count toward your monthly link limit.
Change and Delete tools edit or remove things that already exist. They need your approval at first.

Every tool can also take a workspace. If the app leaves it out, Clikso uses the connection's default workspace. When you have several, the app is told to ask you which one.

All tools

Each description below is the text your AI app reads, so some of it is written for the app.

Read and search · 10

get_accountGet accountReadsAlways allow
Returns the signed-in Clikso user, the workspaces this connection can use (the user's role, what this connection may do there as acting_as, and the plan), the default workspace, and the current workspace's clicks this month, usage and plan limits.
list_linksList linksReadsAlways allow
Lists short links in a workspace, newest first unless sorted otherwise. Filters by search text (title, slug, destination or description), folder, tags or status. Returns at most 50 links per call; use offset to page.
What the AI can send (8)
- q stringSearch text.
- folder_id stringOnly links in this folder.
- tag_ids array of stringTag ids from list_tags.
- status active | expired | archivedOnly links with this status.
- sort_by created_at | title | status | click_count
- order asc | desc
- limit integerHow many to return (1–50, default 20).
- offset integerHow many to skip, for paging.
get_linkGet linkReadsAlways allow
Returns one short link by its id or by its short URL (for example https://clik.is/summer).
What the AI can send (2)
- id stringThe link id.
- short_url stringThe short URL instead of the id, for example https://clik.is/summer.
check_slugCheck slugReadsAlways allow
Checks whether a slug is free on a domain, so a short link can be created with it.
What the AI can send (2)
- slug stringrequiredThe part after the domain: 3–30 letters, numbers or hyphens. On the Starter plan and up it may also use / to group links, like acme/launch (at most 5 parts, no / at the start or end, no //).
- domain stringA domain from list_domains, for example clik.is or go.example.com. Omit for the default.
list_foldersList foldersReadsAlways allow
Lists the folders in a workspace and how many links each one holds.
list_tagsList tagsReadsAlways allow
Lists the tags in a workspace, with their colours and how many links use each one.
list_domainsList domainsReadsAlways allow
Lists the domains a workspace can use for new short links — its verified custom domains and Clikso's free domains — and which one is the default.
preview_urlPreview a web pageReadsAlways allow
Fetches a public web page's preview: its title, description and image (Open Graph tags). Useful for suggesting a link title.
What the AI can send (1)
- url stringrequiredThe page to preview (an http or https URL).
get_link_statsGet link clicksReadsAlways allow
Returns click statistics for one short link: total clicks, top countries, referrers, devices and browsers, and clicks per day. Covers the workspace plan's data retention window.
- Uses the workspace's analytics quota.
- Listed only while Clikso has the click-stats tools turned on for AI apps.
What the AI can send (4)
- id stringThe link id.
- short_url stringThe short URL instead of the id, for example https://clik.is/summer.
- from stringStart of the period (default: 30 days ago).
- to stringEnd of the period (default: now).
get_workspace_statsGet workspace clicksReadsAlways allow
Returns click statistics across a workspace: total clicks, top links, countries, referrers and devices, and clicks per day. Can be narrowed to domains or slugs.
- Uses the workspace's analytics quota.
- Listed only while Clikso has the click-stats tools turned on for AI apps.
What the AI can send (4)
- from stringStart of the period (default: 30 days ago).
- to stringEnd of the period (default: now).
- domains array of stringOnly links on these domains.
- slugs array of stringOnly these links, each written as domain/slug, for example clik.is/summer or clik.is/acme/launch.

Create · 4

create_linkCreate short linkCreatesAlways allow
Creates a short link to a destination URL. Optionally choose the domain, the slug, a title and description, a folder, tags and an expiry date. Counts toward the workspace's monthly link limit.
What the AI can send (9)
- destination_url stringrequiredWhere the short link sends people (an http or https URL).
- domain stringA domain from list_domains, for example clik.is or go.example.com. Omit for the default.
- slug stringCustom slug: 3–30 letters, numbers or hyphens. On the Starter plan and up it may also use / to group links, like acme/launch. Omit for a random 7-character one.
- title stringTitle, up to 60 characters.
- description stringDescription, up to 250 characters.
- folder_id stringFolder id from list_folders.
- tag_ids array of stringTag ids from list_tags.
- expires_at stringWhen the link stops working, as an ISO 8601 date-time, for example 2026-12-31T23:59:00Z.
- expired_redirect_url stringWhere to send people after the link expires (an http or https URL).
suggest_slugsSuggest slugs with AICreatesAlways allow
Suggests up to three short, readable slugs for a URL using AI. Each call uses one of the workspace's daily AI slug generations; use check_slug to test a single slug instead.
- Uses the daily AI slug quota.
What the AI can send (4)
- url stringrequiredThe destination the slug is for (an http or https URL).
- title stringTitle, up to 60 characters.
- description stringDescription, up to 250 characters.
- exclude array of stringSlugs not to suggest again.
create_folderCreate folderCreatesAlways allow
Creates a folder for organising links.
What the AI can send (1)
- name stringrequiredFolder name, up to 20 characters.
create_tagCreate tagCreatesAlways allow
Creates a tag that can be added to links.
What the AI can send (2)
- name stringrequiredTag name, up to 10 characters.
- color stringHex colour, for example #3b82f6.

Change · 4

update_linkUpdate linkChangesNeeds approval
Changes a short link: destination, domain, slug, title, description, status, folder, tags or expiry. Fields left out stay as they are; null clears a field. tag_ids replaces all tags.
What the AI can send (12)
- id stringThe link id.
- short_url stringThe short URL instead of the id, for example https://clik.is/summer.
- destination_url stringNew destination (an http or https URL).
- domain stringA domain from list_domains, for example clik.is or go.example.com. Omit for the default.
- slug stringThe part after the domain: 3–30 letters, numbers or hyphens. On the Starter plan and up it may also use / to group links, like acme/launch (at most 5 parts, no / at the start or end, no //).
- title string or null
- description string or null
- status active | archivedarchived stops the link working.
- folder_id string or nullFolder id, or null to unfile.
- tag_ids array of stringReplaces all tags. [] removes them.
- expires_at string or nullExpiry, or null for none.
- expired_redirect_url string or null
bulk_update_linksMove or archive linksChangesNeeds approval
Moves up to 100 links to a folder (or out of any folder), or archives or reactivates them.
- Never looser than update_link: if Update link needs approval or is blocked, so is this.
What the AI can send (3)
- ids array of stringrequiredLink ids, 1–100.
- status active | archived
- folder_id string or nullFolder id, or null to unfile.
update_folderRename folderChangesNeeds approval
Renames a folder. The links in it are not changed.
What the AI can send (2)
- id stringrequiredFolder id.
- name stringrequiredFolder name, up to 20 characters.
update_tagEdit tagChangesNeeds approval
Changes a tag's name or colour.
What the AI can send (3)
- id stringrequiredTag id.
- name stringTag name, up to 10 characters.
- color stringHex colour, for example #3b82f6.

Delete · 4

delete_linkDelete linkDeletesNeeds approval
Deletes a short link. Its short URL stops working.
What the AI can send (2)
- id stringThe link id.
- short_url stringThe short URL instead of the id, for example https://clik.is/summer.
delete_linksDelete several linksDeletesNeeds approval
Deletes up to 100 short links at once. Their short URLs stop working.
- Never looser than delete_link: if Delete link needs approval or is blocked, so is this.
What the AI can send (1)
- ids array of stringrequiredLink ids, 1–100.
delete_folderDelete folderDeletesNeeds approval
Deletes a folder. Its links are kept and become unfiled.
What the AI can send (1)
- id stringrequiredFolder id.
delete_tagDelete tagDeletesNeeds approval
Deletes a tag and removes it from every link.
What the AI can send (1)
- id stringrequiredTag id.

The extra tool: run_approved_action

When a tool needs your approval, the app also gets run_approved_action. It does not do anything new. It only fetches the result of an action you already approved in Clikso.

You cannot switch it off on its own, and you never need to. It only appears while at least one tool is set to Needs approval. See Approvals.

Good to know

list_links returns up to 50 links per call. Longer lists come back in pages.
The bulk tools take up to 100 links at once.
suggest_slugs uses your workspace's daily AI slug credits. check_slug checks one slug for free.
Tools follow the same rules as the REST API. If the API would refuse a request, the tool does too, with a plain message.
Apps that show the Clikso approval card also get two tools the card uses for its buttons. The AI model cannot see or call them.
No tool can read or set a link password. None can reach billing, API keys, members or workspace settings either.