mcpField
P
Picoli Mcp

Picoli Mcp

Local
github.com/amaterousData & Analytics2Updated 37w ago
Repository

About Picoli Mcp

Picoli Mcp is an MCP server for managing picoli.site short links and their click analytics. It lets AI assistants create links, inspect statistics, and review performance.

Key features

  1. 01Create short URLs with optional custom slugs
  2. 02Shorten up to 500 URLs at once
  3. 03View click statistics for selected links
  4. 04List links with click counts and pagination
  5. 05Review top links, trends, and totals

Use cases

  1. 01Create a branded short link for a campaign
  2. 02Batch-shorten URLs for a content release
  3. 03Check click counts for selected links
  4. 04Review daily link performance

MCP support

Exposes URL-shortening and analytics tools to MCP clients. It requires a picoli.site API key and supports a configurable API base URL.

#url-shortener#analytics#link-management

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "amaterous-picoli": {
      "command": "npx",
      "args": [
        "-y",
        "picoli-mcp"
      ]
    }
  }
}
Run commandnpx -y picoli-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmpicoli-mcp1.0.1

Tools

5

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
urlstringYesThe destination URL to shorten
slugstringNoOptional custom slug (e.g. 'my-link'). If not provided, a random slug is generated.

Details

From the project README

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

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.