create_link

Instructions

Implementation Reference

• src/index.ts:276-361 (handler)

  The handler function that implements the create_link tool logic: validates input, selects domain (user-specified or primary), constructs params, calls Dub.co API POST /links, handles errors, and returns the created short link details.

  private async createLink(args: any): Promise<any> {
    if (!args.url) {
      throw new McpError(
        ErrorCode.InvalidParams,
        'URL is required'
      );
    }
  
    try {
      // Determine which domain to use
      let domain: Domain;
      
      if (args.domain) {
        // If domain is specified, try to find it
        const foundDomain = await this.getDomainBySlug(args.domain);
        if (!foundDomain) {
          return {
            content: [
              {
                type: 'text',
                text: `Domain "${args.domain}" not found. Using primary domain instead.`,
              },
            ],
            isError: false,
          };
        }
        domain = foundDomain;
      } else {
        // Otherwise use the primary domain
        domain = await this.getPrimaryDomain();
      }
      
      // Create the link with the selected domain
      const createParams: CreateLinkParams = {
        url: args.url,
        domain: domain.slug,
      };
      
      if (args.key) {
        createParams.key = args.key;
      }
      
      if (args.externalId) {
        createParams.externalId = args.externalId;
      }
      
      const response = await this.axiosInstance.post('/links', createParams);
      const link = response.data;
      
      return {
        content: [
          {
            type: 'text',
            text: `Short link created: ${link.shortLink}\n\nDestination: ${link.url}\nID: ${link.id}`,
          },
        ],
      };
    } catch (error) {
      if (axios.isAxiosError(error)) {
        const axiosError = error as AxiosError<ApiErrorResponse>;
        const statusCode = axiosError.response?.status;
        const errorData = axiosError.response?.data;
        const errorMessage = errorData?.error || errorData?.message || axiosError.message;
        
        return {
          content: [
            {
              type: 'text',
              text: `Error creating link: ${statusCode} - ${errorMessage}`,
            },
          ],
          isError: true,
        };
      }
      
      return {
        content: [
          {
            type: 'text',
            text: `Error creating link: ${(error as Error).message}`,
          },
        ],
        isError: true,
      };
    }
  }

• src/index.ts:104-129 (registration)

  Tool registration in ListToolsRequestHandler, defining name, description, and inputSchema for create_link.

  {
    name: 'create_link',
    description: 'Create a new short link on dub.co, asking the user which domain to use',
    inputSchema: {
      type: 'object',
      properties: {
        url: {
          type: 'string',
          description: 'The destination URL to shorten',
        },
        key: {
          type: 'string',
          description: 'Optional custom slug for the short link. If not provided, a random slug will be generated.',
        },
        externalId: {
          type: 'string',
          description: 'Optional external ID for the link',
        },
        domain: {
          type: 'string',
          description: 'Optional domain slug to use. If not provided, the primary domain will be used.'
        }
      },
      required: ['url'],
    },
  },

• src/index.ts:45-51 (schema)

  TypeScript interface defining the parameters for creating a link, used in the handler.

  interface CreateLinkParams {
    url: string;
    domain?: string;
    key?: string;
    externalId?: string;
    // ... other optional parameters
  }

• src/index.ts:202-203 (handler)

  Dispatch case in CallToolRequestHandler that routes create_link calls to the createLink method.

  case 'create_link':
    return await this.createLink(request.params.arguments);

• src/index.ts:256-269 (helper)

  Helper method to retrieve the primary domain, used by createLink to select default domain.

  private async getPrimaryDomain(): Promise<Domain> {
    const domains = await this.getDomains();
    
    if (domains.length === 0) {
      throw new McpError(
        ErrorCode.InvalidRequest,
        'No domains available in your workspace'
      );
    }
    
    // Find the primary domain or use the first one
    const primaryDomain = domains.find(domain => domain.primary) || domains[0];
    return primaryDomain;
  }