Rebrickable LEGO MCP Server for Windsurf 11 tools — connect in under 2 minutes
Windsurf brings agentic AI coding to a purpose-built IDE. Connect Rebrickable LEGO through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install Rebrickable LEGO and 2,500+ MCP Servers from a single visual interface.
{
"mcpServers": {
"rebrickable-lego": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Rebrickable LEGO MCP Server
Connect to the Rebrickable LEGO API and explore the entire LEGO catalog through natural conversation.
Windsurf's Cascade agent chains multiple Rebrickable LEGO tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 11 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
What you can do
- Sets — Search and browse LEGO sets by theme, year or part number with piece counts and images
- Parts — Explore the official LEGO parts catalog with part numbers, names and categories
- Minifigures — Discover minifigures with their set numbers, themes and images
- Themes — Browse all LEGO themes and sub-themes with set counts
- Colors — List all LEGO colors with their IDs, names and RGB values
- Set Parts — Get complete parts inventories for any LEGO set including spare parts
The Rebrickable LEGO MCP Server exposes 11 tools through the Vinkius. Connect it to Windsurf in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Rebrickable LEGO to Windsurf via MCP
Follow these steps to integrate the Rebrickable LEGO MCP Server with Windsurf.
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Add the server
Paste the JSON configuration above into mcp_config.json
Save and reload
Windsurf will detect the new server automatically
Start using Rebrickable LEGO
Open Cascade and ask: "Using Rebrickable LEGO, help me...". 11 tools available
Why Use Windsurf with the Rebrickable LEGO MCP Server
Windsurf provides unique advantages when paired with Rebrickable LEGO through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 11 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Rebrickable LEGO + Windsurf Use Cases
Practical scenarios where Windsurf combined with the Rebrickable LEGO MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from Rebrickable LEGO and generate models, types, or handlers based on real API responses
Live debugging: query Rebrickable LEGO tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from Rebrickable LEGO and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine Rebrickable LEGO data with Cascade's code generation to scaffold entire features in minutes
Rebrickable LEGO MCP Tools for Windsurf (11)
These 11 tools become available when you connect Rebrickable LEGO to Windsurf via MCP:
get_minifig
g. "sw0001-1"). Returns the minifig name, theme, year, piece count and image URLs. Get details for a specific LEGO minifigure
get_part
g. "3001" for a 2x4 brick). Returns the part name, category, image URLs and available colors. Get details for a specific LEGO part
get_part_colors
Returns color IDs, color names and availability info. Useful for finding which colors a part is available in for MOC building. Get available colors for a LEGO part
get_set
g. "75192-1"). Returns the set name, year, theme, piece count, minifig count, image URLs and related info. Set numbers follow the format "NNNN-N" where NNNN is the set number and N is the variant. Get details for a specific LEGO set
get_set_parts
Each entry includes the part number, color ID, quantity and whether it's a spare part. Optionally include minifig parts. Use list_colors and list_parts to resolve color and part details. Get the parts inventory for a LEGO set
get_theme
Returns the theme name, parent theme (if sub-theme) and set count. Get details for a specific LEGO theme
list_colors
Useful for understanding color availability in sets and MOC building. List all LEGO colors in the catalog
list_minifigs
Returns minifig numbers, names, themes, year and image URLs. Optionally filter by part number. Use pagination with page and page_size (max 1000). Search LEGO minifigures
list_parts
Returns part numbers, names, categories and image URLs. Optionally filter by part number pattern. Use pagination with page and page_size (max 1000). Search LEGO parts in the catalog
list_sets
Optionally filter by theme ID, year, or part number. Returns set numbers, names, year, theme, piece count and image URLs. Use pagination with page and page_size (max 1000 per request). Search LEGO sets in the Rebrickable catalog
list_themes
g. Star Wars, City, Technic) and their sub-themes. Each theme includes its ID, name, parent theme ID (for sub-themes) and set count. Optionally filter by parent theme ID to get sub-themes of a specific theme. List LEGO themes and sub-themes
Example Prompts for Rebrickable LEGO in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with Rebrickable LEGO immediately.
"Find all LEGO Star Wars sets from 2024."
"Show me the parts inventory for set 10497 (Galaxy Explorer)."
"What colors is LEGO part 3001 (2x4 brick) available in?"
Troubleshooting Rebrickable LEGO MCP Server with Windsurf
Common issues when connecting Rebrickable LEGO to Windsurf through the Vinkius, and how to resolve them.
Server not connecting
Rebrickable LEGO + Windsurf FAQ
Common questions about integrating Rebrickable LEGO MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Connect Rebrickable LEGO with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Rebrickable LEGO to Windsurf
Get your token, paste the configuration, and start using 11 tools in under 2 minutes. No API key management needed.