MCP server

Your agent, plugged into the catalog.

Connect Claude Code, Cursor, Windsurf or VS Code to blockus over MCP — search blocks, read source, and install with one command, without leaving your editor.

Introduction

The blockus MCP server gives your AI coding agent direct access to the blockus block catalog. Search blocks with natural language, get source code, generate install commands, and let your agent handle the rest — without leaving your editor.

Available tools

Ten tools, grouped by what they do.

Core

list_blocksList every block — id, title, category, isPro, install command.
search_blocksNatural-language search across id, title, category and description.
get_install_commandExact CLI command + components.json setup for one or more blocks.

Content

get_block_codeFull TSX source of a block (free blocks; pro stays gated).
get_block_promptLLM-ready integration prompt with metadata, source and steps.

Page composition

list_combosAll 50 starter combos grouped by use case (SaaS, e-commerce, portfolio…).
get_comboA curated full-page combo (hero → body → footer) with assembled JSX.
get_page_install_commandOne command that installs every block in a page at once.

Utility

get_categoriesAll categories with total / free / pro counts.
get_random_blocksN random blocks, optionally filtered by category.

Connect

Point your editor at https://blockus.lndevui.com/mcp. Pick your editor below.

Claude Code

Run the CLI command, or commit .mcp.json to the project root.

bash

claude mcp add --transport http blockus https://blockus.lndevui.com/mcp

Prefer a committed config? Add it with --scope project to write .mcp.json: { "mcpServers": { "blockus": { "type": "http", "url": "https://blockus.lndevui.com/mcp" } } } Run /mcp inside Claude Code to confirm the connection.

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (per project)

json

{
  "mcpServers": {
    "blockus": {
      "url": "https://blockus.lndevui.com/mcp"
    }
  }
}

The mcpServers root key is required — without it Cursor ignores the file silently.

VS Code (GitHub Copilot)

.vscode/mcp.json (workspace) or your user profile

json

{
  "servers": {
    "blockus": {
      "type": "http",
      "url": "https://blockus.lndevui.com/mcp"
    }
  }
}

VS Code uses the servers key (not mcpServers) and needs the explicit type: "http".

Windsurf

~/.codeium/windsurf/mcp_config.json

json

{
  "mcpServers": {
    "blockus": {
      "serverUrl": "https://blockus.lndevui.com/mcp"
    }
  }
}

Windsurf uses serverUrl for remote HTTP servers. After saving, press the refresh button in Cascade.

Example agent prompts

Once connected, just ask in plain language:

“List all available hero blocks from blockus”
“Find a blockus pricing block with a comparison table”
“Install hero-03 and pricing-07 from blockus”
“Give me the source code of blockus hero-03”
“Build me a SaaS landing page with blockus blocks”
“Show me the blockus starter combos for an agency site”
“Scaffold the blockus 'portfolio' combo”
“What blockus blocks are free?”
“Show me a random blockus footer block”

Pro blocks

Pro blocks require a BLOCKUS_API_KEY. The MCP server tells your agent which blocks are pro and what setup is needed — the source itself stays gated and installs through the registry once your key is set. Full setup is on the docs page.

MCP server URL

https://blockus.lndevui.com/mcp

Your agent, plugged into the catalog.

Introduction

Available tools

Connect

Claude Code

Cursor

VS Code (GitHub Copilot)

Windsurf

Example agent prompts

Pro blocks

MCP server URL

Product

More

Legal