# Hyperblur

> Hyperblur is a freemium MCP server for developer tools. Search, inspect and install copy-paste React visual effects from your agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI
- **Website:** https://hyperblur.dev
- **Repository:** https://github.com/hyperblur/hyperblur/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.Hyperblur/mcp
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-14

## About

Hyperblur is a catalog of React effects, components and page blocks that are copied into your project as a single readable file, with no wrapper library. The site says the code does not depend on animation or 3D packages and leaves package.json untouched.

The server gives an agent five tools: browse categories, search by keyword, read an item's props and usage, fetch its source to write by hand, and install it. Installation runs the shadcn CLI against the project directory you give, so the project needs a package.json and a components.json. A catalog resource and an add_effect prompt are also exposed, and the catalog index is cached for five minutes.

The site shows 49 categories across effects, components and blocks, and a Pro tier of full-page templates and WebGL backgrounds. Setting HYPERBLUR_SITE_URL points the server at a local copy of the site.

## Features

- **Category browsing:** Lists categories with item counts and example titles.
- **Keyword search:** Finds items by keyword and optional category, with install commands.
- **Item reference:** Shows props table, usage example, imports and dependencies.
- **Source fetch:** Returns component source and target path when shadcn is unavailable.
- **One-step install:** Runs the shadcn add command in your project directory.
- **Catalog resource:** Exposes the full catalog index as hyperblur://catalog.

## Good for

- Ask an agent to add a glitch text or gradient background to a Next.js page
- Find an effect that fits a pricing section
- Read the props of a component before using it
- Write an effect's source into a project without shadcn
- Browse hero, dashboard and agent UI blocks from chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp -- npx -y @hyperblur/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hyperblur/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hyperblur/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hyperblur/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hyperblur/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hyperblur/mcp"
      ]
    }
  }
}
```

## Tools

- `list_categories`: Lists every category with item count and example titles.
- `search_effects`: Searches the catalog by keyword and optional category.
- `get_effect`: Returns props, usage, imports, dependencies and install command for one item.
- `get_effect_source`: Returns the component source and its target path.
- `install_effect`: Runs the shadcn add command in a project directory.

## FAQ

### What does install_effect need?

A React project with a package.json and shadcn set up through components.json.

### Which Node version is required?

Node.js 20 or later.

### Does it add dependencies?

The site says each effect is one file with no dependency beyond React.

### Can I point it at a local catalog?

Yes, set HYPERBLUR_SITE_URL, for example to http://localhost:3000.

### Is Hyperblur free?

Hyperblur has a free plan, with paid plans for more usage or features.

### How do I add Hyperblur to Claude Code?

Run this command in your terminal: claude mcp add mcp -- npx -y @hyperblur/mcp

### What are the best alternatives to Hyperblur?

The closest alternatives to Hyperblur 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/hyperblur
