mcpField
L
Linkonda

Linkonda

Local
linkonda.comProductivity0Updated 11w ago
RepositoryVisit website

About Linkonda

Linkonda is an MCP server for creating and managing short links from MCP clients. It supports anonymous shortening without an API key and offers account-backed link management when a key is configured; it records only aggregate redirect counts.

Key features

  1. 01Shorten individual URLs without a key
  2. 02Bulk-shorten up to 100 URLs
  3. 03List, update, and delete saved links
  4. 04View total redirects and quota

Use cases

  1. 01Create short links from an MCP client
  2. 02Shorten a batch of URLs for a campaign
  3. 03Check aggregate redirects without visitor profiles

MCP support

The server runs over MCP stdio and can be added to client configuration. Tools for persistent links and link management require `LINKONDA_API_KEY`; basic shortening, stats, and quota checks can run without one.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "com-linkonda": {
      "command": "npx",
      "args": [
        "-y",
        "@veranoapp/linkonda-mcp"
      ],
      "env": {
        "LINKONDA_API_KEY": "<LINKONDA_API_KEY>",
        "LINKONDA_API_BASE_URL": "<LINKONDA_API_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y @veranoapp/linkonda-mcp
Environment variables to set
LINKONDA_API_KEYSecretLinkonda API key (paid plans). Optional — without it the server still shortens URLs anonymously, but links expire and account tools are unavailable.
LINKONDA_API_BASE_URLOverride the API host. Defaults to https://api.linkonda.com.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@veranoapp/linkonda-mcp0.1.5

Tools

7

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
urlstringYesThe destination URL to shorten. Must be absolute, e.g. https://example.com/page
slugstringNoOptional custom short code. Requires a paid plan; omit it to get a generated one.
expiresInDaysintegerNoOptional. Delete the link automatically after this many days. Requires a Pro or Enterprise plan — omit it on other plans, where the plan's own lifetime applies.

Details

From the project README

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 keyWith 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" }
    }
  }
}
VariableDefaultPurpose
LINKONDA_API_KEY(unset)Bearer key. Omit to run anonymously.
LINKONDA_API_BASE_URLhttps://api.linkonda.comPoint at another instance.

Tools

ToolWhat it doesKey required
shorten_linkShorten one URLNo
shorten_links_bulkShorten up to 100 URLs in one requestYes
list_linksList your links with destinations and click countsYes
update_linkChange a destination, or pause/resume a linkYes
delete_linkPermanently delete a linkYes
get_link_statsTotal redirect count for a linkNo
check_quotaLinks live vs. plan allowanceNo

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.