@flowrelay/mcp-server 0.9.0 → 1.0.0

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: 0.9.0
+- Version: 1.0.0
 
 ## What Is Included
 
@@ -18,6 +18,7 @@ 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_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)

package/dist/api.d.ts

@@ -98,6 +98,30 @@ export type GenerateInsightResponse = {
     jobId: string;
     status: AiJobStatus;
 };
+export interface AvailableSourceFilter {
+    projects: {
+        id: string;
+        label: string;
+    }[];
+    eventTypes: {
+        value: string;
+        label: string;
+    }[];
+    branches?: {
+        value: string;
+        label: string;
+    }[];
+    branchesByProject?: Record<string, {
+        value: string;
+        label: string;
+    }[]>;
+    defaultBranchByProject?: Record<string, string>;
+    priorities: {
+        value: string;
+        label: string;
+    }[];
+}
+export type AvailableFilters = Record<string, AvailableSourceFilter>;
 export declare class FlowRelayAPI {
     private baseUrl;
     private apiKey;
@@ -105,6 +129,7 @@ export declare class FlowRelayAPI {
     private requestRaw;
     private request;
     listProjects(): Promise<TenantContext>;
+    getHandoffFilters(projectId: string): Promise<AvailableFilters>;
     listHandoffs(status?: string, limit?: number, projectId?: string | null): Promise<{
         handoffs: HandoffResult[];
     }>;

package/dist/api.js

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

package/dist/index.js

@@ -59,7 +59,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: '0.9.0',
+    version: '1.0.0',
 });
 async function getTenantContext() {
     const context = await api.listProjects();
@@ -446,6 +446,39 @@ server.tool('list_insights', 'List project AI insights for a selected project sc
         return { content: [{ type: 'text', text: `Failed to list insights: ${err.message}` }] };
     }
 });
+// ── Tool: list filter options ───────────────────────────────────────
+server.tool('list_filter_options', 'List the real per-source filter values (resources, branches, event types, priorities) available for a project. Call this BEFORE generate_handoff or any generate_*_insight so the "filters" argument uses real values instead of guesses. Pass a resource id into filters[source].projects, a branch name into .branches, an event type into .eventTypes, a priority into .priorities.', {
+    project_id: z.string().optional().describe('Project scope. Omit to use the active project.'),
+}, async ({ project_id }) => {
+    try {
+        const resolved = await requireProject(project_id);
+        const filters = 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}.` }] };
+        }
+        const blocks = sources.map((src) => {
+            const f = filters[src];
+            const lines = [`### ${src}`];
+            if (f.projects?.length) {
+                const items = f.projects.slice(0, 50).map((p) => (p.label && p.label !== p.id ? `${p.label} (id: ${p.id})` : p.id));
+                const more = f.projects.length > 50 ? ` (+${f.projects.length - 50} more)` : '';
+                lines.push(`- Resources: ${items.join(', ')}${more}`);
+            }
+            if (f.branches?.length)
+                lines.push(`- Branches: ${f.branches.map((b) => b.value).join(', ')}`);
+            if (f.eventTypes?.length)
+                lines.push(`- Event types: ${f.eventTypes.map((e) => e.value).join(', ')}`);
+            if (f.priorities?.length)
+                lines.push(`- Priorities: ${f.priorities.map((p) => p.value).join(', ')}`);
+            return lines.join('\n');
+        });
+        return { content: [{ type: 'text', text: `Filter options for ${resolved.project.name}:\n\n${blocks.join('\n\n')}` }] };
+    }
+    catch (err) {
+        return { content: [{ type: 'text', text: `Could not load filter options: ${err.message}` }] };
+    }
+});
 // ── Start ────────────────────────────────────────────────────────────
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

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