Skip to main content

ULink MCP Server

Connect your ULink deep linking projects to Claude Code, Cursor, Windsurf, and other AI assistants.

The Model Context Protocol (MCP) standardizes how Large Language Models talk to external services like ULink. It connects AI assistants directly with your ULink account and allows them to manage projects, create smart links, configure domains, and more.

1

Install the MCP server

Choose your MCP client and follow the instructions to connect ULink.

MCP Client
Terminal
claude mcp add ulink -- npx -y @ulinkly/mcp-server@latest
2

Authenticate

Your MCP client will automatically open a browser window for authentication on first use. Log in with your ULink account and authorize the MCP server. The session persists and tokens refresh automatically.

API Key (alternative) — For CI environments or headless servers, you can use an API key instead of the browser flow. Generate one from the ULink dashboard under Project Settings > API Keys.
Terminal
claude mcp add ulink -e ULINK_API_KEY=your-api-key -- npx -y @ulinkly/mcp-server@latest
3

Start building

Once connected, your AI assistant can manage your ULink projects directly. Try asking it to:

  • "List my ULink projects"
  • "Create a new smart link for my app"
  • "Show click analytics for my latest link"
  • "Add a custom domain to my project"

Available tools

The following tools are available to the LLM when connected via MCP.

Project Management

  • list_projects — List all projects owned by or shared with you
  • get_project — Get detailed project information and configuration
  • create_project — Create a new project with name and fallback URL
  • update_project — Update project name or default URL
  • configure_project — Set platform config (iOS bundle ID, Android package, etc.)

Link Management

  • create_link — Create a smart link with platform-specific URLs and metadata
  • list_links — List all links in a project with pagination
  • get_link — Get detailed link information
  • update_link — Update a link's URLs, parameters, or metadata
  • delete_link — Permanently delete a link
  • get_link_analytics — Get click analytics with platform and country breakdowns

Domain Management

  • list_domains — List all domains associated with a project
  • add_domain — Add a custom domain (requires DNS config)
  • verify_domain — Trigger DNS verification for a custom domain
  • delete_domain — Remove a custom domain from a project

API Keys

  • list_api_keys — List all API keys for a project
  • create_api_key — Create a new API key (shown only once)
  • revoke_api_key — Permanently revoke an API key

Account & Billing

  • get_subscription — Get a project's plan, status, and renewal date
  • list_plans — List available plans with pricing and limits
  • get_usage — Get a project's usage stats for the current billing period

Environment variables

VariableDefaultDescription
ULINK_API_KEY—API key for authentication (skips browser OAuth flow)

Requirements

  • Node.js 18 or later

Resources