missinglinkz

MissingLinkz

Campaign link builder for AI agents. Generate UTM-tracked links with enforced naming conventions. CLI + MCP server.

Install

npm install -g missinglinkz

Quick Start

# 1. Register for a free account (50 links/month)
mlz auth register --email [e-mail]

# 2. Build your first tracked link
mlz build --url "https://example.com/landing" --campaign "spring-launch" --source "linkedin" --medium "social"

# 3. Check your usage
mlz auth status

CLI Commands

Build a tracked link

mlz build \
  --url "https://example.com/landing" \
  --campaign "spring-launch" \
  --source "linkedin" \
  --medium "social" \
  --term "ai-tools" \
  --content "banner-a"

Returns structured JSON:

{
  "tracked_url": "https://example.com/landing?utm_source=linkedin&utm_medium=social&utm_campaign=spring-launch",
  "link_id": "lnk_abc12345",
  "campaign_id": "cmp_xyz78901",
  "params": {
    "utm_source": "linkedin",
    "utm_medium": "social",
    "utm_campaign": "spring-launch",
    "utm_term": "ai-tools",
    "utm_content": "banner-a"
  },
  "destination_url": "https://example.com/landing",
  "created_at": "2026-03-15T10:00:00.000Z"
}

Add --validate to check the destination URL before building:

mlz build --url "https://example.com" --campaign "test" --source "google" --medium "cpc" --validate

Validate a URL

mlz check https://example.com/landing

Checks URL format, HTTPS, resolution, redirect chains, and response time.

List campaigns

mlz campaigns list

Suggest consistent naming

mlz campaigns suggest --source linkedin
mlz campaigns suggest --medium email

List generated links

mlz links list
mlz links list --campaign "spring-launch" --limit 10

Authentication

# Register a new account
mlz auth register --email [e-mail]

# Log in with an existing key
mlz auth login --key mlz_live_...

# Check plan, usage, and limits
mlz auth status

Output format

All commands output JSON by default. Add --format human for readable output:

mlz build --url "..." --campaign "..." --source "..." --medium "..." --format human

MCP Server

MissingLinkz exposes all functionality as MCP tools. Start the server:

mlz mcp

Connect from Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "missinglinkz": {
      "command": "mlz",
      "args": ["mcp"],
      "env": {
        "MLZ_API_KEY": "mlz_live_..."
      }
    }
  }
}

MCP Tools

Tool	Description
mlz_build_link	Generate a UTM-tagged link (stores via API)
mlz_list_campaigns	List all campaigns
mlz_suggest_naming	Suggest consistent naming for sources/mediums
mlz_list_links	List recently generated links
mlz_check_usage	Check API usage and remaining quota
mlz_register	Register a new account (for agent self-registration)

Environment Variables

Variable	Required	Description
MLZ_API_KEY	Yes	Your MissingLinkz API key
MLZ_API_URL	No	Override API URL (default: https://api.missinglinkz.io)
MLZ_FORMAT	No	Default output format: json (default) or human

Config is stored in ~/.missinglinkz/config.json. Env vars take priority.

Naming Convention Enforcement

MissingLinkz automatically enforces clean UTM naming:

• Converts to lowercase
• Replaces spaces with hyphens
• Strips special characters
• Warns on inconsistencies with existing campaign names

"Spring Launch 2026" becomes "spring-launch-2026".

Pricing

Plan	Price	Links/month
Free	$0	50
Agent	$9/mo	2,000
Pro	$29/mo	20,000
Enterprise	$99/mo	Unlimited

Free tier requires no credit card. When limits are exceeded, the CLI returns a structured error with upgrade instructions that agents can present to users.

Agent Workflow Examples

Multi-platform campaign launch

# Build links for each platform
mlz build --url "https://example.com/launch" --campaign "product-launch" --source "linkedin" --medium "social"
mlz build --url "https://example.com/launch" --campaign "product-launch" --source "twitter" --medium "social"
mlz build --url "https://example.com/launch" --campaign "product-launch" --source "newsletter" --medium "email"
mlz build --url "https://example.com/launch" --campaign "product-launch" --source "google" --medium "cpc"

Check consistency before building

# See what sources have been used before
mlz campaigns suggest --source linked
# Returns: ["linkedin"] — use "linkedin" not "linked"

Offline mode

The mlz build command works without an API key for basic UTM generation. Links won't be stored or tracked, but the URL is still valid.

SKILL.md

This package includes a SKILL.md file for agent discovery via OpenClaw and Claude Code. It documents all commands and environment variables needed to use MissingLinkz.

License

MIT