---
title: "mdfy MCP server: setup in 4 lines"
url: https://memory.wiki/PrxR1Uj4
updated: 2026-05-14T18:15:49.480Z
hub: https://memory.wiki/hub/demo
bundle_count: 1
concept_count: 12
source: "memory.wiki"
---
# mdfy MCP server: setup in 4 lines

> For Claude Desktop, Cursor, and any other MCP-enabled tool.

## What MCP gives us

MCP (Model Context Protocol) is Anthropic's open standard for letting AI tools call external services. The mdfy MCP server exposes seven tools — read, search, create, update, publish, delete, list — that any MCP host can call. The result: the AI doesn't just *read* your hub URL; it can actively manage what's in it.

## Setup

Add this to your MCP config (Claude Desktop: `~/Library/Application Support/Claude/mcp_config.json`; Cursor: `.cursor/mcp.json` in the project):

```json
{
  "mcpServers": {
    "mdfy": {
      "command": "npx",
      "args": ["-y", "@mdfy/mcp-server"]
    }
  }
}
```

Restart the host (Claude Desktop or Cursor). The mdfy tools show up in the tool palette.

## Authentication

The MCP server reads `MDFY_EDIT_TOKEN` and `MDFY_USER_EMAIL` from the environment. Add them to the MCP config like this:

```json
{
  "mcpServers": {
    "mdfy": {
      "command": "npx",
      "args": ["-y", "@mdfy/mcp-server"],
      "env": {
        "MDFY_USER_EMAIL": "you@example.com",
        "MDFY_EDIT_TOKEN": "..."
      }
    }
  }
}
```

You can copy the edit token from the Share modal of any doc you own; it scopes to your whole account, not a single doc.

## The tools exposed

| Tool | Purpose |
|---|---|
| `mdfy_read` | Fetch a doc / bundle / hub by id or URL |
| `mdfy_search` | Hybrid recall across your hub |
| `mdfy_create` | Create a new doc with a body |
| `mdfy_update` | Patch an existing doc (with optional change summary) |
| `mdfy_publish` | Flip a draft doc to public |
| `mdfy_delete` | Soft-delete (recoverable from trash) |
| `mdfy_list` | List all your docs/bundles, optionally filtered |

## What changes in your workflow

Before MCP: you ask Claude "summarise the launch plan", and Claude says "I'd need to read the plan — paste it for me." After MCP: Claude calls `mdfy_read` with the doc id, gets the markdown, and answers.

That's the deal. The tool palette is small (7 tools) but the reach is big — every operation you'd do in the editor is also callable from the AI.


---

## Concepts in this document
- **AI tool integration** _(concept)_
  Ability to paste hub URL directly into Claude, ChatGPT, Cursor, or Codex for question-answering against the hub.
- **mdfy Platform** _(entity)_
  Knowledge management platform designed for AI-first workflows with URL-based sharing.
- **Cursor IDE** _(entity)_
  Code editor that can fetch and utilize mdfy bundle URLs for project context.
- **Cursor** _(entity)_
  Code editor that consumes mdfy bundles as context for chat and composer sessions.
- **Claude Code** _(entity)_
  AI coding feature mentioned as a primary context for AI-native developer adoption.
- **Codex CLI** _(entity)_
  Command-line interface that integrates with AGENTS.md to load project context and caches configuration at session start.
- **MCP protocol** _(entity)_
  Existing tool-call protocol that enables function calls across hosts but does not make context portable.
- **mdfy hub** _(entity)_
  The core platform being demonstrated; a personal-knowledge layer tool for organizing and sharing documents.
- **Session Context Management** _(concept)_
  How different tools handle and cache external context across user sessions.
- **Model Context Protocol** _(concept)_
  Anthropic's open standard enabling AI tools to call external services, the foundational mechanism this document explains.
- **mdfy Integration Patterns** _(concept)_
  Core strategy for connecting mdfy bundles to AI development tools through various protocols.
- **Context Injection** _(tag)_
  Techniques for providing AI tools with relevant background information.

## Concept relations (within this doc's concepts)
- **mdfy Integration Patterns** connects to **mdfy Platform**
- **AI tool integration** encompasses **mdfy Integration Patterns**
- **AI tool integration** advanced via **Model Context Protocol**
- **AI tool integration** queries **mdfy hub**

## Bundles containing this document
- [AI tool integration tour](https://memory.wiki/b/EJbI7cto)
  > Claude Code, Codex (AGENTS.md), MCP server, Cursor — every wiring path the demo hub supports.

_Hub canonical:_ https://memory.wiki/hub/demo
_Concept digest:_ https://memory.wiki/raw/hub/demo?digest=1&compact=1