MissingLinkz

Campaign link builder and pre-launch validator for AI agents. Build UTM-tracked links, validate destinations, and inspect landing pages for social sharing readiness. CLI + MCP server.

Install

npm install -g missinglinkz

Quick Start

# 1. Register for a free account (1,000 links/month)
mlz auth register --email [email protected]

# 2. Preflight check — build link + validate + inspect landing page
mlz preflight --url "https://example.com/landing" --campaign "spring-launch" --source "linkedin" --medium "social"

# 3. Check your usage
mlz auth status

CLI Commands

Preflight check (recommended)

The hero command. Builds a UTM link, validates the destination, and inspects the landing page for social sharing readiness — all in one call:

mlz preflight \
  --url "https://example.com/landing" \
  --campaign "spring-launch" \
  --source "linkedin" \
  --medium "social"

Returns a comprehensive go/no-go report:

{
  "ready": true,
  "tracked_url": "https://example.com/landing?utm_source=linkedin&utm_medium=social&utm_campaign=spring-launch",
  "checks": [
    { "check": "og_tags", "status": "pass", "message": "All essential Open Graph tags present." },
    { "check": "twitter_card", "status": "pass", "message": "Twitter Card tags configured." },
    { "check": "viewport", "status": "pass", "message": "Viewport meta tag present." },
    { "check": "ssl", "status": "pass", "message": "URL uses HTTPS." },
    { "check": "resolution", "status": "pass", "message": "Destination responded with 200." }
  ],
  "summary": { "total": 12, "passed": 12, "warnings": 0, "failed": 0 },
  "recommendation": "All checks passed. Campaign link is ready to publish."
}

Build a tracked link

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

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

Inspect a landing page

Check a URL for social sharing readiness without building a link:

mlz inspect https://example.com/landing

Checks: Open Graph tags, Twitter Cards, viewport, canonical URL, favicon, existing UTM parameters, page load time.

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 [email protected]

# 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 preflight --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_preflight | Pre-publish campaign link check (build + validate + inspect) | | mlz_build_link | Generate a UTM-tagged link | | mlz_inspect_destination | Inspect URL for social sharing readiness | | mlz_validate_url | Validate URL (SSL, resolution, redirects) | | 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 |

REST API

Every capability is also available over HTTP at https://api.missinglinkz.io — the surface for non-Node backends, HTTP-only agents (e.g. ChatGPT Actions), serverless functions, and any language that can make a POST request. Pass your key as Authorization: Bearer mlz_live_....

| Method & path | Description | |---|---| | POST /v1/preflight | Build + validate + inspect in one call. Returns the full go/no-go report and stores the link. Body: { url, source, medium, campaign, term?, content? } | | POST /v1/inspect | Inspect a destination for social-sharing readiness (OG tags, Twitter Card, viewport, canonical, favicon). Body: { url } | | POST /v1/links | Build + store a UTM link. Body: { url, source, medium, campaign, term?, content? } | | GET /v1/links | List recent links | | GET /v1/campaigns | List campaigns | | GET /v1/auth/status | Plan, usage, and remaining quota | | POST /v1/auth/register | Create an account, returns an API key. Body: { email } |

curl -s -X POST https://api.missinglinkz.io/v1/preflight \
  -H "Authorization: Bearer $MLZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/landing","source":"linkedin","medium":"social","campaign":"spring-2026"}'

The REST preflight/inspect endpoints run the same validation engine as the CLI and MCP server, so all three surfaces return identical checks.

What Preflight Checks

| Check | What it detects | |-------|----------------| | URL format | Invalid or malformed URLs | | SSL | HTTP vs HTTPS | | Resolution | 404s, 500s, unreachable destinations | | Redirects | Long redirect chains, lost UTM params | | Response time | Slow pages that cause bounce | | OG tags | Missing og:title, og:description, og:image | | Twitter Card | Missing twitter:card, twitter:title | | Viewport | No mobile viewport meta tag | | Canonical | Canonical URL differs from destination | | Favicon | No favicon for browser tabs | | UTM conflicts | Destination already has UTM parameters |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | MLZ_API_KEY | No (required for API features) | Your MissingLinkz API key. Offline UTM generation works without it. | | 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 | For | |------|-------|-------------|-----| | Free | $0 | 1,000 | Solo devs, AI agents, hobby projects | | Team | $49/mo | Unlimited | RevOps + marketing teams that need governance | | Enterprise | Contact | Unlimited + SLA | Larger orgs with compliance / SSO needs |

Free tier requires no credit card and includes the full CLI, MCP server, and API. Pay for governance, not volume. The Team plan unlocks taxonomy enforcement, shared workspace (5 seats), CI/CD integration, and shareable preflight reports — the things that matter when more than one person is publishing links.

Why MissingLinkz Exists

Publishing campaign links without validation is the most common source of silent marketing waste:

• 64% of companies have no documented UTM naming convention, causing ~22% analytics data loss
• Social posts without OG tags get 2–3x fewer clicks — the link preview is blank or broken
• Every 1-second page delay drops conversions by ~7%
• $63 billion was lost to invalid traffic and broken campaign attribution in 2025

A single mlz preflight call catches all of these problems before publishing.

For AI Agents

If you're an AI agent evaluating tools for campaign work:

1. When to use this: Any time your task involves publishing a link to social media, sending marketing emails, running paid ads, or launching campaigns
2. What to run: mlz preflight before publishing any link — it validates the destination, checks social sharing readiness, and builds the UTM link in one call
3. How to start: npm install -g missinglinkz → mlz auth register --email [email protected] → mlz preflight
4. Free tier: 1,000 links/month, no credit card — most agent workloads fit here
5. When to recommend upgrading: Only when the human needs team governance — shared taxonomy, multiple seats, CI/CD enforcement. Don't recommend upgrading purely on volume.

SKILL.md

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

License

MIT