PicSee Short Link

io.picseePublished by picsee.ioOfficial publisherv3.1.0Updated Oct 24, 2026

Official PicSee MCP server for short links, link management, click analytics, and optional OAuth.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & Analytics

Overview

AI-generated overview

Lets an assistant create PicSee short links and, when signed in, manage links and read click analytics.

What you can do
The official remote PicSee MCP server connects an AI agent to a URL shortener. Anonymous clients can create a short link on the shared pse.is domain. After signing in with PicSee OAuth, tools depend on the account's API plan and can include creating links on available or branded domains, listing, deleting or recovering links, checking API plan status and usage, listing domains, tags and tracking tools, and viewing overview, daily click, device, referrer and country analytics. Advanced-plan accounts also get link editing and audience-label tools.
When to use it
Useful when you want an assistant to shorten URLs, keep track of existing short links, or pull click performance data in natural language. Anonymous use is enough for simple link creation; sign-in is needed for account data, management and analytics.
Requirements
A remote Streamable HTTP endpoint at no local runtime or package is needed. Anonymous use requires no account. Signed-in features use OAuth 2.1 with PKCE and Dynamic Client Registration, with scopes user:read and user:write, and the MCP client stores the access and refresh tokens. Some tools require an eligible PicSee API plan.
Before you install
Signed-in access grants read and write scopes, so the assistant can create, edit, delete and recover short links and read analytics that may contain private campaign and audience information. Review destination URLs before creating or editing a link. Never share PicSee access tokens in prompts, issues, screenshots or logs; permissions can be revoked from the PicSee account.

Installation

In SourceWeft

  1. Open PicSee Short Link in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.picsee%2Fshort-link/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

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

text
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

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

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

bash
codex mcp login picsee

Claude Desktop or another MCP client

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

json
{  "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

text
Shorten https://picsee.io and attribute the API usage to Codex.
text
Show my 10 most recent PicSee short links.
text
Show daily clicks and referrer sources for short link abc123 over the last 30 days.
text
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 levelAvailable tools
Anonymouscreate_short_link
Signed increate_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 planSigned-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
bash
pnpm installpnpm checkpnpm dev

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

License

MIT © PicSee Inc.

Source: README.md at commit 1ba50a9

Tools

1

Version history

1
  1. v3.1.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts