figmanage 0.1.2 → 0.2.1

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server for managing your Figma workspace.
 
-Manages Figma workspaces through AI assistants. 76 tools covering files, projects, teams, permissions, comments, versions, components, webhooks, org admin, and more. Works with Claude Code, Claude Desktop, ChatGPT, and any MCP-compatible client.
+Manages Figma workspaces through AI assistants. 79 tools covering files, projects, teams, permissions, comments, versions, components, webhooks, org admin, and more. Works with Claude Code, Claude Desktop, ChatGPT, and any MCP-compatible client.
 
 ## quick start
 
@@ -16,19 +16,25 @@ claude mcp add figmanage -s user -e FIGMA_PAT=figd_xxx -- npx -y figmanage
 
 Restart Claude Code. Gives you 30+ tools (comments, reading, export, components, versions, webhooks).
 
-### full setup (2 minutes, all 76 tools)
+### full setup (2 minutes, all 79 tools)
 
 ```bash
 npx -y figmanage --setup
 ```
 
-Extracts your Chrome cookie, prompts for a PAT, registers with Claude Code automatically. Unlocks all 76 tools including workspace management, permissions, and org admin. Restart Claude Code.
+Extracts your Chrome cookie, prompts for a PAT, registers with Claude Code automatically. Unlocks all 79 tools including workspace management, permissions, and org admin. Restart Claude Code.
 
 Use `--no-prompt --pat figd_xxx` for non-interactive setup.
 
