How to Use the Craftboxx MCP in Windsurf

Give Windsurf direct access to your field operations. Cascade handles the API calls while you focus on the code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Craftboxx MCP to Windsurf

Create your Vinkius account to connect Craftboxx to Windsurf 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 Craftboxx with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf MCP Server for Craft Orders

The `create_order` tool lets Cascade generate new service requests directly from your code editor. You define the project parameters in plain English, and the agent maps them to the correct backend schema automatically. Checking status happens just as fast. Running `get_order_details` pulls the current state of any job, while `get_business_stats` aggregates your total completion rates for custom dashboard development.

Autonomous Scheduling Automation

Fetching the daily roster requires one command using the `list_employees` tool. Cascade reads the available crew list and cross-references it with open jobs without asking for your permission between steps. Field work coordination relies on the `list_appointments` and `list_tasks` endpoints. Your agent maps out the day's requirements, matching specific team members to their assigned locations based on real-time availability.

Fleet and Material Tracking

Tracking physical assets relies on the `list_vehicles_resources` tool to pull current machine assignments. You can ask your agent to find an available truck, and it will scan the entire fleet registry instantly. Inventory management works the same way through `list_materials` and `list_customers`. The agent checks stock levels against client addresses to ensure the crew has the right parts before they drive to the site.

Setup guide

Set up Craftboxx MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Craftboxx 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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Craftboxx payment history." If connected, Cascade will call the Craftboxx tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "craftboxx-mcp": {
      "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 Craftboxx. 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 Craftboxx 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 Craftboxx MCP in Windsurf

Open your editor settings and navigate to the Cascade MCP Servers UI. You can also edit `~/.codeium/windsurf/mcp_config.json` directly to add the endpoint URL. Click refresh in the panel to expose the tools.

Yes. Cascade reads your initial prompt and executes multiple steps autonomously. It will check inventory, assign a vehicle, and schedule the appointment without stopping for approval.

The connection operates entirely through the server endpoints. Your agent fetches the live data and writes the necessary script files locally to match the API response perfectly.

You skip building custom internal tools. The agent reads the live backend state and writes dashboard code that matches your actual field data exactly.

Vinkius isolates your connection inside a V8 sandbox. Your client only retrieves customer names, addresses, and appointment details when explicitly requested for a specific coding task. The server destroys the container immediately after the session ends.

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