figmanage 0.1.2 → 0.2.0

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,13 +16,13 @@ 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.
 
@@ -223,7 +223,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 +231,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/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.0",
   "description": "MCP server for managing your Figma workspace from the terminal.",
   "type": "module",
   "main": "dist/index.js",