{
  "markdown": "# picoli-mcp\n\nMCP server for [picoli.site](https://picoli.site) — URL shortening and click analytics for AI agents.\n\nShorten URLs, track clicks, and analyze link performance directly from your AI assistant.\n\n## Setup\n\n### 1. Get your API key\n\nCreate an account at [picoli.site](https://picoli.site) and get your API key from the dashboard.\n\n### 2. Configure your MCP client\n\n#### Claude Desktop / Claude Code\n\nAdd to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"picoli\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"picoli-mcp\"],\n      \"env\": {\n        \"PICOLI_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n#### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"picoli\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"picoli-mcp\"],\n      \"env\": {\n        \"PICOLI_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### `shorten_url`\n\nCreate a short URL with an optional custom slug.\n\n**Example prompts:**\n- \"Shorten https://example.com/very-long-article-url\"\n- \"Create a short link for https://my-site.com with slug 'launch'\"\n\n### `shorten_urls`\n\nCreate multiple short URLs at once (up to 500).\n\n**Example prompts:**\n- \"Shorten these 3 URLs: ...\"\n\n### `get_link_stats`\n\nGet click statistics for specific links (bot traffic excluded).\n\n**Example prompts:**\n- \"How many clicks did my 'launch' link get?\"\n- \"Show me stats for these slugs: launch, demo, blog-post\"\n\n### `list_links`\n\nList all shortened URLs with click counts and pagination.\n\n**Example prompts:**\n- \"Show me all my short links\"\n- \"List my links sorted by clicks\"\n\n### `get_analytics`\n\nGet analytics overview: top 10 links, daily click trends, and totals.\n\n**Example prompts:**\n- \"Show me my link analytics for this week\"\n- \"What are my top performing links?\"\n- \"Give me click stats from 2026-01-01 to 2026-01-31\"\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `PICOLI_API_KEY` | Yes | — | Your picoli.site API key |\n| `PICOLI_BASE_URL` | No | `https://picoli.site` | API base URL (for self-hosted instances) |\n\n## Development\n\n```bash\ngit clone https://github.com/yun/picoli-mcp.git\ncd picoli-mcp\nnpm install\nnpm run build\n```\n\nTest locally:\n\n```bash\nPICOLI_API_KEY=your-key npx tsx src/index.ts\n```\n\n## License\n\nMIT\n",
  "bytes": 2286,
  "sha": "0ed4fbeeb309bc7b41462913f88fb9b722264b1969133d73fec7ee985554f86e",
  "repo_slug": "amaterous/picoli-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_amaterous_picoli_mcp_17744b63/readme"
}