How to Use the Builder MCP in Claude Code

Q: How do I add the Builder MCP Server to Claude Code?

Run the command claude mcp add --transport http builder-mcp -- in your terminal. You can verify the installation by running claude mcp list to see the active tools.

Q: How do I query a specific Builder document using Claude Code?

Ask Claude Code to search for it, and it will run getsinglecontent with your specific query parameters. The JSON payload is returned directly to your standard output.

Q: Can I retrieve media details from the terminal?

Yes, you can use getmediafile to fetch asset metadata. This returns size, format, and URL details directly to your shell.

Pipe Builder CMS schemas and content directly into your terminal workflows using Claude Code and this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Builder MCP to Claude Code

Create your Vinkius account to connect Builder to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Builder with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit Builder.io schemas with Claude Code

The `list_builder_models` tool fetches every active data structure in your CMS space with one command. SREs can pipe this output into grep or jq to audit configurations across staging and production environments. This MCP Server lets you run automated CI/CD checks to ensure your schemas match your main branch code. You do not have to log into a web console to verify structures.

Script visual block updates with Claude Code

The `update_visual_block` tool gives you terminal control over your headless CMS content. You can feed JSON payloads directly from local files into Claude Code to update production blocks in bulk. If a migration fails, the agent uses `wipe_visual_block` to roll back changes instantly. You get clean, scriptable content deployments without manual web-form editing.

Monitor CMS entity counts in your terminal

The `count_model_entities` tool returns the exact number of active entries inside a specific model. You can run this tool in a cron job or bash script to monitor database growth and track content velocity. It works alongside `search_active_models` to locate orphaned or legacy models that need cleanup. Keep your headless space clean using direct terminal commands instead of clicking through a dashboard.

Setup guide

Set up Builder MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see builder-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Builder transactions." It will automatically discover and invoke the available Builder tools.

Terminal

claude mcp add --transport http builder-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Builder MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "builder-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Builder. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Builder now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Builder MCP in Claude Code

Run the command `claude mcp add --transport http builder-mcp -- ` in your terminal. You can verify the installation by running `claude mcp list` to see the active tools.

Yes, Claude Code runs in your terminal, allowing you to redirect output from tools like `list_model_content` into local files or grep patterns. This makes automated content audits fast and simple.

Ask Claude Code to search for it, and it will run `get_single_content` with your specific query parameters. The JSON payload is returned directly to your standard output.

Yes, you can use `get_media_file` to fetch asset metadata. This returns size, format, and URL details directly to your shell.

All traffic runs through ephemeral, zero-trust V8 isolates. Your CMS content, media assets, and model configurations are processed in memory and never persisted on Vinkius infrastructure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript