PicSee Short Link

Name: PicSee Short Link
Author: picsee.io

Remote

picsee.ioBusiness & Marketing0Updated 1w ago

Repository Visit website

About PicSee Short Link

PicSee Short Link is a remote MCP server for creating and managing PicSee short links and checking click analytics. Anonymous access can create links; signing in with PicSee OAuth unlocks account tools according to the account plan.

Key features

01Create short links with anonymous or signed-in access
02List, delete, and recover links when signed in
03Inspect click, device, referrer, and region analytics
04Manage domains, tags, and tracking tools
05Expose editing and audience labels on eligible plans

Use cases

01Create a short link from an AI client
02Review recent links and click performance
03Edit, remove, or recover a link when permitted

MCP support

The remote Streamable HTTP MCP server is available at `https://api.picsee.io/mcp`. It exposes short-link and analytics tools, with signed-in capabilities determined by OAuth access and the PicSee account plan.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://api.picsee.io/mcp

Copy install command

Claude CodeTerminalclaude mcp add --transport http io-picsee-short-link https://api.picsee.io/mcp

Cursor.cursor/mcp.json{"mcpServers":{"io-picsee-short-link":{"type":"http","url":"https://api.picsee.io/mcp"}}}Open in Cursor

VS Code.vscode/mcp.json{"servers":{"io-picsee-short-link":{"type":"http","url":"https://api.picsee.io/mcp"}}}Open in VS Code

Claude Desktopclaude_desktop_config.json{"mcpServers":{"io-picsee-short-link":{"type":"http","url":"https://api.picsee.io/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"io-picsee-short-link":{"serverUrl":"https://api.picsee.io/mcp"}}}

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Parameter	Type	Required	Description
url	string	Yes	Destination URL the short link should redirect to. Required.
utm	object	No	UTM parameters appended to the destination URL. Pass `null` on edit to clear all previously set UTM values.
utm.term	string	No	utm_term
utm.medium	string	No	utm_medium
utm.source	string	No	utm_source
utm.content	string	No	utm_content
utm.campaign	string	No	utm_campaign
domain	string	No	Domain to host the short link on (e.g. `pse.is` or one of the BSDs from `get_my_domains`). Falls back to the account default when omitted or invalid.
encodeId	string	No	Custom slug (3-90 chars; English letters, digits, `_`, `-`, or Chinese). Must be globally unique on PicSee — conflicts return `PUB00503`. Omit to let PicSee auto-generate.
externalId	string	No	Free-form identifier (1-100 chars) for grouping / attributing links. Surfaces in `list_short_links` filters and `get_api_usage_by_external_id`. When the user has not specified a value, you (the calling AI agent) SHOULD default this to your own product name so the account owner can attribute API usage back to the agent that created the link — e.g. `Claude Code`, `Codex`, `Cursor`, `ChatGPT`, `Gemini CLI`, `Copilot`. Use the canonical product name only; do not include version numbers or session IDs. If the user explicitly provides an `externalId`, always honor their value instead.

Details

From the project README

PicSee MCP Server

The official remote Model Context Protocol (MCP) server for PicSee, a URL shortener with link management and click analytics.

Connect an AI agent to PicSee to create short links, manage existing links, and inspect click performance using natural language.

Official MCP endpoint

https://api.picsee.io/mcp

Transport: Streamable HTTP
Authentication: Anonymous or OAuth 2.1 with PKCE
Registry name: io.picsee/short-link
Official Registry: MCP Registry

Capabilities

Anonymous access

Anonymous clients can create a PicSee short link using the shared pse.is domain. Anonymous access does not expose account data, link lists, management tools, or analytics.

Signed-in access

After signing in with PicSee OAuth, available tools depend on the account's API plan:

Create short links using available PicSee or branded domains.
Check API plan status and usage.
List available domains, tags, and tracking tools.
List, delete, or recover short links.
View overview, daily clicks, device, referrer, and country analytics.
Use Advanced-plan editing, search, metadata, tracking, and audience-label features when available.

The server dynamically exposes only the tools supported by the signed-in account.

Install

Codex

codex mcp add picsee --url https://api.picsee.io/mcp

Restart Codex after installation. To sign in for account management and analytics:

codex mcp login picsee

Claude Desktop or another MCP client

Add the following Streamable HTTP server to the client's MCP configuration:

{
  "mcpServers": {
    "picsee": {
      "url": "https://api.picsee.io/mcp"
    }
  }
}

If a client does not support remote Streamable HTTP directly, use an MCP remote bridge supported by that client.

Example prompts

Shorten https://picsee.io and attribute the API usage to Codex.

Show my 10 most recent PicSee short links.

Show daily clicks and referrer sources for short link abc123 over the last 30 days.

Change the destination of abc123 to https://example.com/new-page.

Editing requires an eligible PicSee API plan.

Authentication

PicSee uses OAuth 2.1 authorization code flow with PKCE and Dynamic Client Registration.

Authorization server: https://public-api-oauth.picsee.io
Protected resource: https://api.picsee.io/mcp
Scopes: user:read, user:write

The MCP client stores the access and refresh tokens. This repository does not ask users to paste API tokens into prompts or configuration files.

Why these scopes are requested

user:read: Read the account's API status, domains, tags, short-link list, and analytics.
user:write: Create, edit, delete, and recover short links when the account plan permits those actions.

Tool availability

Access level	Available tools
Anonymous	`create_short_link`
Signed in	`create_short_link`, `get_api_status`, `get_api_usage_by_external_id`, `get_my_domains`, `get_my_tags`, `get_my_tracking_tools`, `list_short_links`, `delete_short_link`, `get_link_overview`, `get_link_daily_clicks`, `get_link_platforms`, `get_link_referrers`, `get_link_regions`
Advanced plan	Signed-in tools plus `edit_short_link` and `get_link_audience_labels`; advanced fields and search filters are also enabled

Tool availability is determined at connection time. Use your MCP client's tool inspector or tools/list to see the exact tools available to the current account.

Privacy and security

Never share PicSee access tokens in prompts, issues, screenshots, or logs.
Review the destination URL before creating or editing a short link.
Analytics may contain private campaign and audience information; share it only with intended recipients.
OAuth permissions can be revoked from your PicSee account.

See PicSee Privacy Notice and Terms of Use.

Documentation and support

When reporting an issue, include the MCP client name, operation attempted, timestamp, and sanitized error message. Do not include access tokens or private analytics data.

Development

Prerequisites:

Node.js 22 or later
pnpm

pnpm install
pnpm check
pnpm dev

Before releasing, verify that the version in package.json, server.json, and the MCP initialize response is identical.

License

Comments

Markdown supported

New to MCP?

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

Read the getting-started guide

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.