@flowrelay/mcp-server 0.9.0 → 1.0.1

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)
@@ -28,7 +29,7 @@ The server currently exposes these tools:
 - list_events
 - list_untracked_resources (lists event-producing resources not scoped to any project – useful for discovering untracked activity)
 - discord_list_channels
-- discord_send_message
+- discord_send_message (plain text, or a handoff/insight by id or `last_*` rendered to Markdown and attached as a `.md` file)
 
 ## Environment Variables
 

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[];
     }>;
@@ -155,7 +180,13 @@ export declare class FlowRelayAPI {
             topic: string;
         }>;
     }>;
-    discordSendMessage(channelId: string, content: string): Promise<{
+    discordSendMessage(channelId: string, payload: {
+        content?: string;
+        handoff_id?: string;
+        insight_id?: string;
+        artifact?: 'last_handoff' | 'last_correlation' | 'last_onboarding' | 'last_architecture';
+        project_id?: string;
+    }): Promise<{
         ok: boolean;
         message_id: string;
     }>;

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);
@@ -105,10 +109,10 @@ export class FlowRelayAPI {
     async discordListChannels() {
         return this.request('/discord/channels');
     }
-    async discordSendMessage(channelId, content) {
+    async discordSendMessage(channelId, payload) {
         return this.request('/discord/send', {
             method: 'POST',
-            body: JSON.stringify({ channel_id: channelId, content }),
+            body: JSON.stringify({ channel_id: channelId, ...payload }),
         });
     }
     async listUntrackedResources() {

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();
@@ -326,12 +326,22 @@ server.tool('discord_list_channels', 'List text channels in your connected Disco
     }
 });
 // ── Tool: discord send message ──────────────────────────────────────
-server.tool('discord_send_message', 'Send a message to a Discord channel in your connected server.', {
-    channel_id: z.string().describe('The Discord channel ID to send the message to'),
-    content: z.string().describe('The message content to send'),
-}, async ({ channel_id, content }) => {
+server.tool('discord_send_message', 'Send to a Discord channel in your connected server. Provide exactly one of: content (inline text); handoff_id or insight_id (sends that artifact, rendered to Markdown, as a .md file attachment); or artifact (last_handoff / last_correlation / last_onboarding / last_architecture, with project_id) to send the latest active artifact of that kind.', {
+    channel_id: z.string().describe('The Discord channel ID to send to'),
+    content: z.string().optional().describe('Inline message text. Mutually exclusive with handoff_id / insight_id / artifact'),
+    handoff_id: z.string().optional().describe('UUID of a handoff to render and attach as a .md file'),
+    insight_id: z.string().optional().describe('UUID of an insight to render and attach as a .md file'),
+    artifact: z
+        .enum(['last_handoff', 'last_correlation', 'last_onboarding', 'last_architecture'])
+        .optional()
+        .describe('Send the latest active artifact of this kind. Requires project_id'),
+    project_id: z.string().optional().describe('Project UUID. Required only when artifact is set'),
+}, async ({ channel_id, content, handoff_id, insight_id, artifact, project_id, }) => {
+    if (!content && !handoff_id && !insight_id && !artifact) {
+        return { content: [{ type: 'text', text: 'Provide content, handoff_id, insight_id, or artifact.' }] };
+    }
     try {
-        const result = await api.discordSendMessage(channel_id, content);
+        const result = await api.discordSendMessage(channel_id, { content, handoff_id, insight_id, artifact, project_id });
         return { content: [{ type: 'text', text: `Message sent (ID: ${result.message_id})` }] };
     }
     catch (err) {
@@ -446,6 +456,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.1",
   "description": "Flow Relay MCP Server for Claude Desktop and Claude Code – handoffs, integrations, and context events via natural conversation.",
   "type": "module",
   "license": "MIT",