Zulk Short Url Skill

# Zulk URL Shortener Skill

This skill enables AI agents to manage short links using the Zu.lk MCP (Model Context Protocol) server.

## Overview

Zu.lk is an AI-first premium URL shortener designed for blazing-fast performance and seamless AI integration. This skill connects your agent to the Zulk MCP server, allowing it to:

- Create shortened URLs (e.g., `zu.lk/abcd`)
- Manage existing links and campaigns
- Access real-time analytics
- Collaborate with team members

## Installation

To use this skill, add the Zulk MCP server configuration to your AI assistant's settings (e.g., `mcp.json` or equivalent).

### Configuration Options

Choose the transport method that best fits your environment:

#### 1. Streamable HTTP (Recommended)
Fastest and most reliable communication.
```json
{
  "mcpServers": {
    "zulk-url-shortener": { "url": "https://mcp.zu.lk/mcp" }
  }
}
```

#### 2. SSE (Server-Sent Events)
Real-time streaming specialized for certain clients.
```json
{
  "mcpServers": {
    "zulk-url-shortener": { "url": "https://mcp.zu.lk/sse" }
  }
}
```

#### 3. Stdio (via mcp-remote)
Uses standard input/output via a remote bridge.
```json
{
  "mcpServers": {
    "zulk-url-shortener": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.zu.lk/mcp"]
    }
  }
}
```

## Step-by-Step Instructions

1.  **Preparation**: Ensure you have a Zu.lk account or are ready to sign in via Google.
2.  **Configuration**: Add one of the JSON configurations above to your agent's MCP settings file.
3.  **Authentication**: When you first run a command like "shorten this link", the agent will present an OAuth URL. Follow the link to authenticate.
4.  **Verification**: Ask the agent "List my recently created links" to verify the connection is active.
5.  **Execution**: Use natural language to create links, e.g., "Create a short link for https://google.com with alias 'my-search'".

## Usage Examples

### Creating a Link
**Input**: "Shorten https://github.com/Zu-lk/zulk-short-ur...

# Zulk Skills Repository

A collection of AI Agent Skills and Model Context Protocol (MCP) integrations for [Zu.lk](https://zu.lk) - the AI-first premium URL shortener.

## 🚀 Mission

Empowering AI agents to manage digital presence through seamless URL shortening, real-time tracking, and advanced analytics.

## 📦 What's inside?

- **[SKILL.md](./SKILL.md)**: The primary Agent Skill definition compatible with OpenClaw, Cursor, VS Code, and other `AgentSkills` compliant assistants.
- **MCP Server Integration**: Direct access to the Zulk MCP server with multiple transport options (HTTP, SSE, Stdio).

## 🛠️ Quick Start

### For Cursor / Claude Desktop / VS Code
Add the following to your MCP configuration:

```json
{
  "mcpServers": {
    "zulk-url-shortener": {
      "url": "https://mcp.zu.lk/mcp"
    }
  }
}
```

### For OpenClaw
1. Add the repository URL `https://github.com/Zu-lk/zulk-short-url-skill` to your OpenClaw skills list.
2. The agent will automatically detect `SKILL.md` and configure the Zulk capabilities.

## 🔐 Security & Privacy

Zulk uses Google OAuth 2 for secure authentication. Your links and analytics are only accessible to you and your authorized team members.

## 📖 Links
- [Zu.lk Website](https://zu.lk)
- [Zu.lk MCP Details](https://zu.lk/-/mcp)
- [API Documentation](https://zu.lk/-/api)

---
© 2025 Zulk. Blazing-fast redirects for the AI era.