Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@picoli-mcp Shorten https://example.com/long-article"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Create an account at picoli.site and get your API key from the dashboard.
Add to your MCP configuration:
{
"mcpServers": {
"picoli": {
"command": "npx",
"args": ["-y", "picoli-mcp"],
"env": {
"PICOLI_API_KEY": "your-api-key-here"
}
}
}
}Add to .cursor/mcp.json:
{
"mcpServers": {
"picoli": {
"command": "npx",
"args": ["-y", "picoli-mcp"],
"env": {
"PICOLI_API_KEY": "your-api-key-here"
}
}
}
}Related MCP server: filoo MCP server
shorten_urlCreate a short URL with an optional custom slug.
Example prompts:
"Create a short link for https://my-site.com with slug 'launch'"
shorten_urlsCreate multiple short URLs at once (up to 500).
Example prompts:
"Shorten these 3 URLs: ..."
get_link_statsGet 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_linksList all shortened URLs with click counts and pagination.
Example prompts:
"Show me all my short links"
"List my links sorted by clicks"
get_analyticsGet 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"
Variable | Required | Default | Description |
| Yes | — | Your picoli.site API key |
| No |
| API base URL (for self-hosted instances) |
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.tsMIT
Get analytics overview: top 10 links by clicks, daily click stats, and total link count. Defaults to last 7 days.
Inputs: end_date, start_date.
Get click statistics for one or more short links by their slugs. Returns human click counts (bot traffic excluded).
Inputs: slugs (required).
List all shortened URLs with their click counts. Supports pagination.
Inputs: page, limit.
Create a short URL using picoli.site. Optionally specify a custom slug. Returns the shortened URL and slug.
Inputs: url (required), slug.
Create multiple short URLs at once (up to 500). Each URL can have an optional custom slug.
Inputs: links (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool serves a distinct purpose: creating single vs bulk short URLs, retrieving stats for specific links, listing all links, and getting an analytics overview. No ambiguity between them.
All tool names follow a verb_noun snake_case pattern (shorten_url, shorten_urls, get_link_stats, list_links, get_analytics). The verbs and nouns are consistent and predictable.
With 5 tools, the set is well-scoped for a URL shortener API. Each tool covers a necessary function without unnecessary bloat or gaps.
Core operations are covered: creating (single and bulk), listing, and retrieving stats/analytics. Missing delete or update functionality, but this is a minor gap for a typical URL shortener use case.
Create short links and see their click counts from your AI assistant.
Create and manage short links, track clicks, and automate URL management
Short-link service embedded in your AI workflow — shorten links, track campaigns, read stats.
UTM-tagged short links with naming rules, QR codes and click analytics, from your AI.
