@link.me/mcp 0.1.0

package/README.md

@@ -0,0 +1,214 @@
+# @link.me/mcp
+
+[Model Context Protocol](https://modelcontextprotocol.io) server for the [Linkme](https://link.me) platform. Gives AI agents like Claude, Cursor, and Windsurf programmatic access to your Linkme account.
+
+## Install
+
+```bash
+npm install -g @link.me/mcp
+```
+
+Pre-compiled binaries are provided for macOS (arm64, x64), Linux (x64, arm64), and Windows (x64). No runtime dependencies required.
+
+## Setup
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "linkme": {
+      "command": "linkme-mcp",
+      "env": {
+        "LINKME_TOKEN": "your-api-token"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add linkme linkme-mcp -e LINKME_TOKEN=your-api-token
+```
+
+### Cursor
+
+Add to your Cursor MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "linkme": {
+      "command": "linkme-mcp",
+      "env": {
+        "LINKME_TOKEN": "your-api-token"
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to your Windsurf MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "linkme": {
+      "command": "linkme-mcp",
+      "env": {
+        "LINKME_TOKEN": "your-api-token"
+      }
+    }
+  }
+}
+```
+
+## Authentication
+
+Set the `LINKME_TOKEN` environment variable with your API token. The MCP server uses this to authenticate all requests to the Linkme platform.
+
+You can obtain a token by logging in with the CLI:
+
+```bash
+npm install -g @link.me/cli
+linkme auth login
+linkme config show --json | jq -r '.token'
+```
+
+## Available Tools
+
+The MCP server exposes 100+ tools covering the full Linkme platform. All tools return structured JSON. Destructive operations (delete, cancel, reset) auto-confirm without prompting.
+
+### Profile & Identity
+
+| Tool | Description |
+|------|-------------|
+| `whoami` | Show current identity |
+| `profile` | View profile details |
+| `profile_edit` | Edit profile fields |
+| `profile_theme` | Update theme colors |
+| `profile_linkme-icon` | Toggle Linkme icon |
+| `profile_pixels` | Manage tracking pixels |
+| `profile_contact_list` | List contact info |
+| `profile_contact_set` | Set contact info |
+| `profile_contact_delete` | Delete contact info |
+| `profile_sections_list` | List profile sections |
+| `profile_sections_enable` | Enable a section |
+| `profile_sections_disable` | Disable a section |
+| `profile_sections_move` | Reorder a section |
+
+### Links
+
+| Tool | Description |
+|------|-------------|
+| `links_list` | List profile links |
+| `links_add` | Add a link |
+| `links_edit` | Edit a link |
+| `links_delete` | Delete a link |
+| `featured_list` | List featured links |
+| `featured_add` | Add a featured link |
+| `featured_edit` | Edit a featured link |
+| `featured_delete` | Delete a featured link |
+| `social_list` | List social links |
+| `social_set` | Set a social link |
+
+### AP (Post on All Platforms)
+
+| Tool | Description |
+|------|-------------|
+| `ap_accounts` | List connected accounts |
+| `ap_connect` | Connect a provider |
+| `ap_disconnect` | Disconnect a provider |
+| `ap_post_list` | List posts |
+| `ap_post_create` | Create a post |
+| `ap_post_status` | Check post status |
+| `ap_post_publish` | Publish a draft |
+| `ap_post_cancel` | Cancel a post |
+| `ap_post_retry` | Retry a failed post |
+| `ap_analytics` | Post analytics |
+| `ap_analytics_accounts` | Account-wide analytics |
+
+### Analytics
+
+| Tool | Description |
+|------|-------------|
+| `analytics_overview` | Aggregated analytics |
+| `analytics_visits` | Visit breakdown |
+| `analytics_links` | Per-link clicks |
+| `analytics_geo` | Geographic breakdown |
+| `analytics_realtime` | Real-time visitors |
+
+### Email
+
+| Tool | Description |
+|------|-------------|
+| `email_send` | Send a campaign |
+| `email_test` | Send a test email |
+| `email_history` | Campaign history |
+| `email_detail` | Campaign details |
+| `email_cancel` | Cancel a campaign |
+| `email_domains` | Sending domains |
+| `email_upload-image` | Upload an image |
+| `email_templates_list` | List templates |
+| `email_templates_create` | Create a template |
+| `email_templates_delete` | Delete a template |
+
+### Commerce & Shop
+
+| Tool | Description |
+|------|-------------|
+| `commerce_products_list` | List digital products |
+| `commerce_products_create` | Create a product |
+| `commerce_products_delete` | Delete a product |
+| `shop_products_list\|add\|edit\|delete` | Shop products |
+| `shop_categories_list\|add\|edit\|reorder\|delete` | Shop categories |
+
+### Other Tools
+
+| Tool | Description |
+|------|-------------|
+| `contacts_list` | List contacts |
+| `contacts_stats` | Contact analytics |
+| `gallery_list\|delete` | Gallery media |
+| `auth_login\|logout\|sessions\|switch` | Authentication |
+| `config_show\|set\|reset` | Configuration |
+| `automations_*` | Instagram automations (20+ tools) |
+| `courses_*` | Course management |
+| `feeds_*` | Feed subscriptions |
+| `reviews_*` | Review subscriptions |
+| `agency_*` | Agency management |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `LINKME_TOKEN` | Auth token (required) |
+| `LINKME_API_URL` | Override API base URL |
+| `LINKME_AUTH_URL` | Override auth service URL |
+| `LINKME_AP_URL` | Override AP service URL |
+
+## How It Works
+
+The MCP server uses stdio transport and exposes each CLI command as an MCP tool. Tool inputs are derived from the same Zod schemas used by the CLI. All tools run in JSON mode with color disabled, returning structured responses suitable for LLM consumption.
+
+Interactive commands (shell completion, video upload) are excluded from the MCP tool set.
+
+## CLI
+
+A full command-line interface is available as a separate package:
+
+```bash
+npm install -g @link.me/cli
+```
+
+See [@link.me/cli](https://www.npmjs.com/package/@link.me/cli) for documentation.
+
+## License
+
+UNLICENSED

package/package.json

@@ -0,0 +1,30 @@
+{
+	"name": "@link.me/mcp",
+	"version": "0.1.0",
+	"description": "Linkme platform MCP server for Claude, Cursor, and other AI agents",
+	"license": "UNLICENSED",
+	"bin": {
+		"linkme-mcp": "./run.js"
+	},
+	"files": [
+		"run.js"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/LinkMeGlobal/cli.git",
+		"directory": "bin/mcp"
+	},
+	"keywords": [
+		"linkme",
+		"mcp",
+		"model-context-protocol",
+		"ai"
+	],
+	"optionalDependencies": {
+		"@link.me/mcp-darwin-arm64": "0.1.0",
+		"@link.me/mcp-darwin-x64": "0.1.0",
+		"@link.me/mcp-linux-x64": "0.1.0",
+		"@link.me/mcp-linux-arm64": "0.1.0",
+		"@link.me/mcp-windows-x64": "0.1.0"
+	}
+}

package/run.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("node:child_process");
+const path = require("node:path");
+const os = require("node:os");
+
+const PLATFORMS = {
+	"darwin-arm64": "@link.me/mcp-darwin-arm64",
+	"darwin-x64": "@link.me/mcp-darwin-x64",
+	"linux-x64": "@link.me/mcp-linux-x64",
+	"linux-arm64": "@link.me/mcp-linux-arm64",
+	"win32-x64": "@link.me/mcp-windows-x64",
+};
+
+const key = `${os.platform()}-${os.arch()}`;
+const pkg = PLATFORMS[key];
+
+if (!pkg) {
+	console.error(
+		`@link.me/mcp: unsupported platform ${key}. Supported: ${Object.keys(PLATFORMS).join(", ")}`,
+	);
+	process.exit(1);
+}
+
+let binPath;
+try {
+	const pkgDir = path.dirname(require.resolve(`${pkg}/package.json`));
+	binPath = path.join(
+		pkgDir,
+		os.platform() === "win32" ? "linkme-mcp.exe" : "linkme-mcp",
+	);
+} catch {
+	console.error(
+		`@link.me/mcp: could not find ${pkg}. Try reinstalling with:\n  npm install @link.me/mcp`,
+	);
+	process.exit(1);
+}
+
+try {
+	execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (e) {
+	if (e.status !== undefined) process.exit(e.status);
+	throw e;
+}