Picoli MCP server
io.github.amaterous/picoli-mcp·v1.0.1·2 starsMCP server for picoli.site - URL shortening and click analytics for AI agents
2 stars34 downloads/wk
Reviews
Write oneNobody has reviewed Picoli yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Picoli tools (5, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_analyticsGet analytics overview: top 10 links by clicks, daily click stats, and total link count. Defaults to last 7 days.
get_link_statsGet click statistics for one or more short links by their slugs. Returns human click counts (bot traffic excluded).
list_linksList all shortened URLs with their click counts. Supports pagination.
shorten_urlwrite actionCreate a short URL using picoli.site. Optionally specify a custom slug. Returns the shortened URL and slug.
shorten_urlswrite actionCreate multiple short URLs at once (up to 500). Each URL can have an optional custom slug.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 226 days ago4/15
- Maintainer identityregistry namespace matches repository owner6/10
How Picoli compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 38% of 48,255 servers
- Tools
- 5
- the typical server has 7
- Tools that change things
- 40%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 75% of 28,688 servers
- Downloads a week
- 34
- more than 23% of 12,191 servers with a package
What its tools let an agent do: 3 read · 2 change
Install Picoli in Claude Code, Cursor or VS Code
Runs npx -y picoli-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add picoli-mcp -- npx -y picoli-mcp
What the publisher says
From the Picoli repository's README, as published. We do not edit it. Read it on GitHub
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: ..."
getlinkstats
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
Development
git clone https://github.com/yun/picoli-mcp.git
cd picoli-mcp
npm install
npm run buildTest locally:
PICOLI_API_KEY=your-key npx tsx src/index.tsLicense
MIT
Nothing above is checked by us. What we check is on the safety report.
Picoli: common questions
- Is Picoli MCP server safe?
- Mostly: it is graded B (72/100). Read the Picoli safety report
- How do I install Picoli?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Picoli need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Picoli maintained?
- The last commit was 262 days ago (2026-02-15). The latest release is v1.0.1.
- How does Picoli compare with other MCP servers?
- safety score 72/100 (higher than 38% of 48,255 servers); tools 5 (the typical server has 7); tools that change things 40% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.