Linkonda
Create and manage Linkonda short links and QR codes, with no per-visitor tracking.
Open source Open in the app JSON README (API)
About
Create and manage Linkonda short links and QR codes, with no per-visitor tracking.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- com.linkonda
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.3
- Last push
- 2026-08-16T09:35:24Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:13
- Updated
- 2026-08-29 03:01:13
- Origin id
com.linkonda/mcp
README
# Linkonda MCP server
Create and manage [Linkonda](https://linkonda.com) 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](https://linkonda.com/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`):
```json
{
"mcpServers": {
"linkonda": {
"command": "npx",
"args": ["-y", "@veranoapp/linkonda-mcp"]
}
}
}
```
To use an API key, add it to the same entry:
```json
{
"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](https://linkonda.com/alternatives/bitly).
## Development
```bash
npm install
npm run build
LINKONDA_API_KEY=lk_... npm start # speaks MCP over stdio
```
`npm run typecheck` runs the compiler without emitting.