MCP Tool Schemas

Zod schemas for memory-mcp tools: authenticate/get/save/list/search. Input/output tables/examples.

TL;DR: Zod-validated inputs. Auth -> GitHub token -> session. CRUD sessions/messages.

authenticate
get-memory
save-memory
list-sessions
search-memory
Auth Flow

authenticate `authenticate.ts`

Input:

Param	Type	Req	Desc
github_token	string	opt	Direct token
oauth_code	string	opt	OAuth flow

const authenticateSchema = z.object({
  github_token: z.string().optional(),
  oauth_code: z.string().optional(),
});

Output: {user_id, session_token, expires_at}

Example:

{"github_token": "ghp_ABC123"}
// -> {"user_id": "user_123", "session_token": "sess_XYZ", "expires_at": 1735689600000}

get-memory `get-memory.ts`

Param	Type	Req	Desc
session_id	string	✅	Session
limit	number	opt	Paginate
offset	number	opt	Paginate

Output: {session_id, messages[], metadata}

save-memory `save-memory.ts`

Param	Type	Req	Desc
session_id	string	opt	Create/update
messages	LLMMessage[]	✅	History
metadata	object	opt	Extra

Output: {session_id, saved_count, updated_at}

list-sessions `list-sessions.ts`

Param	Type	Req	Desc
limit	number	opt=20	Paginate
offset	number	opt=0	Paginate
state	enum	opt	active/paused/completed

Output: {sessions[], total}

search-memory `search-memory.ts`

Param	Type	Req	Desc
query	string	✅	Search term
limit	number	opt=10	Results
filter	object	opt	session/date

Output: {results[]} w/ score/context

Auth Flow

+----------+
| Client   |
+----+-----+
     |
     v
+-----------------------+
| authenticate          |
| (github_token)        |
+---------+-------------+
          |
          v
+----------------------+
| Create session_token |
+----------+-----------+
           |
           v
+----------------------+
| get/save/list/search |
+----------+-----------+
           |
           v
+----------------------+
| memory_* tables      |
+----------------------+

Quiz: No token? -> ? A: Error: token required ✅

Use: Connect MCP -> use_mcp_tool('memory-mcp', 'authenticate', {...})

Related: Tables ->

MCP Tool Schemas

Table of Contents

authenticate `authenticate.ts`

get-memory `get-memory.ts`

save-memory `save-memory.ts`

list-sessions `list-sessions.ts`

search-memory `search-memory.ts`

Auth Flow

On this page

MCP Tool Schemas

Table of Contents

authenticate authenticate.ts

get-memory get-memory.ts

save-memory save-memory.ts

list-sessions list-sessions.ts

search-memory search-memory.ts

Auth Flow

On this page

authenticate `authenticate.ts`

get-memory `get-memory.ts`

save-memory `save-memory.ts`

list-sessions `list-sessions.ts`

search-memory `search-memory.ts`