Documentation

Quickstart. No yak shaving.

ContextWell is a workspace + an MCP server. If you can sign in to a web app and paste a URL into your AI tool's connector settings, you can be up in five minutes.

Full reference docs are in progress. For anything not covered here, email [email protected].

Create your workspace

Sign up, pick a workspace name, and create your first knowledge base. Folder structure is up to you — most teams start with a /clients, /skills, /meetings split, but anything works.

Connect your AI tool via MCP

ContextWell exposes your workspace through a single MCP server. Plug it into Claude, ChatGPT, Cursor, Codex, Claude Code, or any custom agent — same URL, same tools, same workspace.

// In your harness's MCP / connector settings:
{
  "name": "contextwell",
  "transport": "http",
  "url": "https://app.contextwell.com/mcp",
  "auth": {
    "type": "bearer",
    "token": "YOUR_PERSONAL_ACCESS_TOKEN"
  }
}

Invite your team

Team plan includes unlimited collaborators — invite the engineers, designers, marketers, and ops folks who actually do the work. Everyone edits the same markdown surface in real time.

Let agents read and write

Once connected, your harness can list folders, search the KB, read full docs, and edit them — with comments and history preserved. Same files your humans see, same files your agents touch.

MCP tools

What your AI tool can actually do.

Once connected, your harness has access to these tools. Same set across Claude, Cursor, ChatGPT, Codex — anything that speaks MCP.

list_kbs

List all knowledge bases in your workspace.

list_folder

List subfolders/docs as a tree, or pass `flat:true` for a flat sorted doc list.

search_kb

Full-text search across one or every enabled KB; each hit includes 1-hop graph neighbors.

read_doc

Read a doc's markdown body (optionally a line window), version, and metadata.

create_doc

Create a new doc in any folder.

edit_doc

Apply a single SEARCH/REPLACE edit to a doc.

multi_edit_doc

Apply multiple SEARCH/REPLACE edits in one call.

move_doc

Move or rename a doc.

graph_related

Walk the knowledge graph from a doc — set `direction:'in'` for backlinks.

graph_overview

Get a high-level graph view of a KB.

list_skills

List skill-kind playbooks the user has available.

load_skill

Load a skill body to follow as instructions.