Can I use Dub.co as a CLI?

Yes. KosmoKrator exposes a Dub.co CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Dub.co through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Dub.co tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Dub.co credentials stored?

Dub.co credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Dub.co MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

marketing

Dub.co Lua API for KosmoKrator Agents

Agent-facing Lua documentation and function reference for the Dub.co KosmoKrator integration.

7 functions 6 read 1 write Bearer token auth

Submit Dub.co feedback View package source

Lua Namespace

Agents call this integration through app.integrations.dub.*. Use lua_read_doc("integrations.dub") inside KosmoKrator to discover the same reference at runtime.

Agent-Facing Lua Docs

This is the rendered version of the full Lua documentation exposed to agents when they inspect the integration namespace.

Dub.co Integration

Available Tools

dub_list_links

List short links with pagination, search, and filtering by domain or tag.

Parameters:

page (integer, optional) — Page number for pagination (default: 1).
pageSize (integer, optional) — Number of results per page (default: 50).
search (string, optional) — Search query to filter links by URL, key, or title.
domain (string, optional) — Filter links by domain (e.g., “lnkd.in”, “dub.sh”).
tagId (string, optional) — Filter links by tag ID.

dub_get_link

Get details of a specific short link by its ID.

Parameters:

id (string, required) — The link ID.

dub_create_link

Create a new short link.

Parameters:

url (string, required) — The destination URL to shorten.
domain (string, optional) — The domain for the short link.
key (string, optional) — The custom key (back-half) for the short link.
title (string, optional) — Optional title for the link.
description (string, optional) — Optional description for the link.
tags (array, optional) — Array of tag names to assign.

dub_list_domains

List all domains configured in the workspace.

Parameters:

page (integer, optional) — Page number for pagination (default: 1).
pageSize (integer, optional) — Number of results per page (default: 50).

dub_get_domain

Get details of a specific domain by ID or slug.

Parameters:

id (string, required) — The domain ID or slug.

dub_list_tags

List link tags with pagination and search.

Parameters:

page (integer, optional) — Page number for pagination (default: 1).
pageSize (integer, optional) — Number of results per page (default: 50).
search (string, optional) — Search query to filter tags by name.

dub_get_current_user

Get the profile of the currently authenticated user.

Parameters: None.

Raw agent markdown

# Dub.co Integration

## Available Tools

### dub_list_links
List short links with pagination, search, and filtering by domain or tag.

**Parameters:**
- `page` (integer, optional) — Page number for pagination (default: 1).
- `pageSize` (integer, optional) — Number of results per page (default: 50).
- `search` (string, optional) — Search query to filter links by URL, key, or title.
- `domain` (string, optional) — Filter links by domain (e.g., "lnkd.in", "dub.sh").
- `tagId` (string, optional) — Filter links by tag ID.

### dub_get_link
Get details of a specific short link by its ID.

**Parameters:**
- `id` (string, required) — The link ID.

### dub_create_link
Create a new short link.

**Parameters:**
- `url` (string, required) — The destination URL to shorten.
- `domain` (string, optional) — The domain for the short link.
- `key` (string, optional) — The custom key (back-half) for the short link.
- `title` (string, optional) — Optional title for the link.
- `description` (string, optional) — Optional description for the link.
- `tags` (array, optional) — Array of tag names to assign.

### dub_list_domains
List all domains configured in the workspace.

**Parameters:**
- `page` (integer, optional) — Page number for pagination (default: 1).
- `pageSize` (integer, optional) — Number of results per page (default: 50).

### dub_get_domain
Get details of a specific domain by ID or slug.

**Parameters:**
- `id` (string, required) — The domain ID or slug.

### dub_list_tags
List link tags with pagination and search.

**Parameters:**
- `page` (integer, optional) — Page number for pagination (default: 1).
- `pageSize` (integer, optional) — Number of results per page (default: 50).
- `search` (string, optional) — Search query to filter tags by name.

### dub_get_current_user
Get the profile of the currently authenticated user.

**Parameters:** None.

Metadata-Derived Lua Example

local result = app.integrations.dub.dub_list_links({
  page = 1,
  pageSize = 1,
  search = "example_search",
  domain = "example_domain",
  tagId = "example_tagId"
})
print(result)

Functions

`dub_list_links`

List short links from Dub.co. Supports pagination, searching, and filtering by domain or tag.

Operation: Read read
Full name: dub.dub_list_links

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).
`pageSize`	integer	no	Number of results per page (default: 50).
`search`	string	no	Search query to filter links by URL, key, or title.
`domain`	string	no	Filter links by domain (e.g., "lnkd.in", "dub.sh").
`tagId`	string	no	Filter links by tag ID.

`dub_get_link`

Get details of a specific short link by its ID.

Operation: Read read
Full name: dub.dub_get_link

Parameter	Type	Required	Description
`id`	string	yes	The link ID (e.g., "clx...", "cmo...").

`dub_create_link`

Create a new short link in Dub.co. Provide a destination URL and optionally a custom domain, key (back-half), title, description, and tags.

Operation: Write write
Full name: dub.dub_create_link

Parameter	Type	Required	Description
`url`	string	yes	The destination URL to shorten (e.g., "https://example.com/long-page").
`domain`	string	no	The domain for the short link (e.g., "dub.sh", "lnkd.in"). Defaults to workspace default.
`key`	string	no	The custom key (back-half) for the short link (e.g., "my-link" → "dub.sh/my-link").
`title`	string	no	Optional title for the link.
`description`	string	no	Optional description for the link.
`tags`	array	no	Array of tag names to assign to the link (e.g., ["campaign", "social"]).

`dub_list_domains`

List all domains configured in your Dub.co workspace.

Operation: Read read
Full name: dub.dub_list_domains

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).
`pageSize`	integer	no	Number of results per page (default: 50).

`dub_get_domain`

Get details of a specific domain by its ID or slug.

Operation: Read read
Full name: dub.dub_get_domain

Parameter	Type	Required	Description
`id`	string	yes	The domain ID or slug (e.g., "dub.sh", "clx...").

`dub_list_tags`

List link tags in your Dub.co workspace. Supports pagination and search.

Operation: Read read
Full name: dub.dub_list_tags

Parameter	Type	Required	Description
`page`	integer	no	Page number for pagination (default: 1).
`pageSize`	integer	no	Number of results per page (default: 50).
`search`	string	no	Search query to filter tags by name.

`dub_get_current_user`

Get the profile of the currently authenticated Dub.co user. Useful for verifying the connection and checking workspace membership.

Operation: Read read
Full name: dub.dub_get_current_user

Parameter	Type	Required	Description
No parameters.