Use gotomyn.com from your AI assistant

The gotomyn MCP server lets Claude Desktop, Cursor, and Windsurf create, manage, and analyze your short links without leaving your chat.

Requires an active gotomyn.com subscription and an API key. Get yours at /settings.

Installation

Prerequisites

Install the MCP server

Run the following command to start the MCP server:

npx @gotomyn/mcp-server

npx downloads and runs the latest version automatically — no global install needed.

Configure Claude Desktop

Edit your Claude Desktop config file.

Add the following configuration block:

{
  "mcpServers": {
    "gotomyn": {
      "command": "npx",
      "args": ["-y", "@gotomyn/mcp-server"],
      "env": {
        "GOTOMYN_API_KEY": "your_api_key_here"
      }
    }
  }
}

Replace your_api_key_here with your actual API key from /settings. Restart Claude Desktop after saving.

Configure Cursor / Windsurf

In Cursor: Settings → MCP → Add Server.
In Windsurf: Create or edit .windsurf/mcp.json in your project root. 

{
  "mcpServers": {
    "gotomyn": {
      "command": "npx",
      "args": ["-y", "@gotomyn/mcp-server"],
      "env": {
        "GOTOMYN_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

The gotomyn MCP server exposes 5 tools. Your AI assistant can invoke them naturally from conversation.

shorten_url write

Create a short link from a long URL. Optionally set a custom back-half.

Example: "Shorten https://example.com/my-very-long-url"
list_links read

List your recent short links with click counts.

Example: "List my last 10 links"
get_link read

Get details for a specific short link by its UID.

Example: "Get details for link abc123"
delete_link write

Delete a short link permanently.

Example: "Delete the link abc123"
get_link_analytics read

Get a 30-day analytics summary: total clicks, device breakdown, top countries, last 7 days.

Example: "How many clicks did abc123 get this month?"

Troubleshooting

Error Cause Fix
GOTOMYN_API_KEY environment variable is not set API key not configured in MCP client env block Add GOTOMYN_API_KEY to the env block in your config file
A gotomyn.com subscription is required User has no active paid plan (PLAN_REQUIRED) Upgrade at gotomyn.com/billing
Your API key lacks the required scope Key was created without the needed scope (read or write) Revoke the key and create a new one with the required scopes at /settings
Invalid or missing API key Key was revoked or contains a typo Generate a new API key at /settings
"MCP server disconnected" in Claude Desktop Server crashed or output was corrupted (stdout pollution) Check that Node.js v20+ is installed; reinstall with npm install -g @gotomyn/mcp-server
Link not found The uid does not exist or belongs to another account Double-check the uid by running list_links