MCP server

For AI agents that hate tracking params too.

Linkshort exposes the same engine as a Model Context Protocol server. Wire it into Claude Desktop, Cursor, or any MCP-aware client. The HTTP transport runs on Appwrite Sites; the stdio transport runs locally.

Hosted (Streamable HTTP)

{
  "mcpServers": {
    "linkshort": {
      "type": "http",
      "url": "https://shortlinks.bhaumicsingh.tech/api/mcp",
      "headers": { "x-api-key": "optional-linkshort-api-key" }
    }
  }
}

Local (stdio)

# Run from a clone of the repo
LINKSHORT_API_KEY=optional-linkshort-api-key bun run mcp:stdio

LINKSHORT_API_KEY identifies a Linkshort client for rate limiting. Do not use your Appwrite server API key here.

Tools

create_short_link

Creates a short link from any URL. Strips tracking params before storing. Subject to the 2/second rate limit.

clean_url

Returns the cleaned URL plus detected platform metadata. Does not create a short link.

get_link_info

Looks up metadata for an existing slug.