English Français العربية

io.github.amaterous/picoli-mcp

Official registry Marketing and sales

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package picoli-mcp
Claude Code 
claude mcp add picoli-mcp -- npx -y picoli-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "picoli-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "picoli-mcp@1.0.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. picoli-mcp
  2. Setup
  3. Tools
  4. Environment Variables
  5. Development
  6. License

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_KEYYes—Your 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

Frequently asked questions

What is io.github.amaterous/picoli-mcp?

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

How do I install io.github.amaterous/picoli-mcp?

It runs on your machine. In Claude Code: claude mcp add picoli-mcp -- npx -y picoli-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.amaterous/picoli-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.amaterous/picoli-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.amaterous/picoli-mcp?

It is published by amaterous. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.