-### Claude Desktop
+### Claude Desktop / Cowork
 
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+Full setup with cookie extraction:
+
+```bash
+npx -y figmanage --setup --desktop
+```
+
+Or manually add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 ```json
 {
@@ -223,7 +229,7 @@ Tools are automatically filtered at startup based on available credentials. If y
 | `library_usage` | cookie | Team-level library adoption metrics over a lookback period |
 | `component_usage` | cookie | Per-file component usage analytics |
 
-### org (9 tools)
+### org (12 tools)
 
 | Tool | Auth | Description |
 |------|------|-------------|
@@ -231,6 +237,9 @@ Tools are automatically filtered at startup based on available credentials. If y
 | `list_org_teams` | cookie | All teams with member counts, project counts, access levels |
 | `seat_usage` | cookie | Seat breakdown: permissions, seat types, activity, account types |
 | `list_team_members` | cookie | Team members with name, email, role, last active date |
+| `list_org_members` | cookie | List org members with seat type, permission, email, last active |
+| `contract_rates` | cookie | Seat pricing per product (expert, developer, collaborator) |
+| `change_seat` | cookie | Change a user's seat type (confirm flag required for upgrades) |
 | `billing_overview` | cookie | Invoice history, billing status, amounts, billing periods |
 | `list_invoices` | cookie | Open and upcoming invoices |
 | `org_domains` | cookie | Domain configuration and SSO/SAML settings |

package/dist/setup.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { execSync, execFileSync } from 'child_process';
 import { createDecipheriv, pbkdf2Sync } from 'crypto';
-import { copyFileSync, unlinkSync, mkdtempSync, existsSync, rmdirSync, readFileSync } from 'fs';
+import { copyFileSync, unlinkSync, mkdtempSync, mkdirSync, existsSync, rmdirSync, readFileSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { tmpdir, homedir, platform } from 'os';
 import axios from 'axios';
@@ -294,8 +294,32 @@ function registerWithClaude(envVars) {
         return false;
     }
 }
+function registerWithDesktop(envVars) {
+    const configPath = platform() === 'win32'
+        ? join(process.env.APPDATA || join(homedir(), 'AppData/Roaming'), 'Claude/claude_desktop_config.json')
+        : join(homedir(), 'Library/Application Support/Claude/claude_desktop_config.json');
+    try {
+        let config = {};
+        if (existsSync(configPath)) {
+            config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        }
+        if (!config.mcpServers)
+            config.mcpServers = {};
+        config.mcpServers.figmanage = {
+            command: 'npx',
+            args: ['-y', 'figmanage'],
+            env: envVars,
+        };
+        mkdirSync(join(configPath, '..'), { recursive: true });
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function printManualConfig(envVars) {
-    console.log('\nClaude CLI not found. Configure your MCP client manually.\n');
+    console.log('\nConfigure your MCP client manually.\n');
     console.log('Environment variables:');
     for (const [k, v] of Object.entries(envVars)) {
         const display = (k === 'FIGMA_AUTH_COOKIE' || k === 'FIGMA_PAT') ? '******' : v;
@@ -315,21 +339,25 @@ function printManualConfig(envVars) {
 function parseArgs() {
     const args = process.argv.slice(2);
     let noPrompt = false;
+    let desktop = false;
     let pat;
     for (let i = 0; i < args.length; i++) {
         if (args[i] === '--no-prompt') {
             noPrompt = true;
         }
+        else if (args[i] === '--desktop') {
+            desktop = true;
+        }
         else if (args[i] === '--pat' && i + 1 < args.length) {
             pat = args[++i];
         }
     }
-    return { noPrompt, pat };
+    return { noPrompt, desktop, pat };
 }
 // --- Main ---
 async function setup() {
     console.log('figmanage setup\n');
-    const { noPrompt, pat: patArg } = parseArgs();
+    const { noPrompt, desktop, pat: patArg } = parseArgs();
     const os = platform();
     // Build env vars to register
     const envVars = {};
@@ -351,8 +379,18 @@ async function setup() {
             process.exit(1);
         }
         // Register with whatever client is available
-        if (claudeCliAvailable()) {
-            console.log('\nRegistering with Claude...');
+        if (desktop) {
+            console.log('\nRegistering with Claude Desktop...');
+            if (registerWithDesktop(envVars)) {
+                console.log('  Credentials written to claude_desktop_config.json');
+                console.log('  Done. Restart Claude Desktop to use figmanage.');
+            }
+            else {
+                printManualConfig(envVars);
+            }
+        }
+        else if (claudeCliAvailable()) {
+            console.log('\nRegistering with Claude Code...');
             if (registerWithClaude(envVars)) {
                 console.log('  PAT stored in MCP server config');
                 console.log('  Done. Restart Claude Code to use figmanage.');
@@ -542,8 +580,19 @@ async function setup() {
         console.log(`FIGMA_ORG_ID=${orgId}`);
     if (pat)
         console.log('FIGMA_PAT=****** (stored in MCP server config)');
-    if (claudeCliAvailable()) {
-        console.log('\nRegistering with Claude...');
+    if (desktop) {
+        console.log('\nRegistering with Claude Desktop...');
+        if (registerWithDesktop(envVars)) {
+            console.log('  Credentials written to claude_desktop_config.json');
+            console.log('  Done. Restart Claude Desktop to use figmanage.');
+        }
+        else {
+            console.log('  Could not write config automatically.');
+            printManualConfig(envVars);
+        }
+    }
+    else if (claudeCliAvailable()) {
+        console.log('\nRegistering with Claude Code...');
         if (registerWithClaude(envVars)) {
             if (pat)
                 console.log('  PAT stored in MCP server config');

package/dist/tools/org.js

@@ -308,4 +308,175 @@ defineTool({
         });
     },
 });
+// -- list_org_members --
+defineTool({
+    toolset: 'org',
+    auth: 'cookie',
+    register(server, config) {
+        server.registerTool('list_org_members', {
+            description: 'List org members with seat type, permission, email, and last active date. Use to resolve org_user_ids for change_seat.',
+            inputSchema: {
+                org_id: figmaId.optional().describe('Org ID override (defaults to current workspace)'),
+                search_query: z.string().optional().describe('Filter members by name or email'),
+            },
+        }, async ({ org_id, search_query }) => {
+            try {
+                let orgId;
+                try {
+                    orgId = requireOrgId(config, org_id);
+                }
+                catch (e) {
+                    return toolError(e.message);
+                }
+                const params = {};
+                if (search_query)
+                    params.search_query = search_query;
+                const res = await internalClient(config).get(`/api/v2/orgs/${orgId}/org_users`, { params });
+                const members = (res.data?.meta || res.data || []).map((m) => ({
+                    org_user_id: String(m.id),
+                    user_id: m.user_id,
+                    email: m.user?.email,
+                    name: m.user?.handle,
+                    permission: m.permission,
+                    seat_type: m.active_seat_type?.key || null,
+                    last_active: m.last_active,
+                }));
+                return toolResult(JSON.stringify(members, null, 2));
+            }
+            catch (e) {
+                return toolError(`Failed to list org members: ${e.response?.status || e.message}`);
+            }
+        });
+    },
+});
+// -- contract_rates --
+defineTool({
+    toolset: 'org',
+    auth: 'cookie',
+    register(server, config) {
+        server.registerTool('contract_rates', {
+            description: 'Seat pricing for the org. Returns monthly cost per seat type (expert, developer, collaborator).',
+            inputSchema: {
+                org_id: figmaId.optional().describe('Org ID override (defaults to current workspace)'),
+            },
+        }, async ({ org_id }) => {
+            try {
+                let orgId;
+                try {
+                    orgId = requireOrgId(config, org_id);
+                }
+                catch (e) {
+                    return toolError(e.message);
+                }
+                const res = await internalClient(config).get(`/api/pricing/contract_rates`, { params: { plan_parent_id: orgId, plan_type: 'organization' } });
+                const seatProducts = new Set(['expert', 'developer', 'collaborator']);
+                const prices = res.data?.meta?.product_prices || [];
+                const rates = prices
+                    .filter((r) => seatProducts.has(r.billable_product_key))
+                    .map((r) => ({
+                    product: r.billable_product_key,
+                    monthly_cents: r.amount,
+                    monthly_dollars: (r.amount / 100).toFixed(2),
+                }));
+                return toolResult(JSON.stringify(rates, null, 2));
+            }
+            catch (e) {
+                return toolError(`Failed to fetch contract rates: ${e.response?.status || e.message}`);
+            }
+        });
+    },
+});
+// -- change_seat --
+const SEAT_HIERARCHY = {
+    view: 0,
+    collab: 1,
+    dev: 2,
+    full: 3,
+};
+const SEAT_LABELS = {
+    view: 'Viewer (free)',
+    collab: 'Collaborator ($5/mo)',
+    dev: 'Developer ($25/mo)',
+    full: 'Full ($55/mo)',
+};
+const PAID_STATUSES = {
+    full: { expert: 'full' },
+    dev: { developer: 'full' },
+    collab: { collaborator: 'full' },
+    view: { collaborator: 'starter', developer: 'starter', expert: 'starter' },
+};
+const SEAT_KEY_TO_TYPE = {
+    expert: 'full',
+    developer: 'dev',
+    collaborator: 'collab',
+};
+defineTool({
+    toolset: 'org',
+    auth: 'cookie',
+    mutates: true,
+    destructive: true,
+    register(server, config) {
+        server.registerTool('change_seat', {
+            description: 'Change a user\'s seat type. Accepts user_id or email to identify the user. Upgrades affect billing.',
+            inputSchema: {
+                user_id: z.string().describe('User ID or email address of the target user'),
+                seat_type: z.enum(['full', 'dev', 'collab', 'view']).describe('Target seat type'),
+                org_id: figmaId.optional().describe('Org ID override (defaults to current workspace)'),
+                confirm: z.boolean().optional().describe('Required when upgrading to a higher/paid seat. Set to true to authorize the billing change.'),
+            },
+        }, async ({ user_id, seat_type, org_id, confirm }) => {
+            try {
+                let orgId;
+                try {
+                    orgId = requireOrgId(config, org_id);
+                }
+                catch (e) {
+                    return toolError(e.message);
+                }
+                const res = await internalClient(config).get(`/api/v2/orgs/${orgId}/org_users`, {
+                    params: user_id.includes('@') ? { search_query: user_id } : {},
+                });
+                const members = res.data?.meta || res.data || [];
+                const member = members.find((m) => user_id.includes('@')
+                    ? m.user?.email === user_id
+                    : String(m.user_id) === String(user_id));
+                if (!member)
+                    return toolError(`User not found: ${user_id}`);
+                if (String(member.user_id) === String(config.userId)) {
+                    return toolError('Cannot change your own seat type. Use the Figma admin panel.');
+                }
+                const currentKey = member.active_seat_type?.key || null;
+                const currentType = currentKey ? (SEAT_KEY_TO_TYPE[currentKey] || 'view') : 'view';
+                if (currentType === seat_type) {
+                    return toolResult(`Already on ${SEAT_LABELS[seat_type]} seat. No change needed.`);
+                }
+                const isUpgrade = (SEAT_HIERARCHY[seat_type] ?? 0) > (SEAT_HIERARCHY[currentType] ?? 0);
+                if (isUpgrade && !confirm) {
+                    return toolError(`Upgrading from ${SEAT_LABELS[currentType]} to ${SEAT_LABELS[seat_type]} will increase billing. ` +
+                        `Set confirm: true to authorize.`);
+                }
+                await internalClient(config).put(`/api/orgs/${orgId}/org_users`, {
+                    org_user_ids: [String(member.id)],
+                    paid_statuses: PAID_STATUSES[seat_type],
+                    entry_point: 'members_tab',
+                    seat_increase_authorized: 'true',
+                    seat_swap_intended: 'false',
+                    latest_ou_update: member.updated_at,
+                    showing_billing_groups: 'true',
+                }, {
+                    'axios-retry': { retries: 0 },
+                });
+                return toolResult(JSON.stringify({
+                    user: member.user?.handle || member.user?.email,
+                    email: member.user?.email,
+                    old_seat: SEAT_LABELS[currentType],
+                    new_seat: SEAT_LABELS[seat_type],
+                }, null, 2));
+            }
+            catch (e) {
+                return toolError(`Failed to change seat: ${e.response?.status || e.message}`);
+            }
+        });
+    },
+});
 //# sourceMappingURL=org.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "figmanage",
   "mcpName": "io.github.dannykeane/figmanage",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "MCP server for managing your Figma workspace from the terminal.",
   "type": "module",
   "main": "dist/index.js",