Skip to main content
Glama
max-mcp-server

max-mcp-server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MAX_TZNoTime zone used for dates. Defaults to the system time zone.
QR_SVGNoPath to write the QR code as SVG during 'login qr'. The file is removed after login.
MAX_RPSNoGlobal request rate limit to MAX in requests per second (maximum 50).5
MAX_PHONENoPhone number used only for 'login phone'.
MAX_CLIENTNoClient mode: 'web' (like web.max.ru) or 'mobile' (needed for SMS login).web
MAX_PROFILENoProfile (account) name.default
MAX_HTTP_HOSTNoHTTP transport bind host.127.0.0.1
MAX_HTTP_PATHNoHTTP transport path./mcp
MAX_HTTP_PORTNoHTTP transport port.13430
MAX_LOG_LEVELNoLog level written to stderr.INFO
MAX_READ_ONLYNoSet to 'false' to register write tools.true
MAX_STATE_DIRNoSession state directory.$XDG_STATE_HOME/max-mcp-server/<profile>
MAX_ALLOW_JOINNoAllow the max_join_chat tool.false
MAX_DENY_CHATSNoDeny list as comma-separated chat IDs, applied over all other allowlists.
MAX_HTTP_TOKENNoBearer token for HTTP transport. Must be at least 16 characters.
MAX_READ_CHATSNoRead allowlist as comma-separated chat IDs. Empty means all chats.
MAX_SEND_LIMITNoSend rate limit, comma-separated values in N/s, N/min, N/h, N/d form, or 'off'.20/h,5/min
MAX_TEXT_LIMITNoMaximum length of message text in output.4000
MAX_UPLOAD_DIRNoThe only directory from which files may be sent. If unset, file sending is disabled.
MAX_LOGIN_TOKENNoWeb session token used only for 'login token'.
MAX_LOG_CONTENTNoLog message texts and names. Only for debugging.false
MAX_WRITE_CHATSNoWrite allowlist as comma-separated chat IDs. Empty means no writes; '*' means all chats explicitly.
MAX_DOWNLOAD_DIRNoDirectory where downloaded media is stored.$XDG_CACHE_HOME/max-mcp-server/<profile>/media
MAX_TOOL_TIMEOUTNoMaximum time in seconds for a heavy call, including queue wait.300
MAX_APPEAR_ONLINENoWhether to appear online.false
MAX_HTTP_MAX_BODYNoMaximum HTTP request body size in bytes.1048576
MAX_DOWNLOAD_HOSTSNoAdditional allowed host suffixes for downloads, in addition to built-in MAX CDN hosts.
MAX_SHOW_OWN_PHONENoWhether to show your own phone number in max_get_me.false
MAX_UNTRUSTED_WRAPNoWrapper for untrusted text: 'tags', 'json', or 'off'.tags
MAX_CONNECT_TIMEOUTNoConnection timeout in seconds.20
MAX_HTTP_TOKEN_FILENoFile containing the bearer token for HTTP transport.<state>/http_token
MAX_LOG_PYMAX_DEBUGNoEnable DEBUG logs for PyMax, websockets, aiohttp, and full tracebacks. Prints protocol frames and message texts.false
MAX_REQUEST_TIMEOUTNoRequest timeout in seconds.30
MAX_HTTP_SECRET_PATHNoAdd a random secret segment to the HTTP path.false
MAX_UPLOAD_MAX_BYTESNoMaximum upload size in bytes.52428800
MAX_2FA_PASSWORD_FILENoFile containing the 2FA password. File permissions should be 600.
MAX_HEAVY_CONCURRENCYNoMaximum number of concurrent heavy calls such as history scans, search, timeline, and unread summary.2
MAX_ALLOW_CREATE_GROUPNoAllow the max_create_group tool. Also allowed when MAX_WRITE_CHATS='*'.false
MAX_DOWNLOAD_ALLOW_IPSNoCIDR ranges allowed to download despite private addresses, for example for a corporate proxy.
MAX_DOWNLOAD_MAX_BYTESNoMaximum download size in bytes.52428800
MAX_HTTP_ALLOWED_HOSTSNoAdditional allowed Host values for HTTP transport.
MAX_INLINE_IMAGE_BYTESNoMaximum size of images returned inline.1048576
MAX_HTTP_ALLOW_NONLOCALNoAllow binding to a non-loopback address. Requires a token; use TLS proxy or SSH tunnel for security.0
MAX_HTTP_ALLOWED_ORIGINSNoAdditional allowed Origin values for HTTP transport.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

NameDescription

No tools

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources