Picoli

Provides URL shortening, click tracking, and analytics for Picoli API integrations via MCP.

typescript

2

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "amaterous-picoli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "picoli-mcp"
      ],
      "env": {
        "PICOLI_API_KEY": "YOUR_API_KEY",
        "PICOLI_BASE_URL": "https://picoli.site"
      }
    }
  }
}

This MCP server lets you shorten URLs, track clicks, and analyze link performance for AI agents, enabling seamless URL management and analytics directly from your assistant.

How to use

To use this MCP server, configure your MCP client to run the provided command and supply your API key. Once set up, you can shorten single URLs, generate multiple short links at once, retrieve click statistics, list all links with counts, and view high-level analytics like top-performing links and daily trends.

How to install

Prerequisites you need on your machine or environment include Node.js and npm or npx. You will run the MCP client as a local process managed by your agent.

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

Configuration and usage notes

You must provide your Picoli API key to authenticate requests. The MCP configuration shown above runs the picoli-mcp package via npx, exporting the environment variable PICOLI_API_KEY. If you are using Cursor or Claude Desktop / Claude Code, place the same configuration in your MCP setup as shown.

Security and environment considerations

Keep your API key confidential and do not commit it to public sources. Use environment-specific configurations to avoid exposing secrets. If you host this MCP server remotely, ensure that access to the API key and the MCP endpoint is restricted to trusted clients.

Available tools

shorten_url

Create a short URL for a given long URL with an optional custom slug.

shorten_urls

Create multiple short URLs at once (up to 500) from a list of long URLs.

get_link_stats

Retrieve click statistics for specific short links, excluding bot traffic.

list_links

List all shortened URLs with click counts and support pagination.

get_analytics

Provide an analytics overview including top links, daily trends, and totals.