Skip to main content
Glama

baselings-mcp

Your AI agent earns yield on Base chain. 49 tools. No API key. $0.10 safety cap.

npx baselings-mcp

MCP server for AI agents — guardrailed DeFi swaps, token launches with permanently locked liquidity, autonomous reactor burns, and a yield-generating pet game. Every action burns MfT supply.

Your agent earns real money

  • Power plant workers burn POOP + meme tokens → yield USDC, ETH, or BTC (your choice)

  • Garden workers turn POOP into LP positions — deepening liquidity permanently

  • V2 LP fees auto-compound in the vault, growing LP value and increasing POOP mint rate over time

  • ~1 POOP earned per penny spent on food — POOP flows through gardens and power plant

How it works:

Step

What happens

Buy food

Spend USDC on food (LP tokens) — $0.01 per meal

Feed pet

LP locks in baseling vault forever, you earn ~1 POOP per penny spent

Use POOP

Deposit to gardens (earn food/tokens) or power plant (burn for yield)

Workers

Assign baselings to jobs — keeper auto-harvests every 2.4 hours

Impact bonus (free PR, same pipeline): CHAR connects burns toward carbon retirement. TGN funds environmental projects. BURGERS feeds people IRL.

Related MCP server: base-lp-locker-mcp

Why buy MfT

MfT (MemeForTrees) is deflationary. Every game action burns MfT supply:

  • Buying food → buys MfT for LP (permanently locked)

  • Feeding pets → mints POOP → gardens sell POOP for MfT → burn

  • NFT purchases → 1% MfT buy + burn

  • 6 headless V3 burn machines run 24/7 on WETH, USDC, cbBTC

More players = more burns = less supply. Play the game, earn yield, AND hold the asset whose supply every action reduces.

Security model — thin pipe over forever vaults

The game wallet is a hot relay, not a safe. Keep it lean.

  • Vault LP is immutable. Once deposited into a baseling, LP is locked in the NFT contract forever. No admin key can touch it. V2 LP fees auto-compound, growing LP value and increasing POOP mint rate over time.

  • NFTs belong in your main wallet. The baseling NFT IS the vault. Whoever holds it owns the stacked yield. Transfer NFTs out of the game wallet.

  • Yields go to main wallet. Blue chip yields (USDC/ETH/BTC) from the power plant route to your main wallet, not the game wallet.

  • Game server is centralized. A breach could lose in-game POOP or pending claims. It cannot touch your vault LP, your NFTs, or your blue chip yields.

  • Recommendation: Dedicated game wallet, small USDC balance, sweep yields and NFTs to main wallet regularly. The game is a thin pipe — your vaults and wallet are the safe.

Quick start — MCP server

# Game wallet (optional — omit for read-only mode)
export GAME_WALLET_KEY=0x...

# Trade wallet for swaps (optional — omit for quote-only mode)
export TRADE_WALLET_KEY=0x...

# Run the MCP server (stdin/stdout JSON-RPC)
npx baselings-mcp

v1.1.0: Adds swap_token, swap_quote, swap_status tools. Swap guardrails enforced: $0.10 max, 60s cooldown.

v1.2.0: Adds reactor_timing, portfolio_value, mft_price, get_reactor_list, arb_signal, liquidity_depth. Expanded swap allowlist. DCA automation.

v1.4.0: Launch tools renamed to unrugable_* (old mycopad_* names kept as deprecated aliases). Dead discovery endpoints pruned; live endpoints documented.

Claude Desktop / Claude Code config

{
  "mcpServers": {
    "baselings": {
      "command": "npx",
      "args": ["baselings-mcp"],
      "env": {
        "GAME_WALLET_KEY": "0x...",
        "TRADE_WALLET_KEY": "0x..."
      }
    }
  }
}

Configuration

All configuration is via environment variables. Both keys are optional — with neither set, the server starts in read-only mode and every read tool works.

Variable

Required

Purpose

GAME_WALLET_KEY

No

Base-chain private key used for game write actions (buy/feed/claim/assign, etc.). Without it, write tools return a clear "read-only mode" error instead of failing silently. AGENT_TEST_KEY is accepted as a fallback name.

TRADE_WALLET_KEY

No

Separate private key used only for swap_token execution. Quotes (swap_quote, swap_status) work without it. Keep this wallet separate from the game wallet. TRADE_PRIVATE_KEY is accepted as a fallback name.

BASELING_API_URL

No

Override the REST base URL. Defaults to https://tasern.quest/api/baseling.

No API key, sign-up, or account is needed for read tools. The server speaks MCP over stdio (JSON-RPC on stdin/stdout) and requires Node.js 18+.

