linkonda-mcp

Linkonda MCP server

Create and manage Linkonda short links from Claude, Claude Code, Cursor, or any other MCP client.

Linkonda records a total redirect count per link and nothing else — no IP addresses, geolocation, device data, or referrers. That matters more than usual for an agent, which can generate links in bulk without building a visitor dataset you then have to secure, retain, and answer requests about.

Works without an API key

Most shortener MCP servers refuse to start without credentials. This one shortens URLs immediately on install: anonymous links are capped per network and expire after 30 days. Add a key when you want links that persist and can be managed.

	No key	With LINKONDA_API_KEY
shorten_link	✅ 10 links, expire after 30 days	✅ permanent, saved to your account
get_link_stats	✅	✅
check_quota	✅ anonymous allowance	✅ your plan
shorten_links_bulk, list_links, update_link, delete_link	✗	✅

Bearer authentication requires a paid plan — see pricing. Create a key in the dashboard under API keys; it is shown once.

Install

Add to your MCP client config (Claude Desktop: claude_desktop_config.json; Claude Code: .mcp.json):

{
  "mcpServers": {
    "linkonda": {
      "command": "npx",
      "args": ["-y", "@veranoapp/linkonda-mcp"]
    }
  }
}

To use an API key, add it to the same entry:

{
  "mcpServers": {
    "linkonda": {
      "command": "npx",
      "args": ["-y", "@veranoapp/linkonda-mcp"],
      "env": { "LINKONDA_API_KEY": "lk_your_key_here" }
    }
  }
}

Variable	Default	Purpose
LINKONDA_API_KEY	(unset)	Bearer key. Omit to run anonymously.
LINKONDA_API_BASE_URL	https://api.linkonda.com	Point at another instance.

Tools

Tool	What it does	Key required
shorten_link	Shorten one URL	No
shorten_links_bulk	Shorten up to 100 URLs in one request	Yes
list_links	List your links with destinations and click counts	Yes
update_link	Change a destination, or pause/resume a link	Yes
delete_link	Permanently delete a link	Yes
get_link_stats	Total redirect count for a link	No
check_quota	Links live vs. plan allowance	No

shorten_links_bulk is partial-success: some entries can fail (quota, invalid URL) while others are created, and the tool reports both lists rather than only the successes.

What you cannot get

There is no per-visitor data to return, so there are no tools for geographic, device, or referrer breakdowns — that data is never collected. If your workflow needs click attribution, a tracking shortener is the right tool; see the comparisons.

Development

npm install
npm run build
LINKONDA_API_KEY=lk_... npm start   # speaks MCP over stdio

npm run typecheck runs the compiler without emitting.