# Memescale Docs

> Documentation for Memescale: Telegram Bot, Buy Bot, Raid Bot, X Automations, X Agents, Multi-Chain Scanner, Wallet Tracker, Creator Tools, Reference, Platform, Free Bots, Generation, Group Access, Moderation.

MCP server: https://docs.memescale.ai/mcp (Streamable HTTP, no auth). Setup: https://docs.memescale.ai/reference/use-with-ai
Full text: https://docs.memescale.ai/llms-full.txt

## Telegram Bot

The /menu panel, group access, holders, custom commands and owner controls.

- [Configure your bot within Telegram](https://docs.memescale.ai/raw/telegram-bot/introduction.md)
- [Groups and access](https://docs.memescale.ai/raw/telegram-bot/menu-access-groups.md): A group is authorized when it's on the bot's allowed list. Each feature decides for itself whether it checks that list.
- [Enabling the /holders to track your project's holder count](https://docs.memescale.ai/raw/telegram-bot/holders-cmds-holders.md): `/holders` replies with the live holder count of one token, set per bot from the dashboard. It works in groups and in a DM with the bot.
- [Custom commands](https://docs.memescale.ai/raw/telegram-bot/holders-cmds-custom-commands.md): Text commands and button commands are built from the same modal in the dashboard's **Commands** tab. A command saved with buttons attached is a button…
- [MP3 downloader](https://docs.memescale.ai/raw/telegram-bot/tools-mp3-downloader.md): Paste a SoundCloud or YouTube link in an authorized chat, or send `/download` / `/mp3`, and the bot replies with the track as a 320 kbps MP3.
- [Image edit presets](https://docs.memescale.ai/raw/telegram-bot/tools-image-edit-presets.md): `/presets` applies one of 15 stock image-edit styles to a photo you send.
- [Owner controls](https://docs.memescale.ai/raw/telegram-bot/owner-controls.md): `/showlimits` reads back the dashboard's rate limits and blocks. User Limits, the Twitter whitelist, Change Notifications and Transfer Bot Ownership are…
- [Moderation](https://docs.memescale.ai/raw/telegram-bot/owner-moderation.md): One dashboard switch enables `/ban` and `/mute` for a group's own Telegram admins.

## Buy Bot

Setup, the settings card, message layout, media, chains and limits.

- [Buy bot setup](https://docs.memescale.ai/raw/buy-bot/buybot-setup.md): The buy bot posts a message in a Telegram group every time someone buys the token it is configured for. Set it up inside Telegram or from the dashboard.
- [Commands and the settings card](https://docs.memescale.ai/raw/buy-bot/buybot-commands.md): Every buy bot command and every button on the settings card.
- [Message layout](https://docs.memescale.ai/raw/buy-bot/buybot-msg-layout.md): What a buy post contains, how the size row scales, and how much text fits.
- [Instantly copy any other buy bot in seconds](https://docs.memescale.ai/raw/buy-bot/buybot-msg-fork.md): `/forkbuybot` in Telegram and pasting a buy post into the dashboard's body editor both import the layout only — never groups, never the on/off switch.
- [Customizing the media attached to your buy bot](https://docs.memescale.ai/raw/buy-bot/buybot-msg-media.md): A buy post carries either one fixed picture or a fresh pick from a linked gallery site on every buy.
- [Chains, links and limits](https://docs.memescale.ai/raw/buy-bot/buybot-chains.md): The buy bot's 9 supported chains, how each link token resolves, and the limits.

## Raid Bot

Raid targets, participation tracking and the raid card.

- [Raid bot](https://docs.memescale.ai/raw/raid-bot/raid-bot.md): `/raid` posts a board that tracks a tweet's likes, retweets, replies and bookmarks against a goal, updating until the goal is met or the raid is stopped.

## X Automations

Feed and follow-tracker automations, rules, recap and card layouts.

- [What X (Twitter) automations are](https://docs.memescale.ai/raw/x-automations/xauto-what-it-is.md): An X automation watches one X account and posts what it finds into one authorized Telegram group (or your DM with the bot), using its own message preset.…
- [Feed automations](https://docs.memescale.ai/raw/x-automations/xauto-feed.md): A feed automation posts every new main-page post from one X account.
- [Following tracker](https://docs.memescale.ai/raw/x-automations/xauto-follow.md): A following tracker posts every new account that one X account starts following.
- [Follower tracker](https://docs.memescale.ai/raw/x-automations/xauto-follower.md): A follower tracker posts every new account that follows one X account.
- [Rules](https://docs.memescale.ai/raw/x-automations/xrules-rules.md): Rules are an add-on on a following or follower tracker. They decide whether something the bot found gets posted.
- [Recap](https://docs.memescale.ai/raw/x-automations/xrules-recap.md): Recap is an add-on on a feed automation: a ranked summary of the posts it announced, sent into the group at set times of day, Eastern time.
- [Posts on demand, follower lists, and contract-address cards](https://docs.memescale.ai/raw/x-automations/xrules-posts-lists-ca.md): These three live on a following tracker's card, reached by pressing its buttons. None has a Telegram command.
- [Forum topics](https://docs.memescale.ai/raw/x-automations/xrules-forum-topics.md): A feed or follow automation can route its messages into a forum topic of its group, instead of General.
- [Card layouts and limits](https://docs.memescale.ai/raw/x-automations/xrules-cards-limits.md): Every automation renders one of two card shapes depending on its type.

## X Agents

What an X agent does, your X API keys, deploying, the whitelist, replies, status and metrics.

- [What an X agent is](https://docs.memescale.ai/raw/x-agents/xagent-what-it-is.md): An X agent runs on an X account you own and replies to mentions with a generated image. It never posts on its own.
- [Your X API keys](https://docs.memescale.ai/raw/x-agents/xagent-api-keys.md): The agent runs on the four keys of an X developer app you own. Deploying checks only that each field is filled in.
- [Deploying an X agent](https://docs.memescale.ai/raw/x-agents/xagent-deploy.md): You buy Heavy+, pay, then enter your four X keys. The X agent deploys first and the matching Telegram bot deploys right after it.
- [The whitelist](https://docs.memescale.ai/raw/x-agents/xagent-whitelist.md): Only whitelisted accounts trigger the agent. Mentions from anyone else are filtered out at X. An empty whitelist means no replies.
- [How the agent replies](https://docs.memescale.ai/raw/x-agents/xagent-replies.md): The agent replies with one image when a whitelisted account posts the agent's @handle and a character trigger word, each as a separate word.
- [Status and metrics](https://docs.memescale.ai/raw/x-agents/xagent-dashboard.md): You manage an X agent in the dashboard with the switch set to Twitter. Status shows on the agent's entry and activity in the Metrics tab.

## Multi-Chain Scanner

Contract addresses, the coin card, calls and milestone alerts.

- [Pasting a contract address](https://docs.memescale.ai/raw/scanner/scan-paste-ca.md): Paste a contract address or a recognised link and the bot replies with the coin's card. There is no scanner command.
- [Every link format recognised](https://docs.memescale.ai/raw/scanner/scan-link-formats.md)
- [The coin card](https://docs.memescale.ai/raw/scanner/scan-coin-card.md): The card is built from a fixed set of rows in a fixed order. Rows the bot has nothing for are dropped.
- [Supported chains](https://docs.memescale.ai/raw/scanner/scan-chains-sources.md): The scanner reads coins on nine chains.
- [Calls](https://docs.memescale.ai/raw/scanner/calls-recording.md): A call is recorded every time the bot answers a pasted address or link with a token card. There is no separate command.
- [Milestone alerts](https://docs.memescale.ai/raw/scanner/calls-milestones.md): A milestone alert posts when a coin's live multiple over its first call crosses one of 11 fixed thresholds.
- [The calls commands](https://docs.memescale.ai/raw/scanner/calls-commands.md): Three commands read the calls database: `/mycalls`, `/viewallcalls`, and `/leaderboard`.
- [Turning the scanner on and off](https://docs.memescale.ai/raw/scanner/calls-toggle.md): One switch governs the scanner, call recording, milestone alerts and the three calls commands together.

## Wallet Tracker

Live buys and sells of the Solana wallets you add, posted in the chats you pick.

- [How to track wallets with your bot](https://docs.memescale.ai/raw/wallet-tracker/wallet-tracker-setup.md): The wallet tracker posts every buy and sell a Solana wallet makes, in the chats you pick. It's off by default.
- [Adding a wallet by pump.fun username](https://docs.memescale.ai/raw/wallet-tracker/wallet-tracker-pumpfun.md): Send a pump.fun username instead of an address. The bot finds the wallet behind the profile and posts its trades under the username.

## Creator Tools

Emoji packs, the coin creator, banners, dividers and hyperlink navs.

- [Emoji packs: the three creation modes](https://docs.memescale.ai/raw/creator-tools/emoji-pack-modes.md): An emoji pack is created three ways — a 3D spinning coin, a static image, or a paste of premium emoji from another pack — each with its own command. The…
- [The coin creator in Telegram](https://docs.memescale.ai/raw/creator-tools/emoji-coin-creator.md): /newpack (or /emojipack) with no premium emoji attached opens the coin flow: an image first, then full customization or an instant random coin. 2 spin…
- [The coin studio on the web](https://docs.memescale.ai/raw/creator-tools/emoji-coin-studio.md): /dashboard/emoji-design has three tabs: Progress Bar, Coin Emoji and Banner. The Coin Emoji tab offers 2 spin styles, 6 colours, 7 textures and 21 finish…
- [Pack management and fleet minting](https://docs.memescale.ai/raw/creator-tools/emoji-pack-management.md): /mypacks lists every pack you've created, 10 per page. Each opens a detail card with 6 buttons for editing, adding to, sharing or deleting it.
- [The banner creator](https://docs.memescale.ai/raw/creator-tools/banner-creator.md): The banner creator builds an animated Telegram custom-emoji strip out of text, images and motion presets. It runs in the dashboard, not the bot; the…
- [Dividers](https://docs.memescale.ai/raw/creator-tools/banner-dividers.md): A divider is a horizontal rule built from custom emoji, inserted from the Dividers picker in any message editor.
- [What a hyperlink nav is](https://docs.memescale.ai/raw/creator-tools/nav-what-it-is.md): A hyperlink nav is a single Telegram text message built from custom emoji and centred hyperlinks. It is saved and sent as an ordinary text command.
- [Building a nav from links](https://docs.memescale.ai/raw/creator-tools/nav-building-from-links.md): The builder is one five-step flow: website URL, buckets, link selection, preset, and command. The same builder handles editing (chapter 4.9).
- [Presets, buckets and caps](https://docs.memescale.ai/raw/creator-tools/nav-presets-buckets-caps.md): A preset supplies a nav's banner, dividers, edge emoji and colour variants. Three are available. A nav carries up to six links.

## Reference

The complete command table, every limit, and these docs for AI assistants over MCP.

- [The complete command table](https://docs.memescale.ai/raw/reference/reference-commands.md)
- [All limits in one place](https://docs.memescale.ai/raw/reference/reference-limits.md)
- [Use these docs with AI](https://docs.memescale.ai/raw/reference/use-with-ai.md): These docs are available to AI assistants over MCP and as plain markdown. Connect the MCP server once and the assistant can search and read every page.

## Platform

What Memescale is, compute plans, X agents, pricing, billing and account security.

- [Start here](https://docs.memescale.ai/raw/platform/platform-start-here.md): Generation on a commercial bot is uncapped, and image editing runs from a caption that starts with `/Edit`. Group moderation is off until you switch it on.
- [Platform overview](https://docs.memescale.ai/raw/platform/platform-overview.md): Memescale trains an image model on one character and deploys it as a bot on Telegram, on X, or on both.
- [Compute and X agents](https://docs.memescale.ai/raw/platform/platform-compute.md): The plan decides how the GPU is allocated. Heavy+ adds an X agent on an X account you own.
- [Plans and billing](https://docs.memescale.ai/raw/platform/platform-plans.md): Four purchasable products: three monthly plans and a one-time Day Pass.
- [Account security](https://docs.memescale.ai/raw/platform/platform-security.md): Bot ownership is tied to your Telegram account, not your @handle.

## Free Bots

Every bot feature except image generation and editing, on a bot that stays yours.

- [Free Bots](https://docs.memescale.ai/raw/free-bots/free-bots.md): Every bot feature except image generation and editing, on a bot that stays yours.

## Generation

Generating images, output and performance, training, datasets, multi-character and the gallery.

- [Generating an image](https://docs.memescale.ai/raw/generation/generation-how.md): A generation starts with the character's trigger word followed by a description of the scene.
- [Speed and concurrency](https://docs.memescale.ai/raw/generation/generation-performance.md): Speed depends on the bot's compute tier. There's no limit on how many people can generate at once.
- [The dataset and training](https://docs.memescale.ai/raw/generation/generation-model-training.md): Between 10 and 80 images per character. One bot holds up to 4 characters.
- [The gallery site](https://docs.memescale.ai/raw/generation/generation-gallery.md): Each trained character gets a site at `{character}.memescale.ai`. Every generated image is saved to it.
- [Built-in tools](https://docs.memescale.ai/raw/generation/generation-builtin-tools.md): `/emojipack` and `/presets` work on every bot from the moment it is purchased. Neither uses the trained character.

## Group Access

The allowlist model, /authorize, /getid, managing access, notifications and live configuration.

- [Authorizing a chat](https://docs.memescale.ai/raw/group-access/access-allowlist.md): Every chat is denied until it is on the allowed list. Two Telegram commands and two dashboard surfaces put it there.
- [Notifications and live configuration](https://docs.memescale.ai/raw/group-access/access-notifications.md): Some dashboard changes DM the bot's owner. All changes reach the live bot immediately.
- [Data, answers and support](https://docs.memescale.ai/raw/group-access/access-reference.md): Retention, the questions asked most, and the dashboard ticket system.

## Moderation

/mute, /ban, rate limits and user restrictions.

- [Moderating users](https://docs.memescale.ai/raw/moderation/moderation-users.md): Group access decides which chats a bot works in; per-user controls decide what one person may do inside them. The two are independent.
- [Troubleshooting and glossary](https://docs.memescale.ai/raw/moderation/moderation-reference.md): Symptoms with their cause, and the terms used across this manual.