LotsLink

Free, unlimited short links, QR codes and click analytics your AI agent can create and track.

Hosted MCP Server

npx add-mcp 'https://api.lots.link/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Connect your AI agent to LotsLink.

Give Claude, ChatGPT, Codex, Cursor or another MCP agent access to your short links, QR codes, custom domains, workspaces and click analytics. Use the REST API for your own integrations. Your agent for speed, the dashboard for control.

MCP server URL

https://api.lots.link/mcp

Remote MCP with OAuth: sign in with your Lots account, no key needed.

What your agent can do

Your agent creates and edits links, makes QR codes, sets up domains and reads your click analytics. Ask in plain words:

“Make a QR code for the spring-sale link so I can print it on the flyer.”

“Which of my links got the most clicks this week, and from which countries?”

Links and domains

Custom slugs, UTM parameters, expiry dates, projects, bulk on or off and a QR code for any link, on lots.link or your own verified domain.

Click analytics

Recorded clicks by link or workspace, with source, device and location when available, and CSV or JSON export.

Every change in your dashboard

Your agent works in your workspaces with your role. Members edit their own links; viewers read.

Set up your agent

Works in any agent that supports remote MCP. The server URL is https://api.lots.link/mcp.

Claude (claude.ai and desktop app)

  1. 1 Open Customize, then Connectors.
  2. 2 Select + Add, then Add custom connector.
  3. Name it LotsLink, paste the MCP URL and select Add.
    https://api.lots.link/mcp
    
  4. 4
  5. 5 In a chat, turn LotsLink on from the + menu under Connectors.

Team and Enterprise: an owner adds it once under Organization settings, then Connectors (Add, Custom, Web). Members then connect it from Customize, then Connectors.

ChatGPT (web)

Works on ChatGPT plans that support custom MCP servers (developer mode). OpenAI offers full MCP, read and write, on Business, Enterprise and Edu; other plans may be limited to read-only tools.

  1. 1 Turn on developer mode: ChatGPT Settings > Security and login (on Business, Enterprise or Edu: Settings > Apps > Advanced settings). On Business, only admins and owners can turn it on.
  2. Go to Plugins, select +, then Add custom MCP server. Name it LotsLink, enter the server URL, choose OAuth, confirm the warning, then Create.
    https://api.lots.link/mcp
    
  3. 3 Install it and sign in with your Lots account, then in a new chat select it from + > More and ask.

Workspace admins can also add it under Workspace settings > Apps > Create.

Claude Code

  1. Add the server.
    claude mcp add --transport http lots-link https://api.lots.link/mcp
    
  2. Start Claude Code and run /mcp.
    /mcp
    
  3. 3 Select lots-link, choose Authenticate and allow access in the browser.

Codex CLI

  1. Add the server.
    codex mcp add lots-link --url https://api.lots.link/mcp
    
  2. Sign in and finish in the browser.
    codex mcp login lots-link
    
  3. Check that it is connected.
    codex mcp list
    

Cursor

  1. Add LotsLink to ~/.cursor/mcp.json, or to the project’s.cursor/mcp.json.
    {
      "mcpServers": {
        "lots-link": {
          "url": "https://api.lots.link/mcp"
        }
      }
    }
    
  2. 2 Cursor asks you to sign in with your Lots account the first time it connects.

Other agents that support remote MCP: add the same URL as a remote server and sign in when asked.

Cloud agents without MCP

  1. Create an API key.
    https://www.lotstech.com/mcp/lots-link
    
  2. Give the agent the REST docs and the agent skill.
    https://api.lots.link/docs.md
    https://lots.link/skill.md
    
  3. 3 The agent calls the REST API with the header Authorization: Bearer <key>.

34 tools on the MCP server

The same tools power the REST API, so your agent and your dashboard always see the same links.

lotslink_add_custom_domain

Add your own custom domain, or your free *.lots.link subdomain, to a workspace.

lotslink_archive_project

Archive a project (soft delete).

lotslink_bulk_activate_links

Activate multiple links at once.

lotslink_bulk_deactivate_links

Deactivate multiple links at once.

lotslink_bulk_delete_links

Permanently delete multiple links at once.

lotslink_create_checkout

Create a checkout link.

lotslink_create_link

Create a short link on lots.link, your free *.lots.link subdomain or a verified custom domain in the workspace, with an optional custom slug, project, tags, expiry and UTM parameters.

lotslink_create_project

Create a new project for organizing links within a workspace.

lotslink_create_qr_code

Make a QR code (PNG) for a link's short URL and return its image URL (qr_code_url), ready to download, print or share.

lotslink_create_workspace

Create a workspace (personal or team) to organize links and work with teammates.

lotslink_delete_custom_domain

Permanently delete a custom domain from the workspace.

lotslink_delete_link

Permanently delete a link.

lotslink_delete_project

Permanently delete a project from the workspace.

lotslink_delete_workspace

Permanently delete a workspace.

lotslink_export_analytics

Export analytics for a workspace, or one link with link_id, as CSV or JSON.

lotslink_get_billing

Show how the caller's LotsLink custom domains are paid for: the plan (if any), whether today is covered or paid from credits, the credit balance, and the plans.

lotslink_get_click_details

Individual click records for a short link (time, approximate location, device, referrer), with filters and pagination.

lotslink_get_custom_domain

Get detailed information about a specific custom domain including verification status, SSL certificate status, DNS records required for setup, nameservers, verification timestamps, and count of links using this domain.

lotslink_get_link

Get one link with its metadata, UTM parameters, project, tags, custom domain, click count and qr_code_url (empty until lotslink_create_qr_code or the dashboard makes one).

lotslink_get_link_analytics

Click analytics for one short link: all-time total, clicks in the period, average per day, peak day, daily timeline, top countries and cities, devices and referrers.

lotslink_get_project

Get detailed information about a specific project including the count of links assigned to it.

lotslink_get_workspace

Get detailed information about a specific workspace.

lotslink_get_workspace_analytics

Click analytics for a whole workspace.

lotslink_invite_workspace_member

Invite someone to a workspace by email.

lotslink_list_custom_domains

List all custom domains and subdomains for a workspace.

lotslink_list_links

List links in a workspace with filters (project, status active/inactive/expired, date range), search by URL or slug, sorting and pagination.

lotslink_list_projects

List all projects in a workspace with link counts.

lotslink_list_workspaces

List all workspaces where user is an active member.

lotslink_remove_workspace_member

Remove a member from workspace.

lotslink_update_custom_domain

Update settings for a custom domain.

lotslink_update_link

Update link properties including custom slug, expiration date, active status, or project assignment.

lotslink_update_project

Update project details including name, description, color, or client information.

lotslink_update_workspace

Update workspace name, description, or settings.

lotslink_verify_custom_domain

Trigger DNS verification for a custom domain.

REST API

Building your own integration, or running a cloud agent without MCP? Call the REST API at https://api.lots.link with an API key.