Picoli Mcp

by amaterous

276 downloads

Not rated

GitHub

Other

About

URL shortening and click analytics MCP server. Shorten URLs, create custom short links, track clicks, and analyze link performance.

Details

Author: amaterous
Downloads: 276
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Picoli Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Obtain an API key from your picoli.site dashboard, then configure your MCP client by setting the PICOLI_API_KEY environment variable. Use the provided tools to shorten URLs, get click statistics, list links, and view analytics.

`shorten_url`

Create a short URL using picoli.site. Optionally specify a custom slug. Returns the shortened URL and slug.

`shorten_urls`

Create multiple short URLs at once (up to 500). Each URL can have an optional custom slug.

`get_link_stats`

Get click statistics for one or more short links by their slugs. Returns human click counts (bot traffic excluded).

`list_links`

List all shortened URLs with their click counts. Supports pagination.

`get_analytics`

Get analytics overview: top 10 links by clicks, daily click stats, and total link count. Defaults to last 7 days.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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

Environment Variables

| Variable | Required | Default | Description |
|---|---|---|---|
| PICOLI_API_KEY | Yes | — | Your picoli.site API key |
| PICOLI_BASE_URL | No | https://picoli.site | API 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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

shorten_url

shorten_urls

get_link_stats

list_links

get_analytics

Claude Desktop / Cursor

McpServers

picoli-mcp

Setup

1. Get your API key

2. Configure your MCP client

Claude Desktop / Claude Code

Cursor

Tools

shorten_url

shorten_urls

get_link_stats

list_links

get_analytics

Environment Variables

Development

License

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`shorten_url`

`shorten_urls`

`get_link_stats`

`list_links`

`get_analytics`

`shorten_url`

`shorten_urls`

`get_link_stats`

`list_links`

`get_analytics`