@flowrelay/mcp-server 1.0.2 → 1.0.4

package/README.md

@@ -9,7 +9,7 @@ It connects to Flow Relay API v1 using an API key and supports:
 ## Package
 
 - Name: @flowrelay/mcp-server
-- Version: 1.0.0
+- Version: 1.0.4
 
 ## What Is Included
 
@@ -18,12 +18,14 @@ The server currently exposes these tools:
 - get_workspace_context
 - list_projects
 - set_active_project
-- list_filter_options (lists the selectable resources, branches, event types and priorities per source for a project – call this before generating so handoff/insight filters use real values instead of guesses)
+- list_filter_options (lists the selectable resources, branches, event types and priorities per source for a project – call this before generating so handoff/insight filters use real values instead of guesses; also reports whether Figma is selectable, since Figma requires the project's processing region to be Global)
 - list_handoffs (returns project-specific handoffs, or an aggregated view of all accessible project handoffs if no project is active; filter by status: active, archived, or all)
 - generate_handoff (processed asynchronously, and the server automatically polls until the job finishes. Requires active project or project_id. Accepts per-source filters: projects, eventTypes, branches, priorities.)
 - generate_correlation_insight (accepts per-source filters)
 - generate_onboarding_brief (accepts per-source filters)
 - generate_architecture_insight (accepts per-source filters)
+
+Selecting Figma in `sources` or `filters` attaches visual context to the generation (rendered frame previews plus the indexed design scene: layout, texts, prototype flows). It works on projects whose processing region is Global and adds a flat 1-credit surcharge per generation.
 - list_insights
 - list_integrations
 - list_events

package/dist/api.d.ts

@@ -126,6 +126,13 @@ export interface AvailableSourceFilter {
     }[];
 }
 export type AvailableFilters = Record<string, AvailableSourceFilter>;
+export interface FigmaGateInfo {
+    selectable: boolean;
+    region: string;
+    scope: string;
+    canManageResidency: boolean;
+    residencyHref: string | null;
+}
 export declare class FlowRelayAPI {
     private baseUrl;
     private apiKey;
@@ -133,7 +140,10 @@ export declare class FlowRelayAPI {
     private requestRaw;
     private request;
     listProjects(): Promise<TenantContext>;
-    getHandoffFilters(projectId: string): Promise<AvailableFilters>;
+    getHandoffFilters(projectId: string): Promise<{
+        filters: AvailableFilters;
+        figma: FigmaGateInfo | null;
+    }>;
     listHandoffs(status?: string, limit?: number, projectId?: string | null): Promise<{
         handoffs: HandoffResult[];
     }>;

package/dist/api.js

@@ -35,8 +35,8 @@ export class FlowRelayAPI {
         return this.request('/projects');
     }
     async getHandoffFilters(projectId) {
-        const { filters } = await this.request(`/handoffs/filters?project_id=${encodeURIComponent(projectId)}`);
-        return filters ?? {};
+        const { filters, figma } = await this.request(`/handoffs/filters?project_id=${encodeURIComponent(projectId)}`);
+        return { filters: filters ?? {}, figma: figma ?? null };
     }
     async listHandoffs(status = 'active', limit = 10, projectId) {
         const params = new URLSearchParams();

package/dist/index.js

@@ -3,6 +3,8 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import { FlowRelayAPI } from './api.js';
+import { createRequire } from 'node:module';
+const { version: PKG_VERSION } = createRequire(import.meta.url)('../package.json');
 const SOURCES = [
     'github',
     'slack',
@@ -59,7 +61,7 @@ const api = new FlowRelayAPI(apiKey, process.env.FLOWRELAY_BASE_URL);
 let activeProjectId = normalizeProjectId(process.env.FLOWRELAY_PROJECT_ID);
 const server = new McpServer({
     name: 'flowrelay',
-    version: '1.0.0',
+    version: PKG_VERSION,
 });
 async function getTenantContext() {
     const context = await api.listProjects();
@@ -206,7 +208,7 @@ server.tool('list_handoffs', 'List Flow Relay handoffs in the current tenant sco
     return { content: [{ type: 'text', text }] };
 });
 // ── Tool: generate handoff ───────────────────────────────────────────
-server.tool('generate_handoff', 'Generate a new context handoff for personal scope or a selected project. Supports per-source filters.', {
+server.tool('generate_handoff', 'Generate a new context handoff for the active project. Requires an active project or explicit project_id. Supports per-source filters.', {
     sources: z.array(SourceEnum)
         .optional()
         .describe('Specific sources to include (omit for all connected sources)'),
@@ -454,7 +456,7 @@ server.tool('list_filter_options', 'List the real per-source filter values (reso
 }, async ({ project_id }) => {
     try {
         const resolved = await requireProject(project_id);
-        const filters = await api.getHandoffFilters(resolved.projectId);
+        const { filters, figma } = await api.getHandoffFilters(resolved.projectId);
         const sources = Object.keys(filters);
         if (sources.length === 0) {
             return { content: [{ type: 'text', text: `No connected sources with filter options for ${resolved.project.name}.` }] };
@@ -475,6 +477,12 @@ server.tool('list_filter_options', 'List the real per-source filter values (reso
                 lines.push(`- Priorities: ${f.priorities.map((p) => p.value).join(', ')}`);
             return lines.join('\n');
         });
+        if (figma && !figma.selectable) {
+            blocks.push('### figma\n- NOT selectable on this project: Figma visual context requires the Global processing region. ' +
+                (figma.canManageResidency
+                    ? 'Switch the project to Global in its Data Residency settings first.'
+                    : 'Ask an organization admin to switch the project to Global first.'));
+        }
         return { content: [{ type: 'text', text: `Filter options for ${resolved.project.name}:\n\n${blocks.join('\n\n')}` }] };
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowrelay/mcp-server",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Flow Relay MCP Server for Claude Desktop and Claude Code – handoffs, integrations, and context events via natural conversation.",
   "type": "module",
   "license": "MIT",