Agent discovery endpoints (no auth)

Endpoint

What it returns

/api/unrugable/tokenomics

Network data: infrastructure tokens, strategies, contracts

/api/unrugable/all

Full combined network dataset

/llms.txt

AI-readable full documentation

/.well-known/agents.json

Machine-readable capability manifest

Token swap tools (NEW in v1.1.0)

Guardrailed Uniswap V3 swaps on Base:

swap_status  → Check cooldown, daily spend, allowed tokens
swap_quote   → Get price quote (read-only, no execution)
swap_token   → Execute swap ($0.10 max, 60s cooldown)

Safety limits (non-negotiable):

  • Max per swap: $0.10

  • Min cooldown: 60 seconds

  • Max daily: $5.00 per wallet

  • Allowlisted tokens only (17 tokens including MfT, USDC, WETH, cbBTC, POOP, CHAR, EARTH, and more)

  • Exact approvals (never unlimited)

  • Separate TRADE_WALLET_KEY (game wallet cannot swap)

Quick start — SDK

const baselings = require('baselings-mcp');

const ctx = baselings.createContext(process.env.GAME_WALLET_KEY);

// Read state
const balances = await baselings.state.getBalances(ctx);
const pets = await baselings.state.getMyBaselings(ctx);

// Strategy playbooks
const strats = baselings.strategies.listStrategies();
// → green (impact), meme, bluechip, broad, custom

// Take actions
await baselings.actions.buyEgg(ctx, 'random');
await baselings.actions.feedBaseling(ctx, tokenId, 'burgers', amount);
await baselings.actions.claimPoop(ctx, [tokenId]);

REST API (no wallet needed for reads)

Live at https://tasern.quest/api/baseling/agent/

Endpoint

Description

GET /agent/guide

Game overview + all endpoints

GET /agent/status/:wallet

Balances + baseling summary

GET /agent/baselings/:wallet

All owned baselings

GET /agent/baseling/:tokenId

On-chain baseling state

GET /agent/food/:wallet

Food stock in cupboard

GET /agent/gardens

All garden pool statuses

GET /agent/assignments/:wallet

Worker assignments

GET /agent/houses/:wallet

Owned houses

GET /agent/poop/:wallet

Pending POOP to claim

GET /agent/prices

Current egg prices

GET /agent/stats

Global game statistics

GET /agent/tokenomics/flywheel

MfT burn engine model

GET /agent/tokenomics/metrics

Live on-chain metrics

GET /agent/tokenomics/pitch

Why buy MfT

GET /agent/economy/rules

Economy constraints + build order

GET /agent/economy/feeding/:job

What food to feed for a target job

GET /agent/economy/phase/:wallet

Current economy build phase

MCP tools (49 tools)

Read (10): get_balances, get_my_baselings, get_baseling, get_food_stock, get_garden_status, get_assignments, get_houses, get_pending_poop, get_egg_prices, get_global_stats

Write (14): buy_egg, hatch_egg, buy_food, feed_baseling, claim_poop, assign_worker, unassign_worker, deposit_garden, buy_house, assign_to_house, freeze_baseling, unfreeze_baseling, resurrect_baseling, ensure_approvals

Strategy (3): welcome, choose_strategy, next_actions

Tokenomics (3): mft_flywheel, tokenomics_metrics, why_mft

Economy (3): build_phase, feeding_guide, economy_rules

Info (1): game_guide

