Picoli MCP

🚀 picoli-mcp

MCP server for picoli.site — URL shortening and click analytics for AI agents.

This project enables you to shorten URLs, track clicks, and analyze link performance directly from your AI assistant.

🚀 Quick Start

🔑 Get your API key

Create an account at picoli.site and obtain your API key from the dashboard.

⚙️ Configure your MCP client

Claude Desktop / Claude Code

Add the following to your MCP configuration:

{
  "mcpServers": {
    "picoli": {
      "command": "npx",
      "args": ["-y", "picoli-mcp"],
      "env": {
        "PICOLI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add the following to .cursor/mcp.json:

{
  "mcpServers": {
    "picoli": {
      "command": "npx",
      "args": ["-y", "picoli-mcp"],
      "env": {
        "PICOLI_API_KEY": "your-api-key-here"
      }
    }
  }
}

✨ Features

shorten_url

Create a short URL with an optional custom slug.

Example prompts:

• "Shorten https://example.com/very-long-article-url"
• "Create a short link for https://my-site.com with slug 'launch'"

shorten_urls

Create multiple short URLs at once (up to 500).

Example prompts:

• "Shorten these 3 URLs: ..."

get_link_stats

Get click statistics for specific links (bot traffic excluded).

Example prompts:

• "How many clicks did my 'launch' link get?"
• "Show me stats for these slugs: launch, demo, blog-post"

list_links

List all shortened URLs with click counts and pagination.

Example prompts:

• "Show me all my short links"
• "List my links sorted by clicks"

get_analytics

Get analytics overview: top 10 links, daily click trends, and totals.

Example prompts:

• "Show me my link analytics for this week"
• "What are my top performing links?"
• "Give me click stats from 2026-01-01 to 2026-01-31"

📚 Documentation

Environment Variables

📦 Installation

Development

git clone https://github.com/yun/picoli-mcp.git
cd picoli-mcp
npm install
npm run build

Local Testing

PICOLI_API_KEY=your-key npx tsx src/index.ts

📄 License

MIT