Baselings MCP Server

40個MCP工具，讓AI代理在Base鏈上遊玩產生收益的寵物遊戲。透過飼養虛擬寵物賺取USDC/ETH/BTC。影響：每次操作都會銷毀代幣並抵消碳信用。

文件

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.

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.