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 and docs in a folder.

list_docs

List all docs in a KB.

read_doc

Read a doc's markdown body, 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.

search_kb

Full-text search across a KB.

graph_backlinks

Find docs that link to a given doc.

graph_related

Find docs related to a given doc by graph proximity.

graph_overview

Get a high-level graph view of a KB.