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

Q: Can I set up a multi-step approval workflow for Craft (Docs & Notes) using Mastra AI?

Yes, you can set requireToolApproval on destructive tools like deletedocument. This pauses the agent and requires a human operator to confirm the deletion before any files are permanently removed from Craft.

Q: How do I register the Craft (Docs & Notes) tools inside a Mastra AI agent?

Instantiate the client using new MCPClient and call mcpClient.listTools(). This MCP integration then spreads those returned tools directly into your agent's configuration object during initialization.

Build resilient TypeScript workflows that automatically update your Craft (Docs & Notes) workspace using Mastra AI.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated daily note generation in Mastra AI

Creating your daily log depends on `get_daily_note` to retrieve the explicit date-mapped document from your Craft workspace. Mastra AI uses this tool within its workflow engine to verify if today's page already exists before running subsequent agent steps. If the document is missing, your workflow branches conditionally to execute `create_document` and set up your daily template. This structure ensures your automated logs never overwrite existing notes or fail silently.

Self-healing document updates using this MCP Server

Mutating page structures safely requires `update_document` to swap out old content blocks with new data. If the Craft API rate limits your request, Mastra AI's built-in retry engine handles the failure with exponential backoff. Your agent won't crash when network hiccups happen during large workspace updates. Instead, this MCP Server handles the connection state while Mastra retries the block injection until the update succeeds.

Human-approved document deletion

Deleting critical pages uses the `delete_document` tool to permanently remove live nodes from your Craft workspace. Because this action is irreversible, Mastra AI lets you configure a mandatory approval step before the agent executes the call. The workflow pauses and alerts you, waiting for a manual confirmation before letting the agent vaporize the document. This prevents autonomous loops from accidentally wiping out your team's knowledge base.

Setup guide

Set up Craft (Docs & Notes) MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Craft (Docs & Notes) tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "craft-docs-notes-mcp-client",
  servers: {
    "craft-docs-notes-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Craft (Docs & Notes) Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Craft (Docs & Notes) tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Craft (Docs & Notes) transactions"
);
console.log(result.text);

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 Mastra AI

You rely on the framework's automatic retry engine. When tools like `update_document` hit API limits, the workflow executes an exponential backoff strategy to complete the write operation without failing.

Yes, you can set `requireToolApproval` on destructive tools like `delete_document`. This pauses the agent and requires a human operator to confirm the deletion before any files are permanently removed from Craft.

Instantiate the client using `new MCPClient` and call `mcpClient.listTools()`. This MCP integration then spreads those returned tools directly into your agent's configuration object during initialization.

The client automatically detects the transport type, defaulting to Streamable HTTP or Server-Sent Events (SSE) depending on your network environment. You don't have to write any custom MCP transport negotiation logic yourself.

Your daily notes, tasks, and document blocks flow directly through secure, ephemeral V8 isolates. Vinkius never stores your workspace data, acting solely as a zero-trust proxy that handles the API authentication layer.

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