# Flood Design System

> Flood Design System is an open-source MCP server for design and media. Search and read Flood's React components, recipes, tokens and design guidance. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI
- **Website:** https://flood.md/docs/mcp
- **Repository:** https://github.com/tillwithered/flood.md
- **MCP Registry name:** io.github.tillwithered/flood
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

Flood is an open-source design system for developers and coding agents, with React 18.3 and 19 components, Next.js App Router support, dark foundations and semantic tokens. This server serves its public website material to an agent so it can look things up instead of guessing at component APIs.

Three tools do the work: flood_info reports the published catalog version and groups, search_flood finds matching components, recipes, guides, skills and tokens, and read_flood returns the source material for one result. The docs suggest sample prompts such as a requests table with bulk approval, a collapsible-navigation workspace and a latency dashboard.

For an existing project the docs point to the installed package and the Flood CLI, whose versioned guidance matches what is installed. The hosted endpoint needs no account or API key and keeps no record of request bodies, though its host Railway may retain operational metadata. Code is MIT licensed.

## Features

- **Catalog search:** search_flood finds components, recipes, guides, skills and tokens.
- **Source reading:** read_flood returns the source material for a single result.
- **Version info:** flood_info shows the published catalog version and groups.
- **No account needed:** The public catalog works without an account or API key.
- **Catalog skill:** A skill installable through the Skills CLI teaches agents to find and verify components.

## Good for

- Have a coding agent build a data table with the right Flood components
- Look up design tokens while writing UI
- Generate a dashboard layout that follows Flood's guidance
- Check a component's contract before using it

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http flood https://flood.md/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://flood.md/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "flood": {
      "url": "https://flood.md/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "flood": {
      "type": "http",
      "url": "https://flood.md/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "flood": {
      "serverUrl": "https://flood.md/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "flood": {
      "type": "http",
      "url": "https://flood.md/mcp"
    }
  }
}
```

## Tools

- `flood_info`: Report the version, scope and coverage of the public Flood catalog.
- `search_flood`: Find public Flood components, ready-to-use compositions, tokens and agent guidance by name or by describing the UI task in English or Russian. Pass a result ID to read_flood for the full contract.
- `read_flood`: Read one public material by ID. Omit length for up to 10,000 characters. Continue with nextOffset when present. Required prerequisites are listed separately from related materials.

## FAQ

### Does it need an account?

No. The public catalog requires no Flood account or API key.

### What licence is Flood under?

The plugin and source are MIT licensed; the bundled Inter font keeps its SIL Open Font License.

### Which clients are documented?

Codex, Cursor, VS Code, Claude Code, ChatGPT and any client using Streamable HTTP.

### Which frameworks does Flood support?

React 18.3 and 19 and the Next.js App Router, with TypeScript declarations.

### Is Flood Design System free?

Yes. Flood Design System is open source, so you can use and self-host it for free.

### How do I add Flood Design System to Claude Code?

Run this command in your terminal: claude mcp add --transport http flood https://flood.md/mcp

### What are the best alternatives to Flood Design System?

The closest alternatives to Flood Design System are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/flood-design-system
