AI Access

Connect Claude, Cursor, Windsurf, or any MCP client to manage WarpLink links from your editor.

WarpLink provides an MCP server for managing links, apps, API keys, domains, and usage from AI tools like Claude Desktop, Cursor, and Windsurf. It uses your existing API key, is free on all plans, and shares the same 60 requests/minute rate limit as the REST API.

Prerequisites

You need a WarpLink API key with the appropriate scopes. For full access, create a key with these scopes:

links:read and links:write (create, list, update, delete links)
apps:read and apps:write (manage registered apps)
analytics:read (view click analytics)
keys:read and keys:write (list, create, revoke API keys)
domains:read and domains:write (manage custom domains)
org:read (view organization info and usage)

To create a key, go to Settings > API Keys in the dashboard, or see the Authentication docs.

MCP Server

The WarpLink MCP server exposes 19 tools over the Model Context Protocol. Any MCP-compatible client can connect to it.

Configuration

Add this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "warplink": {
      "url": "https://api.warplink.app/api/mcp",
      "headers": {
        "Authorization": "Bearer wl_live_YOUR_KEY"
      }
    }
  }
}

Restart Claude Desktop after saving.

Add this to your Cursor MCP config (.cursor/mcp.json in your project root or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "warplink": {
      "url": "https://api.warplink.app/api/mcp",
      "headers": {
        "Authorization": "Bearer wl_live_YOUR_KEY"
      }
    }
  }
}

Reload Cursor after saving.

Add this to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "warplink": {
      "url": "https://api.warplink.app/api/mcp",
      "headers": {
        "Authorization": "Bearer wl_live_YOUR_KEY"
      }
    }
  }
}

Reload Windsurf after saving.

Replace wl_live_YOUR_KEY with your actual API key. The same key works across all MCP clients.

Available Tools

Links

Tool	Description	Required Scopes
`create_link`	Create a new deep link	`links:write`
`list_links`	List links with filtering and pagination	`links:read`
`get_link`	Get a single link by ID	`links:read`
`update_link`	Update an existing link	`links:write`
`delete_link`	Deactivate a link	`links:write`
`get_link_analytics`	Get click analytics for a link	`links:read`
`resolve_link`	Debug a link by slug: see routing and status	`links:read`

Apps

Tool	Description	Required Scopes
`list_apps`	List registered apps with pagination	`apps:read`
`get_app`	Get a single app by ID	`apps:read`
`create_app`	Register a new app (iOS, Android, or both)	`apps:write`
`update_app`	Update an app's configuration	`apps:write`
`delete_app`	Delete a registered app	`apps:write`

API Keys

Tool	Description	Required Scopes
`list_keys`	List API keys for the organization	`keys:read`
`create_key`	Create a new API key (raw key returned once)	`keys:write`
`revoke_key`	Revoke an API key	`keys:write`

Custom Domains

Tool	Description	Required Scopes
`list_domains`	List custom domains with pagination	`domains:read`
`add_domain`	Add a custom domain for branded links	`domains:write`
`get_domain_status`	Check verification and SSL status	`domains:read`

Organization

Tool	Description	Required Scopes
`get_org_info`	Get org info, plan, and usage stats	`org:read`

Example Prompts

Once connected, you can use natural language in your MCP client:

"Create a WarpLink for https://example.com/promo with the tag summer-sale"
"Show me my last 10 links"
"How many clicks did my link abc123 get in the past 30 days?"
"Update the destination URL of link xyz to https://example.com/new-page"
"Register a new iOS app with bundle ID com.example.myapp"
"What's my current plan and how much of my click quota have I used?"
"Add links.mybrand.com as a custom domain"
"Create a new API key called 'CI Pipeline' with links:read and links:write scopes"
"Debug the link at aplnk.to/promo and show me its routing"

Next Steps

API Reference for the complete endpoint documentation
Authentication for API key scopes and security best practices
Quickstart to create your first deep link

AI Access

On this page