Skip to main content
Glama
magnus919

mcp-shlink

by magnus919
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcp-shlink

PyPI version Python versions License CI

A Model Context Protocol (MCP) server for Shlink link shortening service. This server exposes Shlink's URL shortening, management, and tagging capabilities as MCP tools for AI assistants.

Features

  • Create shortened URLs with custom slugs, tags, and expiration

  • List all shortened URLs with pagination info

  • Get details of specific URLs by short code

  • Delete shortened URLs

  • List and manage tags

  • Full type safety with Pydantic models

  • Built with the official MCP Python SDK

Related MCP server: DWZ Short URL MCP Server

Requirements

  • Python >= 3.10

  • A Shlink instance with API access

Installation

pip install mcp-shlink

Configuration

Set these environment variables before running the server:

Variable

Description

Required

SHLINK_BASE_URL

Your Shlink instance base URL (e.g., https://shlink.example.com)

Yes

SHLINK_API_KEY

Your Shlink API key

Yes

Generate an API key in Shlink:

shlink api-key:generate --name=my_api_key

Usage

Running as a standalone MCP server

SHLINK_BASE_URL=https://shlink.example.com SHLINK_API_KEY=your-key python -m mcp_shlink.server

Installing into Claude Desktop

uv run mcp install src/mcp_shlink/server.py --name "shlink"

Running with MCP Inspector

SHLINK_BASE_URL=https://shlink.example.com SHLINK_API_KEY=your-key uv run mcp dev src/mcp_shlink/server.py

Available Tools

Tool

Description

create_short_url

Create a new shortened URL

list_short_urls

List all shortened URLs

get_short_url

Get details of a URL by short code

delete_short_url

Delete a shortened URL

list_tags

List all tags

Development

# Clone the repository
git clone https://github.com/magnus919/mcp-shlink
cd mcp-shlink

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest

# Lint and format
ruff check .
ruff format .

# Type check
mypy src/

# Full verification
ruff check . && ruff format . --check && mypy src/ && pytest

Project Structure

src/mcp_shlink/
├── server.py       # FastMCP server entry point
├── client.py       # Shlink API client
├── tools.py        # MCP tool definitions
└── models.py       # Pydantic models for API requests/responses

tests/
├── test_tools.py    # Unit tests for MCP tools
└── test_client.py   # Unit tests for Shlink client

License

Apache 2.0. See LICENSE.

Install Server
A
license - permissive license
B
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • DWZ Short URL MCP Server

    muleiwu
    A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to create, manage, and analyze short URLs through complete URL shortening functionality. Supports batch operations, custom domains, click statistics, and comprehensive link management.
    6
    6
    1
    MIT

  • Clypt MCP Server

    Bonsai-Tech-LLC
    A
    license
    -
    quality
    B
    maintenance
    Connects AI assistants to the Clypt Link Intelligence platform to shorten URLs, manage tags, and generate QR codes. It enables users to view link analytics and perform bulk link operations through natural language commands.
    47
    MIT

  • shiori-mcp

    rusty4444
    A
    license
    A
    quality
    B
    maintenance
    Enables interaction with Shiori, a self-hosted bookmark and read-it-later manager, for managing bookmarks and tags.
    13
    MIT

View all related MCP servers

Related MCP Connectors

  • linkly

    Create and manage short links, track clicks, and automate URL management

  • whooshly-mcp

    Create short links, QR codes, UTM templates, vCards, and landing pages from your AI assistant.

  • CodeQR

    Create and manage CodeQR short links, QR codes, and analytics from any MCP client.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/magnus919/mcp-shlink'

If you have feedback or need assistance with the MCP directory API, please join our Discord server