How to Use the Craft (Docs & Notes) MCP in Windsurf

Q: Can the Cascade agent in Windsurf create multi-page reports in Craft (Docs & Notes)?

Yes. Cascade can chain multiple createdocument calls to generate several linked pages. It can pull data from other sources, then format and write that data into a structured report inside your Craft (Docs & Notes) workspace.

Let Windsurf's Cascade agent run your Craft workspace. It creates documents, organizes blocks, and tracks tasks all on its own.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Craft (Docs & Notes) MCP to Windsurf

Create your Vinkius account to connect Craft (Docs & Notes) 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 Craft (Docs & Notes) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build a Knowledge Base from a Single Prompt

Give Cascade a goal, like 'document the new API endpoints'. It will use `create_document` to start a new page in Craft, then run `append_block` repeatedly to build out sections, code blocks, and lists. You don't prompt each step; Cascade plans and executes the entire sequence. This turns documentation from a chore into a background process. While you work on the next feature, your agent is busy structuring your notes, updating pages with `update_document`, and keeping your team's knowledge base current. It’s documentation that actually gets done.

Let Your Agent Find What It Needs

Cascade doesn't just write to Craft, it reads from it. Before starting a task, it can run `search_documents` to find existing project specs, meeting notes, or style guides. This gives your agent the context it needs to perform complex, multi-step actions correctly the first time. Your agent can pull specific content using `get_document` and even inspect the structure of a page with `list_blocks`. It’s not just blindly following orders; it's using your existing knowledge base to make better decisions on its own.

Connect Windsurf to Your Team's Tasks

This MCP Server gives Cascade direct access to your team's to-do list in Craft. Your agent can use `list_tasks` to get a full picture of outstanding work across your entire workspace. It can see what needs to be done before it starts writing code or creating new documents. Combine this with `get_daily_note` to pull up today's priorities. You can build workflows where Cascade checks the daily plan, identifies key tasks, and then starts executing them. It’s a simple way to keep your agent aligned with your team's focus.

Setup guide

Set up Craft (Docs & Notes) 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 Craft (Docs & Notes) 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 Craft (Docs & Notes) payment history." If connected, Cascade will call the Craft (Docs & Notes) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "craft-docs-notes-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 Craft. 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 Craft (Docs & Notes) 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 Craft (Docs & Notes) MCP in Windsurf

You give Windsurf's Cascade agent a high-level goal, and it uses tools like `list_tasks` and `search_documents` to gather context from Craft (Docs & Notes). It then builds a plan, creating new documents and appending blocks to outline the project, all without step-by-step instructions.

Yes. Cascade can chain multiple `create_document` calls to generate several linked pages. It can pull data from other sources, then format and write that data into a structured report inside your Craft (Docs & Notes) workspace.

You don't have to do it manually. Just ask Cascade a question that requires finding information, and it will automatically use the `search_documents` tool on this MCP Server to get the answer from your notes.

The easiest way is through Windsurf's built-in MCP Marketplace. Find the server and click install. You can also add it manually in your `mcp_config.json` file if you prefer.

Your data—documents, blocks, and tasks—is only processed in memory for the duration of a tool call. Vinkius runs each MCP Server in an ephemeral sandbox that is destroyed after the operation. Nothing is logged or stored.

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