jakedwyer/short-io-mcp-server
If you are the rightful owner of short-io-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server for Short.io URL shortening service, providing tools for creating, managing, and analyzing short links through the Short.io API.
Short.io MCP Server
A Model Context Protocol (MCP) server for Short.io URL shortening service. This server provides tools for creating, managing, and analyzing short links through the Short.io API.
Features
- Create and manage short links
- Domain management
- Link statistics and analytics
- Bulk operations support
- Health monitoring
Development Setup
- Clone the repository:
git clone https://github.com/YOUR_USERNAME/short-io-mcp-server.git
cd short-io-mcp-server
- Install dependencies:
pip install -r requirements.txt
- Create environment file:
cp .env.example .env
# Edit .env with your Short.io API credentials
- Run locally:
python server.py
Production Deployment
This server automatically deploys to DigitalOcean when you push to the main branch.
Prerequisites
- DigitalOcean Droplet with Docker installed
- SSH key access to the droplet
- GitHub repository secrets configured:
DEPLOY_SSH_KEY: Private SSH key for droplet accessDROPLET_IP: IP address of your DigitalOcean droplet
Environment Variables
Configure these on your droplet in /opt/mcp-servers/short-io/.env:
SHORT_API_KEY: Your Short.io API keySHORT_DOMAIN: Default domain for short links
Usage
Once deployed, the server will be available at:
- Health check:
http://YOUR_DROPLET_IP:8001/healthz - MCP endpoint:
http://YOUR_DROPLET_IP:8001
API Documentation
The server implements the MCP protocol and provides the following tools:
- Link creation and management
- Domain operations
- Statistics and analytics
- Bulk operations
See the server.py file for complete API documentation.