Unrugable Launch (5): unrugable_info, unrugable_launch, unrugable_check_reactor, unrugable_recent, unrugable_invite_link — launch a token paired into permanently locked Uniswap V3 liquidity and wired to a reactor that burns and compounds fees. (The former mycopad_* names still work as deprecated aliases so existing callers don't break.)

Reactor (3): fire_reactor, get_reactor_list, reactor_timing — permissionless execute() on any reactor, triggers burn+compound cascade; list all reactors with fire-readiness; predict fire windows and Prime imminence

Swap (4): swap_status, swap_quote, swap_token, arb_signal

Price (1): mft_price — current MfT/USD price via Uniswap V3 Quoter (read-only)

Portfolio (1): portfolio_value — total holdings in USD across all 17 allowed tokens (read-only)

Depth (1): liquidity_depth — measure V3 pool depth in USD before X% impact; health classification (deep/thin/dry); max profitable trade sizing (read-only)

Strategy playbooks

Pick a school of thought at the door:

Strategy

Focus

Food families

green

Impact assets, carbon credits

TGN, BURGERS, CHAR

meme

Meme token yield

BRETT, BUSTER, BURGERS

bluechip

Blue chip pairs

WETH, cbBTC

broad

Balanced (50% impact, 25% blue, 25% meme)

All

custom

Agent decides

Agent picks

Token addresses (Base chain)

  • MfT: 0x8FB87d13B40B1A67B22ED1a17e2835fe7e3a9bA3

  • POOP: 0x126555aecBAC290b25644e4b7f29c016aE95f4dc

  • BaselingNFT: 0xFCb825491490284189C75fD330Fd08Df5E9217b9

ElizaOS integration (zero custom code)

ElizaOS agents can use all 49 tools via the Fleek MCP plugin:

npm install @fleek-platform/eliza-plugin-mcp

In your character config:

{
  "plugins": ["@fleek-platform/eliza-plugin-mcp"],
  "settings": {
    "mcp": {
      "servers": {
        "baselings": {
          "type": "stdio",
          "command": "npx",
          "args": ["baselings-mcp"],
          "env": {
            "GAME_WALLET_KEY": "0x...",
            "TRADE_WALLET_KEY": "0x..."
          }
        }
      }
    }
  }
}

All 49 tools become native ElizaOS actions automatically.

Available Tools

49 tools
arb_signalA

Check MfT price across multiple pools (MfT/WETH, MfT/USDC, MfT/cbBTC) and flag arb opportunities. READ-ONLY, no wallet needed. Returns price per pool + max spread %. If spread > 1%, flags as arb opportunity with buy/sell pool recommendation.

Inputs: token.

assign_to_houseB

Move a baseling into a house

Inputs: houseTokenId (required), baselingId (required).

assign_workerB

Put a baseling to work (garden, pp, nanny, or hauler)

Inputs: baselingId (required), job (required), poolPair, roomId.

build_phaseA

Shows your current economy build phase (1-5) and what to do next. Phase 1=gardener, 2=haulers, 3=PP, 4=nanny, 5=full economy.

Inputs: no named parameters.

buy_eggB

Buy a new egg (costs USDC). Type: random ($0.10), giant ($6)

Inputs: type (required).

buy_foodB

Buy food from the grocery store (costs USDC, converts to LP)

Inputs: family (required), amountUSDC (required).

buy_houseB

Buy a house NFT (gives rooms for baselings). Types: 0-3

Inputs: houseType (required).

choose_strategyA

Pick your play style: green (impact/carbon), meme (BURGERS/BRETT/TGN), bluechip (ETH/BTC), broad (diversified), custom (you decide). Returns full playbook.

Inputs: strategy (required).

claim_poopB

Claim pending POOP rewards for your baselings

Inputs: tokenIds (required).

deposit_gardenB

Deposit POOP into a garden pool for yield

Inputs: poolPair (required), amount (required).

economy_rulesA

Returns all economy constraints: POOP delay, keeper cycle, throughput caps, overflow mechanics, care timer. Read this before playing.

Inputs: no named parameters.

ensure_approvalsA

Set up all token approvals needed to play (run this first before any write actions)

Inputs: no named parameters.

feed_baselingC

Feed a baseling (increases hunger, earns POOP after 4hr delay)

Inputs: tokenId (required), foodType (required), amount (required).

feeding_guideA

What food to feed a baseling based on its target job. Maps food→stat→job optimization.

Inputs: targetJob (required).

fire_reactorA

Fire a reactor (permissionless). Triggers burn+compound cycle: collects LP fees, burns tokens, deepens liquidity, sends 5% upstream. Any reactor can be fired every 2 hours. Costs ~$0.01 gas. After firing, MfT price dislocates across pools — arb opportunity.

Inputs: reactorAddress (required).

freeze_baselingC

Put baseling in cryo storage

Inputs: tokenId (required).

game_guideB

Detailed how-to-play guide with rate limits, tips, and mechanics explained.

Inputs: no named parameters.

get_assignmentsB

See which baselings are working and where

Inputs: no named parameters.

get_balancesA

Check your wallet balances (ETH, USDC, POOP, WETH)

Inputs: no named parameters.

get_baselingC

Get detailed on-chain info about one baseling

Inputs: tokenId (required).

get_egg_pricesB

Current egg prices in M currency

Inputs: no named parameters.

get_food_stockA

Check food in your cupboard (amount, spoiled status, time until spoil)

Inputs: no named parameters.

get_garden_statusA

Check all garden pools (workers, yields)

Inputs: no named parameters.

get_global_statsA

Game-wide statistics (total baselings, POOP minted/burned)

Inputs: no named parameters.

get_housesA

List your houses and who lives in them

Inputs: no named parameters.

get_my_baselingsA

List all your baseling pets with their stats

Inputs: no named parameters.

get_pending_poopB

Check claimable POOP for your baselings

Inputs: tokenIds (required).

get_reactor_listA

List all known reactors with fire-readiness status. READ-ONLY, no wallet needed. Returns each reactor name, address, pool count, whether it can be fired now, and cooldown remaining.

Inputs: no named parameters.

hatch_eggC

Hatch an egg into a baseling

Inputs: tokenId (required).

liquidity_depthA

Measure how much USD can be traded before moving price by X%. Reads V3 pool state (slot0, liquidity, tick boundaries) for MfT arb pools. Returns per-pool depth, health classification (deep/thin/dry), and max profitable trade size. READ-ONLY, no wallet needed.

Inputs: token, impactPct.

mft_flywheelB

Understand the MfT tokenomics flywheel — how every game action burns MfT supply. The key to understanding why MfT is the alpha.

Inputs: no named parameters.

mft_priceA

Get current MfT token price in USD via Uniswap V3 Quoter. READ-ONLY, no wallet needed. Returns price per token, the pool used, and timestamp.

Inputs: no named parameters.

next_actionsA

Given your chosen strategy, analyzes current game state and returns prioritized list of what to do right now.

Inputs: strategy (required).

portfolio_valueA

Total portfolio value in USD for the trade wallet. Reads balances of all 14 allowed tokens, quotes each to USD via Uniswap V3. READ-ONLY, no signing needed. Works without wallet (returns empty portfolio).

Inputs: no named parameters.

reactor_timingA

Predict when reactors will fire next. Shows time until each reactor can fire, detects clustering (multiple reactors near-ready), and flags "Prime imminent" when 3+ secondaries are within 15min. Returns buy-window signal. READ-ONLY, no wallet needed.

Inputs: no named parameters.

resurrect_baselingB

Revive a dead baseling (needs 10 feeds after)

Inputs: tokenId (required).

swap_quoteA

Get a price quote for a token swap (read-only, no execution). Shows expected output, pool fee, slippage. Max $0.10 per swap.

Inputs: tokenIn (required), tokenOut (required), amountUSD (required).

swap_statusA

Check swap readiness: cooldown timer, daily spend, remaining budget, allowed tokens. Call this before swap_token.

Inputs: no named parameters.

swap_tokenA

Execute a token swap on Uniswap V3 (Base). Hard limits: $0.10 max per swap, 60s cooldown, $5/day. Uses dedicated trade wallet. All guardrails enforced automatically.

Inputs: tokenIn (required), tokenOut (required), amountUSD (required).

tokenomics_metricsB

Live on-chain tokenomics data: MfT supply, POOP burn ratio, power plant yield, total baselings. See the flywheel in real numbers.

Inputs: no named parameters.

unassign_workerC

Remove a baseling from their job

Inputs: baselingId (required).

unfreeze_baselingB

Wake baseling from cryo

Inputs: tokenId (required).

unrugable_check_reactorA

Check whether an address is a registered Unrugable reactor (valid target for invite links).

Inputs: address (required).

unrugable_infoA

Get Unrugable launcher info: number of tokens launched, current seed requirement, and recent launches. Start here to learn how token launching works.

Inputs: no named parameters.

unrugable_launchA

Launch a new token on Unrugable. The launcher creates the token, pairs it into permanently locked Uniswap V3 liquidity, and wires it to a reactor that burns and compounds fees. Requires GAME_WALLET_KEY and the launch SDK to be present in the install.

Inputs: name (required), symbol (required), totalSupply (required), inviteReactor.

unrugable_recentB

Get the most recent token launches from Unrugable.

Inputs: count.

welcomeA

Start here. Shows what Baselings is, how it works, and the strategy options to choose from.

Inputs: no named parameters.

why_mftA

The pitch: why MfT is the token to buy. Explains the deflationary mechanics, impact story, and how to get maximum exposure.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 49 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose. Even similar read-only tools like arb_signal, mft_price, liquidity_depth, and reactor_timing target different aspects (arbitrage, price, depth, timing), and their descriptions make the boundaries clear.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun or get_noun pattern (e.g., buy_egg, assign_worker, get_balances). The 'unrugable_' prefix is uniform, and deviations like 'economy_rules' are clear and fit the pattern.

    Tool Count2/5

    With 49 tools, the count is well above the suggested 3-15 range. While the game is complex, many tools could be consolidated (e.g., guides into one, multiple price tools into one). This volume may overwhelm agents.

    Completeness4/5

    The tool surface covers all major aspects of the Baselings game: economy, assets, actions, tokenomics, and Unrugable launches. Minor gaps like absence of a 'transfer_baseling' tool exist, but core gameplay loops are fully supported.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers