Supply Flow

What it does

Supply Flow generates self-contained, interactive HTML or SVG diagrams that map the geographic movement of products through a supply chain. Nodes represent participants (manufacturers, assemblers, distributors) placed at real-world coordinates on an equirectangular world map; flows are rendered as curved arrows between nodes. When used with an MCP Apps-capable host, the diagram renders inline in the conversation rather than as a separate file.

The tool is purpose-built for supply chain compliance screening — specifically FCC Covered List, BIS Entity List, and CSL screening under 47 CFR Part 2 and 47 U.S.C. § 1601. It supports risk assessment popovers, direct links to FCC/BIS/CSL entries, corporate ownership trees, and multiple scenario generation when manufacturer identity is uncertain.

Key features

• Inline MCP App rendering — diagram appears directly in the chat when using a compatible host
• Compliance-first design — clickable nodes show regulatory risk popovers with direct FCC/BIS/CSL links
• Multi-scenario support — generates alternative diagrams when manufacturer provenance is ambiguous
• Dual output formats — HTML (interactive, self-contained) or SVG
• Skill-driven generation — /supply-flow Claude Code skill auto-generates diagrams from a natural language description

Installation

Clone and link:

git clone https://github.com/paulopes/supply-flow.git && cd supply-flow
npm install && npm run build
npm link

Claude Desktop:

{
  "mcpServers": {
    "supply-flow": {
      "command": "node",
      "args": ["/absolute/path/to/supply-flow/main.mjs", "--stdio"]
    }
  }
}

Or use the automated installer: npm run install-mcp:claude-desktop

Claude Code skill: Copy skill/supply-flow-SKILL.md to ~/.claude/skills/supply-flow/SKILL.md and use /supply-flow in chat.

Supported hosts

Claude Desktop, Claude Code, VS Code Copilot, Cursor, Windsurf, Gemini CLI — all supported via automated installers.