docs(mcp): document memwal_login + memwal_logout tools (ENG-1749)#151
Merged
Conversation
Bring the MCP overview in line with the inline-login flow shipped in 1b296b1. Previously the docs told users to run `npx ... login` from a separate terminal and restart their MCP client. After ENG-1749 the stdio package advertises memwal_login and memwal_logout tools, so the agent can sign in or switch accounts without leaving the chat. Changes: - Tools section: split into 4 memory tools + 2 session tools (6 total) - Streamable HTTP setup: keep the CLI as the way to mint a bearer token - stdio setup: lead with the inline memwal_login flow; CLI is now a fallback. Note the 5-minute URL window and the memwal_logout path - New "CLI Flags and Environment Variables" section covering --logout, --label, --web-url, --login, --help, and MEMWAL_MCP_DEBUG - Environment presets: surface the dashboard URL alongside the relayer - Self-hosting: inline the key MCP session-cap env vars instead of punting entirely to the env-vars reference packages/mcp/README.md gets a one-line nudge so the package README also points users at the inline-login tool rather than implying a manual CLI step.
ducnmm
approved these changes
May 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Brings
docs/mcp/overview.mdin line with the inline-login flow shipped in 1b296b1 (ENG-1749). The previous text told users to runnpx ... loginfrom a separate terminal and restart their MCP client — the same friction PR #141 review flagged as a blocker. After ENG-1749, the stdio package advertisesmemwal_loginandmemwal_logouttools, so the agent signs in inline without leaving the chat.Changes
memwal_loginflow; CLI is now a fallback. Documents the 5-minute URL window and thememwal_logoutpath for account switching.--logout,--label,--web-url,--login,--help, andMEMWAL_MCP_DEBUG.SIDECAR_URL,MCP_MAX_TOTAL_SESSIONS,MCP_MAX_SESSIONS_PER_IP,MCP_MAX_NEW_SESSIONS_PER_IP_PER_MIN) instead of punting entirely to the env-vars reference.packages/mcp/README.md: one-line nudge so the package README also points users at the inline-login tool.ENG-1750 (native OAuth for HTTP transport) is still in progress and is intentionally not documented here.
Test plan
docs/mcp/overview.mdin the Mintlify preview and verify tables, callouts, and code fences look correct./reference/environment-variables.npmREADME on the next package publish (packages/mcp/README.mdshows the new intro line).