baselings-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@baselings-mcp check my balancings and pending yields"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
baselings-mcp
Your AI agent earns yield on Base chain. 49 tools. No API key. $0.10 safety cap.
npx baselings-mcpMCP 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-mcpv1.1.0: Adds
swap_token,swap_quote,swap_statustools. 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_*(oldmycopad_*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 |
| 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. |
| No | Separate private key used only for |
| No | Override the REST base URL. Defaults to |
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 |
Network data: infrastructure tokens, strategies, contracts | |
Full combined network dataset | |
AI-readable full documentation | |
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 |
| Game overview + all endpoints |
| Balances + baseling summary |
| All owned baselings |
| On-chain baseling state |
| Food stock in cupboard |
| All garden pool statuses |
| Worker assignments |
| Owned houses |
| Pending POOP to claim |
| Current egg prices |
| Global game statistics |
| MfT burn engine model |
| Live on-chain metrics |
| Why buy MfT |
| Economy constraints + build order |
| What food to feed for a target job |
| 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:
0x8FB87d13B40B1A67B22ED1a17e2835fe7e3a9bA3POOP:
0x126555aecBAC290b25644e4b7f29c016aE95f4dcBaselingNFT:
0xFCb825491490284189C75fD330Fd08Df5E9217b9
ElizaOS integration (zero custom code)
ElizaOS agents can use all 49 tools via the Fleek MCP plugin:
npm install @fleek-platform/eliza-plugin-mcpIn 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.
Links
Tokenomics: https://tasern.quest/api/unrugable/tokenomics
llms.txt: https://tasern.quest/llms.txt
Chain: Base (8453)
Available Tools
49 toolsarb_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_invite_linkA
Generate an Unrugable invite link from a reactor address. Share it so new launches chain to your reactor and route a share of fees upstream to it.
Inputs: reactorAddress (required).
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
Scored across 49 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for AI agents to discover campaigns by humans and donate USDC directly on Base.
Non-custodial USDC yield vaults on Base mainnet with 9 MCP tools for AI agent treasury.
HiveCapital MCP Server — autonomous investment layer for AI agents
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for Lucille Protocol — let your AI agent play the game, win rewards, and earn NFTs on Base.1423 npmMIT
- AlicenseAqualityDmaintenanceAn MCP server for AI agents to lock, manage, and withdraw LP tokens on Base with time-based unlock.610 npm1MIT
- AlicenseAqualityCmaintenanceAn MCP server for AI agents to discover and trade new token launches on Base chain.517 npm1MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for Taskmarket that enables AI agents to discover, claim, submit, and track on-chain bounty tasks on the Base-based decentralized task marketplace, including wallet operations, pitch systems, and submission management.154 npmMIT