MCP 服务器

baselings-mcp

MCP server for AI agents to play Baselings, a yield-generating pet game on Base chain. Enables agents to manage workers, claim yields, and execute strategies to earn USDC, ETH, or BTC.

README

baselings-mcp

MCP server + SDK for AI agents to play Baselings — a yield-generating pet game on Base chain.

npm install -g baselings-mcp   # or: npx baselings-mcp

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 earning swap fees forever
At skill level 10 ($10 investment), workers keep 40% of throughput as blue chips
Every LP deposit stacks permanently — baselings become yield-generating NFTs

Capital efficiency:

Entry	What you get
$10	1 egg + PP worker → 3,000 POOP/day, 40% as USDC
$25	PP + garden worker → yield + compounding LP
$70	Full 5-baseling squad → self-sustaining pipeline

Impact bonus (free PR, same pipeline): CHAR retires carbon credits. 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 that appreciates from everyone else playing too.

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. The vault earns swap fees for the NFT holder permanently.
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

# Set your game wallet key
export GAME_WALLET_KEY=0x...

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

Claude Desktop config

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

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 (35 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): ensure_approvals, buy_egg, hatch_egg, buy_food, feed_baseling, claim_poop, assign_worker, unassign_worker, deposit_to_garden, buy_house, assign_to_house, unassign_from_house, deposit_usdc, withdraw_usdc

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

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