@linktwin/mcp

The official Model Context Protocol (MCP) server for LinkTwin. Give Claude, Cursor and other AI agents the ability to create, edit and manage your short links and deep links — including geo/device/language targeting, A/B testing, UTM parameters, collections, branded domains, retargeting pixels, QR codes and click analytics.

Install

No global install needed — run it on demand with npx. Add to your MCP client:

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "your_api_key_here" }
    }
  }
}

Works with Claude Desktop, Claude Code, Cursor, Windsurf, Cline and any other MCP-compatible client.

Configuration

| Variable | Required | Default | Description | | --- | --- | --- | --- | | LINKTWIN_API_KEY | yes | — | Your API key from the LinkTwin Settings page | | LINKTWIN_BASE_URL | no | https://linktw.in | Site root (for self-hosted / custom domains) |

Tools

Links — create_link, list_links, get_link, update_link, delete_link, bulk_delete_links

Analytics — get_link_stats, get_dashboard_stats, get_detailed_stats, get_day_trend

Collections — list_collections, get_collection, create_collection, update_collection, add_links_to_collection, delete_collection

Domains — list_domains, add_domain, update_domain, delete_domain

Pixels — list_pixels, get_pixel, create_pixel, update_pixel, delete_pixel, assign_pixel_to_links

QR codes — list_qr_codes, get_qr_code, create_qr_code, update_qr_code, delete_qr_code

Account — get_account, update_account_settings, switch_workspace

Each tool is a thin wrapper over the LinkTwin REST API with a zod-validated input schema. Errors (auth, rate limits, plan limits, validation) are returned as tool results flagged isError, so agents can react gracefully.

License

MIT