Picoli Mcp

Created By
amaterous4 months ago
URL shortening and click analytics MCP server. Shorten URLs, create custom short links, track clicks, and analyze link performance.
Overview

picoli-mcp

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

Shorten URLs, track clicks, and analyze link performance directly from your AI assistant.

Setup

1. Get your API key

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

2. Configure your MCP client

Claude Desktop / Claude Code

Add to your MCP configuration:

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

Cursor

Add to .cursor/mcp.json:

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

Tools

shorten_url

Create a short URL with an optional custom slug.

Example prompts:

shorten_urls

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

Example prompts:

  • "Shorten these 3 URLs: ..."

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 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"

Environment Variables

VariableRequiredDefaultDescription
PICOLI_API_KEYYesYour picoli.site API key
PICOLI_BASE_URLNohttps://picoli.siteAPI base URL (for self-hosted instances)

Development

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

Test locally:

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

License

MIT

Server Config

{
  "mcpServers": {
    "picoli": {
      "command": "npx",
      "args": [
        "-y",
        "picoli-mcp"
      ],
      "env": {
        "PICOLI_API_KEY": "your-api-key-here"
      }
    }
  }
}
Project Info
Created At
4 months ago
Updated At
4 months ago
Author Name
amaterous
Star
-
Language
-
License
-
Category

Recommend Servers

View All
Tavily Mcp
@tavily-ai

JavaScript
a year ago
Gpt Scrambler

5 hours ago