MCP server

The @flowrelay/mcp-server package lets Claude Desktop and Claude Code use Flow Relay through natural conversation. It is a thin client over the same REST API – every tool maps to an endpoint. No repository access is required; the server is installed on demand via npx.

Setup

Install Node.js (v18 or later).
Create an API key in Settings → API Keys.
Add the server to your Claude config file:

json

{
  "mcpServers": {
    "flowrelay": {
      "command": "npx",
      "args": ["-y", "@flowrelay/mcp-server"],
      "env": {
        "FLOWRELAY_API_KEY": "fr_your_api_key_here",
        "FLOWRELAY_PROJECT_ID": "your_project_id"
      }
    }
  }
}

Environment variables

Variable	Required	Purpose
`FLOWRELAY_API_KEY`	Yes	Your `fr_` API key.
`FLOWRELAY_PROJECT_ID`	No	Default active project for project-scoped tools.
`FLOWRELAY_BASE_URL`	No	Override the API base (defaults to `https://www.flowrelay.it`).

Tools

The server exposes 15 tools:

Tool	Description
`get_workspace_context`	Inspect account mode, active scope, and current role.
`list_projects`	List personal and organization projects you can access.
`set_active_project`	Set or clear the active project context.
`list_filter_options`	List selectable resources, branches, event types, and priorities per source.
`list_handoffs`	List handoffs by status and limit.
`generate_handoff`	Generate a handoff with optional source filters.
`list_integrations`	List connected integrations in personal or project scope.
`list_untracked_resources`	List active resources not yet assigned to a project.
`list_events`	Browse recent events in personal or project scope.
`discord_list_channels`	List text channels in your connected Discord server.
`discord_send_message`	Send a message to a Discord channel.
`generate_correlation_insight`	Generate a cross-source correlation insight.
`generate_onboarding_brief`	Generate an onboarding brief insight.
`generate_architecture_insight`	Generate an architecture insight.
`list_insights`	List project AI insights.

The generate_* tools and list_filter_options accept per-source filters (projects / eventTypes / branches / priorities), so the model works with real selectable values rather than guessing. See Filters.

The package is published on npm under the MIT license.