Documentation

WriteKit is an MCP-powered publishing tool. You create and manage pages and collections entirely through conversation with your AI assistant.

Get started

1. Add the MCP server

Claude Code Cursor Windsurf VS Code OpenCode Any Client

claude mcp add --transport http writekit https://writekit.dev/mcp

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "writekit": {
      "url": "https://writekit.dev/mcp"
    }
  }
}

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "writekit": {
      "url": "https://writekit.dev/mcp"
    }
  }
}

Add to .vscode/mcp.json:

{
  "servers": {
    "writekit": {
      "type": "http",
      "url": "https://writekit.dev/mcp"
    }
  }
}

Add to opencode.json (project root or ~/.config/opencode/opencode.json):

{
  "mcp": {
    "writekit": {
      "type": "remote",
      "url": "https://writekit.dev/mcp"
    }
  }
}

Point any Streamable HTTP MCP client at:

https://writekit.dev/mcp

2. Authenticate

On first tool use, a browser window opens to sign in with GitHub, Google, Discord, or email (magic link).

3. Create your site

After signing in, pick a subdomain at the dashboard. Your site lives at yourname.writekit.dev.

4. Start publishing

Tell your AI assistant what to write. It creates pages, organizes them into collections, and publishes — all through conversation.

Workflow

Ask your AI to create a page — it returns a preview link
Open the preview in your browser — it auto-reloads on every edit
Iterate with the AI until you're happy with the content
Ask the AI to publish — it goes live at yourname.writekit.dev/{slug}

Every edit is versioned. Append ?v=N to a preview URL to view a previous version.

Core concepts

Pages

A page is any piece of markdown content — a doc, a blog post, a tutorial, a recipe. Pages start as drafts and can be published when ready. Each page gets a URL based on its slug.

Collections

Collections group related pages together. A "docs" collection, a "blog" collection, a "recipes" collection — whatever you need. Collections can be ordered manually (for docs/tutorials) or by date (for blog-style content). Pages can also exist standalone, outside any collection.

Visibility

Pages and collections have a visibility setting:

Public (default) — visible to everyone, shown in index, sitemap, and search
Unlisted — accessible via direct URL but hidden from index, sitemap, and search
Private — only visible to authenticated team members. Everyone else gets a 404.

Visibility is independent of status. A page must be published to be visible at all — visibility controls who can see it. A private collection cascades: all pages inside it are treated as private.

Teams

Each site has a team with role-based access:

Owner — full control: billing, settings, team management, and content
Editor — can create, edit, publish, and delete pages and collections. Can view private content.
Viewer — can view private content only. Read-only access.

Invite team members by email using the invite_member tool or via the dashboard at app.writekit.dev.

URLs

Standalone page: yourname.writekit.dev/{slug}
Collection index: yourname.writekit.dev/{collection}
Page in collection: yourname.writekit.dev/{collection}/{slug}
Raw markdown: append .md to any page URL (e.g. /{slug}.md)
Search: yourname.writekit.dev/search?q={query}
Preview: yourname.writekit.dev/preview/{token} (expiring link for drafts)

Example prompts

Copy these directly into your AI assistant. They work as-is once connected.

"Write a getting-started guide and add it to the docs collection"

Creates a draft page in the docs collection, returns a preview URL.

"Create a collection called 'Tutorials' with manual ordering"

Creates a new collection you can add pages to.

"Publish my getting-started page and move it to position 1"

Publishes the page and reorders it to the top of its collection.

"Show me all my draft pages"

Lists all drafts with titles, IDs, and dates.

"Update my auth page — add a section about rate limits"

Fetches the page, appends content, regenerates the preview.

"List all my collections"

Shows collections with page counts and sort order.

"Search my pages for anything about authentication"

Full-text search across titles and content.

"Make my API docs collection private"

Updates the collection visibility so only team members can see it.

"Invite [email protected] as an editor"

Adds the user to your site team with editor permissions.

MCP tools

These tools are available to your AI assistant when connected.

Pages

Tool	Description
`create_page`	Create a new draft page with markdown content
`update_page`	Update any field of an existing page
`delete_page`	Permanently delete a page
`publish_page`	Publish a draft — returns the live URL
`unpublish_page`	Revert a published page to draft
`list_pages`	List pages, filter by status, tag, or collection
`get_page`	Get full page content by ID or slug
`append_to_page`	Append content to the end of a page without re-sending everything
`search_pages`	Full-text search across all pages

Collections

Tool	Description
`create_collection`	Create a new collection (manual or date-sorted)
`update_collection`	Update collection title, description, slug, or sort order
`delete_collection`	Delete a collection (pages become standalone)
`list_collections`	List all collections with page counts
`get_collection`	Get collection details and its pages
`reorder_pages`	Set page order within a manually-ordered collection

Settings

Tool	Description
`get_settings`	Get current site settings
`update_settings`	Update site title, description

Teams

Tool	Description
`list_members`	List all team members and their roles
`invite_member`	Add a user to the team by email (owner only)
`remove_member`	Remove a team member (owner only)
`update_member_role`	Change a member's role (owner only)

MCP resources

Resources provide read-only context your AI can access at any time.

URI	Description
`writekit://site/stats`	Page counts, collection counts
`writekit://site/settings`	Current site settings
`writekit://site/recent-pages`	Last 10 published pages
`writekit://site/drafts`	All draft pages
`writekit://site/collections`	All collections with page counts

Markdown

Pages are written in markdown with the following extensions:

GitHub Flavored Markdown — tables, strikethrough, autolinks, task lists
Code blocks — syntax highlighting with language tags (```go, ```python, etc.)
Callout blocks — > [!NOTE], > [!TIP], > [!WARNING], > [!DANGER] for styled alert boxes
Media embeds — <embed src="url" /> for YouTube, Spotify, SoundCloud, Twitter/X, GitHub Gists
D2 diagrams — ```d2 code blocks for architecture diagrams
Footnotes, auto heading IDs, raw HTML