MCP server

Your AI editor can browse the whole catalog, read source and fetch install commands — without you leaving the conversation.

Connect (Claude Code)

Two things happen in two different places — this is the step most people trip on. You register the server once in your terminal, then you use it by chatting with Claude Code.

1. In your project's terminal, register the server
terminal
```
claude mcp add --transport http blockforge https://blockforge.terravidhal.me/mcp
```
This is a terminal command (needs the claude CLI installed), not something you type in the chat.
2. Confirm it's registered
terminal
```
claude mcp list
```
You should see blockforge in the list, connected.
3. Use it — just ask Claude Code
Open Claude Code and chat in plain language. It calls the Blockforge tools for you:
- “List the Blockforge blocks for a pricing section.”
- “Install hero-centered into my project.”

Other editors

Same server URL, declared in the editor's MCP config:

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "blockforge": { "url": "https://blockforge.terravidhal.me/mcp" }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "blockforge": { "type": "http", "url": "https://blockforge.terravidhal.me/mcp" }
  }
}

The seven tools

list_blocksEvery block, filterable by category or license

search_blocksKeyword search across names, descriptions and categories

get_categoriesCategories with live block counts

get_block_codeFull TypeScript source — pro blocks need your registry token

get_install_commandThe shadcn CLI command for any block

list_starter_pagesReady-made page compositions

get_starter_pageA page's blocks, install commands and builder link

Pro blocks over MCP

Free blocks work with no extra setup. For pro blocks, the get_block_code tool needs your registry token — it takes a token argument. You pass it right in the conversation.

1. Copy your token (starts with bf_) from your account page.
2. Give it to Claude Code when you ask for a pro block — for example:

“Install hero-split using my Blockforge token bf_your_token.”

Claude Code passes it to get_block_code as the token argument, the server verifies your license and returns the source. Without a valid token, pro blocks are refused (free blocks still work). Blocks that rely on Blockforge CSS utilities include them in the response, ready to append to your stylesheet.

Keep your token private — it unlocks pro blocks on your behalf. See Pro access for the CLI equivalent.

Try these prompts

“Find me a pricing section with a comparison table and install it.”
“What starter pages does Blockforge have for a SaaS launch?”
“Install the saas-landing page into my project.”