1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
# MemFork client adapter registry (DESIGN §6.1).
#
# One entry per MCP client. Adding a client is an entry here plus a fixture
# test — never new code.
#
# `verified` is the date the entry was last checked against `docs`. Nothing in
# this file was confirmed by running the client; it is what the vendor's own
# documentation says on that date. Re-check before a release.
#
# Each entry has up to two ways in:
#
# [client.cli] the client's own `mcp add` command. Preferred, because the
# client then writes its own config in its own format and
# MemFork never parses a file it does not own. `status` asks
# the same command whether MemFork is registered, which is the
# only answer that counts: a client may store its servers
# somewhere MemFork does not model, or normalise what it was
# given, and reading its file would then disagree with it.
# [client.file] direct config editing. Used only when the client ships no
# CLI, or its CLI cannot express the requested scope. A client
# with no `user` path is one whose user configuration MemFork
# will not touch at all.
#
# In `add`, `{scope}` expands to zero or more flag tokens, `{name}` to the
# server name, `{command}` to the memfork binary path and `{args}` to its
# arguments. An expansion that produces nothing drops out of the command line.
#
# `remove` is how a registration that points at the wrong MemFork gets
# corrected: an install moves the binary, and the client keeps launching a path
# that is gone. A client with no documented `remove` is left alone and the
# command to run is printed instead, because guessing at a command that edits
# somebody's configuration is not a thing to do.
[[]]
= "claude-code"
= "Claude Code"
= "https://code.claude.com/docs/en/mcp"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.claude"
[]
= "claude"
= ["mcp", "add", "{scope}", "{name}", "--", "{command}", "{args}"]
# Asks about one server by name, rather than listing every server and
# health-checking each by starting it.
= ["mcp", "get", "{name}"]
# The scope flag follows the name here, unlike `add`.
= ["mcp", "remove", "{name}", "{scope}"]
= ["--scope", "user"]
= ["--scope", "project"]
[]
= "json"
= ["mcpServers"]
= true
= "url"
= ".mcp.json"
# No `user` path on purpose. This client keeps user-scope servers in
# `~/.claude.json`, together with its OAuth session, per-project trust settings
# and caches. MemFork neither writes nor reads that file: user scope goes
# through the `claude` command, and if that command is not on PATH, init writes
# project scope instead and says why. Leaving the path out of the registry is
# what makes that structural rather than a rule someone has to remember.
[[]]
= "cursor"
= "Cursor"
= "https://cursor.com/docs/context/mcp"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.cursor"
# Cursor ships no `mcp add` command, so the config file is the only way in.
[]
= "json"
= ["mcpServers"]
= false
= "url"
= "$HOME/.cursor/mcp.json"
= ".cursor/mcp.json"
[[]]
= "codex"
= "Codex CLI"
= "https://learn.chatgpt.com/docs/extend/mcp?surface=cli"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.codex"
[]
= "codex"
= ["mcp", "add", "{name}", "--", "{command}", "{args}"]
= ["mcp", "remove", "{name}"]
# No `mcp get` is documented for this client, so registration is read off the
# list instead.
= ["mcp", "list"]
# No scope flag is documented: `codex mcp add` writes the user config. Project
# scope therefore falls back to editing `.codex/config.toml`.
= []
[]
= "toml"
= ["mcp_servers"]
= false
= "url"
= "$HOME/.codex/config.toml"
= ".codex/config.toml"
[[]]
= "gemini-cli"
= "Gemini CLI"
= "https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.gemini"
[]
= "gemini"
# No `--` separator: the command and its arguments are positional.
= ["mcp", "add", "{scope}", "{name}", "{command}", "{args}"]
= ["mcp", "list"]
= ["mcp", "remove", "{scope}", "{name}"]
= ["-s", "user"]
= ["-s", "project"]
[]
= "json"
= ["mcpServers"]
= false
# The DESIGN §6.1 quirk: Gemini CLI uses `httpUrl` for streamable HTTP and `url`
# for SSE, where most clients use `url` for streamable HTTP. Unused until the
# shared daemon, encoded here so the difference is recorded once.
= "httpUrl"
= "$HOME/.gemini/settings.json"
= ".gemini/settings.json"
[[]]
= "grok"
= "Grok Build"
= "https://docs.x.ai/build/features/mcp-servers"
= "2026-09-20"
# The directory this client creates for itself, so "installed but never
# configured" is not mistaken for "not installed".
= "$HOME/.grok"
[]
= "grok"
= ["mcp", "add", "{scope}", "{name}", "--", "{command}", "{args}"]
= ["mcp", "list"]
# No scope flag documented for remove, so none is sent.
= ["mcp", "remove", "{name}"]
# User scope is the default and takes no flag.
= []
= ["--scope", "project"]
[]
= "toml"
= ["mcp_servers"]
= false
= "url"
= "$HOME/.grok/config.toml"
= ".grok/config.toml"