linkonda-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@linkonda-mcp Create a short link for https://example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 | |
| ✅ 10 links, expire after 30 days | ✅ permanent, saved to your account |
| ✅ | ✅ |
| ✅ anonymous allowance | ✅ your plan |
| ✗ | ✅ |
Bearer authentication requires a paid plan — see pricing. Create a key in the dashboard under API keys; it is shown once.
Related MCP server: enke
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 |
| (unset) | Bearer key. Omit to run anonymously. |
|
| Point at another instance. |
Tools
Tool | What it does | Key required |
| Shorten one URL | No |
| Shorten up to 100 URLs in one request | Yes |
| List your links with destinations and click counts | Yes |
| Change a destination, or pause/resume a link | Yes |
| Permanently delete a link | Yes |
| Total redirect count for a link | No |
| 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 stdionpm run typecheck runs the compiler without emitting.
Available Tools
7 toolscheck_quotaCheck remaining link allowanceARead-only
Report how many links are live and how many the current plan allows. Without an API key this reports the anonymous allowance. Use it before a bulk create to check for room.
Inputs: no named parameters.
delete_linkDelete a short linkADestructiveIdempotent
Permanently delete a short link. The short URL stops working immediately and anyone who already has it will get a 404 — prefer update_link with paused:true if it might be needed again. Requires an API key.
Inputs: slug (required).
get_link_statsGet a short link's click countARead-only
Return the total number of times a short link has been followed. This is the only click data that exists — Linkonda stores no per-visitor information, so there is no geographic, device, or referrer breakdown to report. No API key needed.
Inputs: slug (required).
list_linksList my short linksARead-only
List the short links on the authenticated account, with their destinations and total redirect counts. Requires an API key.
Inputs: no named parameters.
shorten_linkShorten a URLA
Create a short link for a URL. Works without an API key (anonymous links expire and are not saved to an account). Linkonda records only a total redirect count per link — no IP addresses, geolocation, device data, or referrers. Use when the user wants a short or shareable URL, or a link for a QR code.
Inputs: url (required), slug, expiresInDays.
shorten_links_bulkShorten many URLs at onceA
Create up to 100 short links in a single request. Requires an API key. Use this instead of calling shorten_link repeatedly when shortening several URLs.
Inputs: links (required).
update_linkUpdate or pause a short linkAIdempotent
Change a short link's destination, or pause/resume it. A paused link stops redirecting but is not deleted. Requires an API key. Changing the destination requires a paid plan.
Inputs: slug (required), url, paused.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: creating single vs bulk links, listing, updating, deleting, fetching stats, and checking quota. The only potential overlap between list_links and get_link_stats is clarified by their descriptions (account-level vs single-link, with different API key requirements).
All tool names follow a consistent verb_noun pattern (shorten_link, list_links, update_link, delete_link, get_link_stats, check_quota). The one exception, shorten_links_bulk, still follows the pattern and is clearly readable.
Seven tools is well-scoped for a link shortener service. Each tool addresses a distinct operation, covering the full lifecycle without unnecessary bloat or missing essentials.
The tool set provides full CRUD coverage (create, read, update, delete) plus bulk creation, statistics, and quota checking. There are no obvious dead ends; users can perform all core link management tasks.
Related MCP Connectors
Official PicSee MCP server for short links, link management, click analytics, and optional OAuth.
Cookie-free web analytics MCP server: read stats, create UTM links, goals and ad costs.
Official in.bio MCP server: shorten URLs, styled QR codes, and click analytics. No API key needed.
Related MCP Servers
AlicenseAqualityDmaintenanceMCP server for Linklee that enables creating short links, listing links, getting click analytics, and managing workspace tags.4MIT- AlicenseAqualityCmaintenanceMCP server for en.ke link management enabling AI agents to shorten URLs, manage links, and view analytics.1214 npmMIT
- AlicenseBqualityCmaintenanceMCP server for opn.onl, the open-source self-hostable URL shortener. Shorten links, read click analytics, generate branded QR codes, and manage links — against the hosted service or your own instance.2446 npm2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables AI agents to manage Lnkify links, domains, API keys, and analytics. Allows creation and resolution of short links through natural language.MIT