Dub.co MCP Server

Instructions

Implementation Reference

• src/index.ts:427-512 (handler)

  The main handler function that implements the upsert_link tool logic, performing create-or-update of short links via Dub.co API.
  private async upsertLink(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(); } // Upsert the link with the selected domain const upsertParams: CreateLinkParams = { url: args.url, domain: domain.slug, }; if (args.key) { upsertParams.key = args.key; } if (args.externalId) { upsertParams.externalId = args.externalId; } const response = await this.axiosInstance.put('/links/upsert', upsertParams); const link = response.data; return { content: [ { type: 'text', text: `Short link upserted: ${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 upserting link: ${statusCode} - ${errorMessage}`, }, ], isError: true, }; } return { content: [ { type: 'text', text: `Error upserting link: ${(error as Error).message}`, }, ], isError: true, }; } }
• src/index.ts:157-181 (schema)

  Input schema and metadata definition for the upsert_link tool, registered in the ListTools response.
  name: 'upsert_link', description: 'Create or update a short link on dub.co, asking the user which domain to use if creating', 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:206-207 (registration)

  Dispatch case in the CallToolRequestSchema handler that routes upsert_link calls to the upsertLink method.
  case 'upsert_link': return await this.upsertLink(request.params.arguments);