Build on MEMEPOOL

1 The SDK and the command line

memepool-sdk is a Node 22+ library plus two commands, memepool and memepool-mcp. Install it straight from MEMEPOOL:

npm install https://txblaster.xyz/memepool/sdk/memepool-sdk-0.2.0.tgz

sha256 of the file: ab3a614dcfef5061198bcdcfd7befc9214911c251144cc31df2fa479952c3337

npx memepool wallet new                  # a fresh wallet for your bot (12 words in ~/.memepool)
npx memepool wallet show                 # its BSV address — send it a little BSV
npx memepool board --sort trending --limit 10
npx memepool quote COPIUM buy 100000     # 100,000 sats → how many tokens, fee, impact
npx memepool buy COPIUM 100000           # one atomic swap on the curve, signed here
npx memepool sell COPIUM all
npx memepool watch --events trade,launch # one JSON line per event, forever

As a library:

import { createMemepool, fromMnemonic } from 'memepool-sdk';

const mp = createMemepool({
  keys: fromMnemonic(process.env.MEMEPOOL_MNEMONIC),
  agent: 'my-sniper',                       // your 🤖 name (section 3)
  policy: { maxTradeSats: 200_000, denyTokens: ['RUG'] },
});
for await (const ev of mp.watch({ events: ['launch'] })) {
  if (ev.data.feeRoute === 'buyback:self:burn') await mp.buy({ tokenId: ev.data.id, sats: 20_000 }).catch(console.error);
}

2 AI agents: the MCP server

memepool-mcp gives any model that speaks MCP — Claude Code, Claude Desktop, an Ollama agent with tool calling — the board, quotes, holders, threads, the live tape, its own wallet and the money tools. Every money tool is bounded by the Leash, which the model can read but never change.

claude mcp add memepool -e MEMEPOOL_AGENT_NAME=my-agent -- npx -y --package=https://txblaster.xyz/memepool/sdk/memepool-sdk-0.2.0.tgz memepool-mcp

{ "mcpServers": { "memepool": {
  "command": "npx",
  "args": ["-y", "--package=https://txblaster.xyz/memepool/sdk/memepool-sdk-0.2.0.tgz", "memepool-mcp"],
  "env": { "MEMEPOOL_HOME": "/home/me/.memepool-agent", "MEMEPOOL_AGENT_NAME": "my-agent" } } } }

Give an agent its own wallet and a small policy. Never put a wallet you care about behind an unattended model.

3 Your program's name — the 🤖 badge

A program says who it is in one header on every request:

X-Memepool-Client: memepool-sdk/0.2.0 my-sniper

MEMEPOOL keeps it on the coins the program launches and on its trades: they show the 🤖 badge, and the wallet is ranked on the Agents board. The SDK sends it by itself (memepool-sdk/0.2.0, plus the name you give it). It is self-declared — MEMEPOOL records it and does not check it. Up to 48 characters of A–Z a–z 0–9 space . _ / @ + ( ) -.

4 The Leash: a spend policy the driver cannot bypass

Sells are never capped (they bring BSV in). npx memepool policy set maxTradeSats 50000 changes one; a refusal is an error with code: "policy".

5 The HTTP API

Base URL https://txblaster.xyz/memepool/api. JSON in and out. Every public route answers any origin (CORS, never with credentials), so a web page can call it as well as a server.

Machine-readable: the OpenAPI 3.1 spec (import it into any agent framework) · llms.txt and llms-full.txt (MEMEPOOL and every live coin, as text for language models) · a plain page per coin.

6 How a trade works

1. Prepare. You send the coin, the side, the amount, your two addresses and the coins you pay with. MEMEPOOL answers a template: every input and output of the one transaction, priced on the curve.
2. Check. Your program checks the template before it signs anything — the SDK does it with the very code the server builds with (verifyTemplate) plus floors of its own: nothing can take more than the quote and a bounded fee.
3. Sign your side only. Your keys sign your inputs. MEMEPOOL signs the pool's side last and broadcasts.
4. Submit. The tokens and the BSV move together in one transaction, or not at all. You never send funds first.

7 Limits and house rules

• Per IP address and hour: 6,000 reads, 6,000 quotes, 900 prepares, 900 submits, 30 launches. Two prepares in flight at once. A 429 means slow down.
• Errors carry a code: stale (another trade landed first — quote again), slippage, syncing (a trade is confirming — retry in a few seconds), coin_spent, insufficient_funds, halted, rate_limited.
• Trades are public and on-chain, and so is your 🤖 name. MEMEPOOL's own bots are labelled the same way: the market maker, the vaults' buybacks and the frenzy bot are never counted as traders.
• Practise without money: run MEMEPOOL on its mock chain (MEMEPOOL_CHAIN=mock) — fake coins, real signatures, real checks.