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.

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenNoOptional: specific token symbol to focus on (e.g. "WETH", "USDC", "cbBTC")

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Since no annotations are provided, the description carries full burden. It clearly states the tool is read-only and requires no wallet, and describes the output format (price per pool, max spread %, arb flag with buy/sell recommendation). No contradictions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three sentences, each serving a distinct purpose: what the tool does, its read-only nature, and what it returns. No redundancy, front-loaded with core action. Perfectly concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 1 optional parameter and no output schema, the description is complete: it explains the purpose, input (optional token focus), output (price per pool, max spread, arb flag), and the threshold for flagging (spread > 1%). No additional context needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with a single optional parameter 'token'. The description adds meaning by specifying it is for focusing on a specific token symbol (e.g., 'WETH', 'USDC', 'cbBTC'), which goes beyond the schema's basic description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool checks MfT price across three specific pools and flags arbitrage opportunities, with a verb ('Check', 'flag') and specific resource ('MfT price across multiple pools'). It distinguishes from siblings like mft_price (likely just price) and swap_token (actual swap).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states 'READ-ONLY, no wallet needed', which guides usage. It implies when to use (to find arb opportunities) but does not explicitly mention when not to use or contrast with alternatives. Sibling tools provide context for differentiation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

assign_to_houseB

Move a baseling into a house

ParametersJSON Schema
NameRequiredDescriptionDefault
houseTokenIdYesHouse NFT token ID
baselingIdYesBaseling token ID

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description fails to disclose behavioral traits like whether this action is reversible, requires approvals, or involves on-chain transactions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no extra words, but it could be more informative while remaining concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description lacks essential context such as what 'move' entails, whether it is a transaction, or what the outcome is. No output schema or annotations to supplement.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and parameter descriptions in the schema are clear. The description adds no additional semantic value beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Move a baseling into a house' provides a specific verb and resource, clearly distinguishing it from sibling tools like 'assign_worker' or 'freeze_baseling'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives, such as whether the baseling must be unassigned or if there are prerequisites for moving.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

assign_workerB

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

ParametersJSON Schema
NameRequiredDescriptionDefault
baselingIdYesBaseling token ID
jobYesJob type
poolPairNoPool pair name for garden/pp jobs (e.g. "burgers", "tgn")
roomIdNoRoom ID for nanny jobs

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries full burden for behavioral disclosure. It does not state whether the tool is mutating, requires permissions, or how it handles pre-existing assignments. The minimal description provides insufficient transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no wasted words. It efficiently conveys the core action and lists job types. Structure is optimal for quick consumption.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 4 parameters (2 required) and no output schema, the description is adequate but incomplete. It does not explain how optional parameters (poolPair, roomId) relate to specific job types, though the schema does. Could be more helpful by linking them.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The description adds no meaning beyond the schema; it lists job types already present in the enum. No extra value provided.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Put a baseling to work') and identifies the resource (baseling) with job types listed. It distinguishes from sibling tools like 'unassign_worker' and 'get_assignments', though could be more precise (e.g., 'assign' instead of 'put').

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives. While sibling names provide context (e.g., 'unassign_worker' is the inverse), the description offers no explicit usage conditions or recommendations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description must fully disclose behavior. It describes a read-only action showing phase and next steps, but does not explicitly state it is safe or non-destructive. The transparency is adequate for a simple state query but lacks explicit safety confirmation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two concise sentences, front-loading the purpose and immediately providing value with the phase-to-role mapping. Every word serves a purpose, with no redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simplicity of the tool (no parameters, no output schema), the description fully conveys what the tool does: shows current phase and next actions, with phase definitions. No additional context is needed for a straightforward query.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are zero parameters, so no parameter description is needed. Schema coverage is 100%, and the description does not need to add parameter details. Baseline score of 4 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states that the tool shows the current economy build phase (1-5) and what to do next, with explicit mapping of phase numbers to roles. This is specific and distinguishes it from sibling tools like economy_rules which explain phases but don't show the current state.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives is provided. The usage is implied as a query to check current phase and next steps, but no when-not-to-use or alternative references are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

buy_eggB

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

ParametersJSON Schema
NameRequiredDescriptionDefault
typeYesEgg type

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description must carry behavioral disclosure. It mentions cost but does not describe what happens after purchase (e.g., where the egg goes, error conditions), nor authorization requirements or balance checks.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Extremely concise (two sentences), front-loaded with key action and cost details, with no extraneous information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Adequate for a simple one-parameter tool without output schema, but lacks information about return value, success/failure behavior, and prerequisites like USDC balance.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Adds concrete pricing information ($0.10 for random, $6 for giant) that is not present in the input schema, which only describes the enum values.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states the action is to buy an egg, specifies it costs USDC, and distinguishes between two types with prices. However, it does not explicitly differentiate from sibling tools like 'hatch_egg'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Implies usage for purchasing eggs, but no explicit guidance on when to use versus alternatives like 'hatch_egg' or when not to use (e.g., if lacking funds).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

buy_foodB

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

ParametersJSON Schema
NameRequiredDescriptionDefault
familyYesFood family
amountUSDCYesAmount in USD (e.g. 0.50 for fifty cents)

TDQS

B3.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Description reveals it consumes USDC and produces LP, indicating a state change. However, no annotations exist, and the description does not disclose side effects, reversibility, or whether it returns a transaction ID. Adequate but not thorough.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence of 11 words, front-loading the key action and effect. No wasted words, though it could include more context in a structured way.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and no annotations, the description is too sparse. It does not explain what LP is, how the conversion works, or any post-action state. An agent may lack sufficient context to use the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and already describes both parameters clearly (food family enum and USDC amount with example). The description adds no additional semantic meaning beyond the schema, so a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the action (buy food from grocery store) and outcome (costs USDC, converts to LP). The verb 'buy' and resource 'food' are specific. It distinguishes from sibling 'buy_egg' implicitly, but could be more explicit about the difference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives like 'feed_baseling' or 'buy_egg'. The description does not mention prerequisites (e.g., having USDC balance) or context (e.g., feeding baselings). Agent may select incorrectly.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

buy_houseB

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

ParametersJSON Schema
NameRequiredDescriptionDefault
houseTypeYesHouse type (0-3)

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must fully disclose behavior. It states the action and effect but omits critical details like cost, permission requirements, or what happens for invalid types. The behavioral disclosure is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise, using a single sentence to convey the core purpose and effect. No redundant or unnecessary words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple buy action with one parameter, the description covers the basic function. However, it lacks details on return values or error conditions, and with no output schema, completeness is adequate but not thorough.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% for the sole parameter. The description restates the type range (0-3), adding no new semantic beyond the schema's own description. Meets baseline but does not enhance understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Buy' and the resource 'house NFT', explains its purpose ('gives rooms for baselings'), and specifies the type range (0-3). This distinguishes it from sibling tools like 'assign_to_house'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives, such as prerequisite conditions (e.g., needing funds) or post-purchase steps. The description does not mention context-specific usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

choose_strategyA

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

ParametersJSON Schema
NameRequiredDescriptionDefault
strategyYesStrategy key

TDQS

A3.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It mentions 'Returns full playbook' but omits behavioral details like side effects, authorization needs, or rate limits. It is unclear if the tool is read-only or has any impact on the game state.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that front-loads the main action ('Pick your play style') and lists options. No redundant words or extraneous details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's low complexity (one parameter, no output schema) and the lack of annotations, the description adequately explains what the tool does and what it returns. However, it could be improved by subtly clarifying that this is a selection, not a mutation, or by adding a brief note on the 'playbook' content.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema only describes the parameter 'strategy' as a 'Strategy key' with enums. The description adds meaningful context by explaining each strategy's theme (e.g., green for impact/carbon, meme for specific tokens), which helps the agent select the correct value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Pick your play style' and lists the exact strategies available. It distinguishes itself from sibling tools like 'swap_token' or 'buy_egg' by focusing on strategy selection.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when a player wants to choose a strategy, but it does not provide explicit when-to-use or when-not-to-use guidance relative to alternatives. No exclusions or context about prerequisites are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

claim_poopB

Claim pending POOP rewards for your baselings

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenIdsYesArray of baseling token IDs to claim for

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It states the action but does not disclose behavioral traits such as whether it is a transaction (gas fees, irreversible), if it requires approvals, or what happens on failure. Minimal transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence with no unnecessary words. Front-loaded with the verb and resource. Highly concise and clear.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple claim action with one parameter, the description covers the basic purpose but lacks behavioral context (e.g., transaction implications, success/failure responses). No output schema, so return values are not explained. Adequate but not complete for an AI agent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema has one parameter with a clear description ('Array of baseling token IDs to claim for'). Schema description coverage is 100%, so description adds no additional meaning beyond what the schema already provides. Baseline 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's action ('Claim pending POOP rewards') and the target resource ('your baselings'), with a specific verb and resource. It distinguishes from siblings like 'get_pending_poop' which is a read operation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives (e.g., when there are pending rewards, prerequisites like having baselings with unclaimed POOP, or that it should be used after checking pending rewards). Only implied usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

deposit_gardenB

Deposit POOP into a garden pool for yield

ParametersJSON Schema
NameRequiredDescriptionDefault
poolPairYesPool pair name (e.g. "burgers", "tgn", "brett")
amountYesAmount of POOP in wei (e.g. "1000000000000000000" for 1.0)

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, and the description gives minimal behavioral context—it states the action but does not disclose side effects (e.g., modifies pool state), requirements (e.g., prior approval), or what happens on failure (e.g., reverting transaction).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that conveys the essential action without any unnecessary words or repetition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and no annotations, the description fails to inform the agent about the result of the deposit (e.g., pool tokens, yield accrued) or any post-call state changes, leaving critical context missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, and the description adds no additional meaning beyond what the schema already provides for the two parameters. The baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'deposit', the resource 'POOP into a garden pool', and the purpose 'for yield'. It distinguishes itself from sibling tools like 'swap_token' and 'buy_egg' by specifying the unique action and target.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when the agent wants to deposit POOP into a garden pool for yield, but lacks explicit guidance on when to use this tool versus alternatives or prerequisites such as having sufficient POOP balance or approvals.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

economy_rulesA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description correctly indicates the tool is read-only and returns data (no destructive effects). It adds context about what specific constraints are returned, but does not detail response format or potential size. Given the simplicity, this is adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences: the first clearly states returned content, the second gives a use hint. No wasted words; front-loaded with essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is complete for a simple informational tool with no parameters and no output schema. It lists the key categories. However, it could mention the output format (e.g., structured data vs. free text) for better agent understanding.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are zero parameters, so the description logically adds no parameter info. The schema coverage is 100%, and the baseline for no params is 4. The description does not need to elaborate further.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a clear verb ('Returns') and specifies the resource ('economy constraints'), listing concrete items like POOP delay, keeper cycle, etc. It distinguishes itself from sibling tools (e.g., buy_egg, get_balances) by being a read-only informational tool rather than an action or data retrieval tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'Read this before playing' provides explicit usage context, implying the tool is for initial learning or decision-making. However, it does not mention when not to use it or suggest alternatives like game_guide, which might also be relevant.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ensure_approvalsA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided; description only states it sets up approvals without disclosing behavioral details like effects, reversibility, required permissions, or what tokens are involved.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence that is concise and front-loaded with key information; no wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple setup tool with no parameters or output schema, the description is adequate but could benefit from explaining what approvals are set and any side effects or prerequisites.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters in schema, so description cannot add more; baseline score of 4 is appropriate as no parameter elaboration is needed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Set up' and the resource 'token approvals', and distinguishes from sibling tools as an initialization step to be run before write actions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit guidance to 'run this first before any write actions', indicating when to use it, though lacks mention of when not to use or alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

feed_baselingC

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

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenIdYesBaseling token ID
foodTypeYesFood type to feed
amountYesAmount of food LP in wei (e.g. "1000000000000000000" for 1.0)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It discloses two key effects (hunger increase, delayed POOP) but omits critical details such as food consumption, approval requirements, or transaction outcomes. The delay parameter is mentioned but not explained.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One sentence with a parenthetical detail. Front-loaded verb and resource. Could be slightly more descriptive without being verbose, but overall efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (game with delayed reward, multiple tokens, no output schema), the description is incomplete. It doesn't explain how to claim POOP, what happens to food inventory, or any confirmation of the action. Siblings like claim_poop suggest separate steps, but this isn't linked.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description adds no additional meaning beyond the schema. For example, it doesn't explain what each foodType does or how amount affects the game mechanics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action 'Feed a baseling' and the effects: increases hunger and earns POOP after 4hr delay. It distinguishes from siblings like buy_food or feeding_guide, but could be more specific about the exact resource being modified.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives like claim_poop or buy_food. No prerequisites or exclusions mentioned. The agent must infer context from sibling names, which is insufficient.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

feeding_guideA

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

ParametersJSON Schema
NameRequiredDescriptionDefault
targetJobYesThe job you want this baseling to do

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description indicates an informational guide ('maps food→stat→job optimization') but doesn't explicitly state that it is read-only, non-destructive, or that it does not perform any feeding action. The behavioral implications are inferential rather than explicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise and front-loaded, using two short sentences that efficiently convey the tool's purpose and functionality without unnecessary words or fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

While the description explains the tool's purpose, it lacks details about the output format or return value (e.g., list of foods, stats per food). Given there is no output schema, more context on what the user can expect would improve completeness.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% as the single parameter 'targetJob' is well-described with an enum and schema description. The tool description adds context about optimization mapping but does not provide new semantic details beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states that the tool provides food recommendations based on a baseling's target job, using a mapping from food to stat to job optimization. It distinguishes itself from siblings like 'feed_baseling' which actually performs feeding, and 'buy_food' which is about purchasing.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies use when needing to know optimal food for a job, but lacks explicit guidance on when to use this tool versus similar ones like 'feed_baseling' or 'get_food_stock'. No when-not or alternative suggestions are provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
reactorAddressYesReactor contract address to fire (e.g. "0xed3aE91b2bb22307c07438EEebA2500C18EABcFE" for V1 Prime)

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description fully discloses the tool's effects: collecting LP fees, burning tokens, deepening liquidity, sending 5% upstream, and causing price dislocation. It also notes gas cost and permissionless access, providing sufficient behavioral transparency for safe selection.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise, using 5 short sentences that front-load the core action. Each sentence adds distinct value (mechanism, frequency, cost, consequence), with no superfluous information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having no output schema, the description provides a complete picture of what the tool does, its mechanism, preconditions (permissionless, 2-hour interval), cost, and post-action effects (arb opportunity). This is sufficient for an agent to understand when and why to invoke it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already describes the only parameter ('reactorAddress') as the reactor contract address. The description does not add new semantic information beyond the schema, and with 100% schema coverage, a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool fires a reactor and triggers a specific DeFi mechanism (burn+compound). It uses a specific verb ('fire') and resource ('reactor'), and distinguishes from sibling tools like 'unrugable_check_reactor' by focusing on execution rather than inspection.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description mentions the cooldown period ('every 2 hours'), gas cost, and resulting price dislocation, giving clear context for when to use. It does not explicitly list exclusions or alternatives, but the permissionless nature and timing constraint are well-communicated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

freeze_baselingC

Put baseling in cryo storage

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenIdYesBaseling token ID

TDQS

C2.7/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description must disclose behavioral traits. It only states a vague action ('put in cryo storage') without explaining whether freezing is reversible, what permissions are needed, or what happens to the baseling.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no extraneous words, achieving high efficiency. However, it could be slightly expanded without losing conciseness to improve informativeness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one required parameter, the description is somewhat complete on the surface, but it lacks critical context about effects, prerequisites, and reversibility, especially given the absence of annotations and output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already describes the single parameter 'tokenId' as 'Baseling token ID'. Since schema coverage is 100%, the description adds no additional meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('put baseling in cryo storage') using a specific verb and resource. It distinguishes the tool from siblings like 'unfreeze_baseling' by implication, though it does not explicitly differentiate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. The sibling tools 'unfreeze_baseling' and 'resurrect_baseling' exist, but the description does not clarify the context or conditions for freezing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

game_guideB

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It only states it is a guide, implying read-only behavior but does not confirm no side effects, authentication needs, or rate limits. No additional context such as output format or data source is given.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that efficiently conveys the tool's purpose and key content areas. It is front-loaded with the main idea. While it could be slightly more structured (e.g., enumerated points), it is concise and clear.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has no parameters and no output schema, the description is moderately complete. However, it doesn't specify what the output looks like (e.g., formatted text, JSON) or the expected scope (e.g., covers all game aspects). For a comprehensive guide, more context on return format would help.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, so schema coverage is 100%. The description does not need to add parameter details since none exist. Baseline score is 4, and the description is adequate for a parameterless tool.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it's a detailed how-to-play guide covering rate limits, tips, and mechanics. It effectively communicates the tool's purpose as an informational resource. However, it does not differentiate from sibling tools like feeding_guide or economy_rules, which may also provide guides on specific aspects.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It does not specify contexts (e.g., 'use for general overview') or exclusions (e.g., 'not for specific mechanics'). An agent has no basis to choose this over other guide-like tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_assignmentsB

See which baselings are working and where

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so the description carries full burden. It states the tool shows working baselings and locations, implying a read-only, non-destructive operation. However, it does not disclose potential side effects, permissions, or rate limits, but for a simple get with no parameters, this is minimally adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no unnecessary words. Every word serves a purpose, efficiently conveying the tool's function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema and no annotations, the description provides basic functionality but lacks details on output format, field descriptions, or how 'working' is defined. It is minimal but adequate for a simple query tool without parameters.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0 parameters, baseline is 4. The description adds meaning beyond the empty schema by explaining what the tool returns ('which baselings are working and where'), fulfilling the need for context.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'See which baselings are working and where' uses a clear verb ('See') and resource ('baselings working and where'), indicating a read operation. It distinguishes from sibling tools like assign_worker and unassign_worker by implying a listing function, though 'See' could be more specific like 'List'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives (e.g., assign_worker, unassign_worker). The description lacks context on typical scenarios or prerequisites, leaving the agent to infer from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_balancesA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so the description must convey behavior. It indicates a non-destructive read operation ('check'), but lacks details on data freshness, authentication, or whether balances include staked or pending amounts. Basic sufficiency for a simple read, but gaps remain.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single concise sentence with no wasted words. Front-loaded with the action and included token examples. Excellent conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema, so the description should clarify return format or coverage. Only lists four tokens, but the name and sibling tools suggest broader scope. Lacks information on whether all balances are returned or just those tokens, and the response structure is undefined.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters exist (0 count, schema coverage 100% trivially). Per rules, baseline is 4. The description does not need to add parameter info since there are none, but it does not hinder either.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool retrieves wallet balances and lists specific tokens (ETH, USDC, POOP, WETH). The verb 'check' and resource 'wallet balances' are specific, and it distinguishes from siblings like 'portfolio_value' which likely calculates total value.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives (e.g., 'portfolio_value', 'get_pending_poop'). Usage is implied as 'checking your balances', but context about prerequisites or exclusion of other balance-related tools is absent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_baselingC

Get detailed on-chain info about one baseling

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenIdYesBaseling token ID

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, and the description fails to disclose that this is a read-only operation, any authentication needs, or what 'detailed' entails. The behavioral burden is unaddressed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence, front-loaded with key information. No wasted words, though it is somewhat spartan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, no annotations, and a single parameter, the description is minimal. An agent lacks context for expected return value or side effects, making it incomplete for confident use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with a clear description for tokenId. The tool description adds no extra meaning beyond the schema, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (Get), the resource (detailed on-chain info), and the scope (one baseling). It distinguishes from sibling 'get_my_baselings' by implying a single token focus, though not explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like get_my_baselings or other get tools. No prerequisites or usage context provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_egg_pricesB

Current egg prices in M currency

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of disclosure. It states 'Current egg prices' but does not clarify if the data is a snapshot, real-time, or historical. No mention of side effects or read-only behavior, though it is implied by the getter pattern.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise (6 words) with no wasted text. Every word adds meaning, and the structure is front-loaded with the key action and resource.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple zero-parameter price query tool without an output schema, the description is fairly complete. However, it could be improved by clarifying what 'M currency' refers to or whether prices are dynamic.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 0 parameters and 100% description coverage. Since there are no parameters to document, the description does not need to add parameter semantics. A baseline score of 4 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool returns current egg prices in M currency. It uses a specific verb ('get') and resource ('egg prices'), but does not differentiate from sibling tools like mft_price or swap_quote that also provide pricing information.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. No context is given about prerequisites or typical usage scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_food_stockA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. Only states it's a 'check' operation; no disclosure of non-obvious behaviors like caching, rate limits, or data freshness. Minimal behavioral info.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence, efficient, front-loaded with key info. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Simple read operation with no parameters; description covers purpose and returned data types. Could mention return format or data freshness, but not essential for usability with no params.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has 0 parameters; description adds no parameter info, but baseline is 4. No need for further detail.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states verb 'check' and resource 'food in your cupboard', listing specific attributes (amount, spoiled status, time until spoil). Clearly distinct from sibling tools like 'buy_food' and 'feed_baseling'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Implied usage (to check food stock), but no explicit guidance on when to use vs alternatives or when not to use. Could be improved with context of typical scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_garden_statusA

Check all garden pools (workers, yields)

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full responsibility for behavioral disclosure. It only indicates 'Check' which implies read-only, but fails to disclose any permissions needed, side effects, rate limits, or output format. The lack of detail limits agent understanding of operational constraints.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence with no redundant words. It front-loads the action and resource, and every word contributes to clarity. It is appropriately sized for a simple no-parameter tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given zero parameters and no output schema, the description is minimally adequate. It states the core functionality but does not explain the output structure or any subtleties about garden pools. For a simple check, it is sufficient but lacks completeness for an agent to fully understand what to expect.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, and schema coverage is 100%. Since there are no parameters, the description does not need to add parameter information. The baseline for zero parameters is 4, and the description meets this adequately.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'Check' and clearly identifies the resource 'all garden pools' with clarification that it includes workers and yields. It distinguishes itself from sibling tools like 'get_assignments' or 'get_balances' which target different resources.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, no indications of prerequisites or edge cases. It simply states what it does without context for agent decision-making.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_global_statsA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must fully convey behavioral traits. It only states what statistics are returned, with no mention of read-only nature, performance implications, or side effects. This is insufficient for full transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence, front-loading the key information 'Game-wide statistics'. No extraneous content; every word contributes to understanding.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with no parameters and no output schema, the description gives a basic idea of the returned data. However, it could list all included statistics or clarify the response structure, leaving some ambiguity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, so the description does not need to explain parameters. According to guidelines, baseline score of 4 applies; the description adds no param information but also doesn't need to.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool returns global game statistics, naming specific examples (total baselings, POOP minted/burned). This distinguishes it from sibling tools that focus on individual or specific data points.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description does not provide explicit guidance on when to use this tool versus alternatives. While its purpose is clear, the lack of context about preferred scenarios or exclusions limits decision-making for an AI agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_housesA

List your houses and who lives in them

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description minimally implies a read-only operation via 'list'. However, it does not disclose auth needs, rate limits, or scope (e.g., if 'your houses' means owned or visible). Adequate but not rich.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Extremely concise – one sentence, seven words. Front-loaded with the verb and resource. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter tool with no output schema, the description is adequate but lacks detail on return format, pagination, or user scope. Could be more complete but meets minimum needs.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters – baseline 4 per guidelines. The description adds no parameter info, but none is needed since schema coverage is complete (100% of 0 params).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'List your houses and who lives in them' clearly states the verb (list) and the resource (houses, inhabitants). It distinguishes from sibling tools like get_my_baselings or get_assignments, which cover different data.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. There is no mention of context, exclusions, or when not to use it among a list of 50+ sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_my_baselingsA

List all your baseling pets with their stats

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It states 'list' which suggests a read operation, but does not explicitly confirm idempotency, authentication needs, or what 'stats' entails. Lacks detail for safe invocation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence of 8 words, concise and front-loaded. Every word is necessary and there is no verbosity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with no parameters and no output schema, the description adequately explains its purpose. However, it lacks detail on the structure of 'stats' or pagination, but the tool's simplicity makes it largely complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has no parameters (0 params, 100% coverage). The description adds meaningful context by specifying the tool returns the user's own baselings with their stats, which goes beyond the empty schema. Baseline for 0 params is 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'list' and clearly identifies the resource 'your baseling pets with their stats'. It distinguishes itself from siblings like 'get_baseling' (singular) and 'get_global_stats'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for listing the user's own baselings but provides no explicit guidance on when to use this tool versus alternatives like 'get_baseling' for a single pet or 'get_global_stats' for global data.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_pending_poopB

Check claimable POOP for your baselings

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenIdsYesArray of baseling token IDs

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden of behavioral disclosure. It correctly labels it as a 'check' (read operation) but fails to mention authentication needs, rate limits, or whether the data reflects pending or confirmed state.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The single sentence is concise and front-loaded with the key action. However, a brief mention of the return shape could improve clarity without adding much length.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a low-complexity read tool, the description is adequate but lacks details on what exactly 'claimable' means (e.g., pending rewards, unharvested) and whether the output is per-baseling or aggregated.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already fully describes 'tokenIds' as an array of numbers, and the description adds the context 'for your baselings', indicating ownership. This adds minor value over the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Check claimable POOP for your baselings' uses a specific verb ('Check') and resource ('claimable POOP'), and clearly distinguishes from the sibling tool 'claim_poop' by indicating it is a read operation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It does not mention prerequisites, exclusions, or that it is a read-only precursor to 'claim_poop'.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It states read-only and lists return fields (name, address, pool count, fire-readiness, cooldown). This adequately discloses behavior without contradiction.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with purpose, no wasted words. Every sentence provides essential information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no parameters and no output schema, the description fully explains what the tool does and what it returns. It is complete for an agent to understand and use correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters, and schema coverage is 100% trivially. The description adds value by listing the specific return fields, which is useful beyond the empty schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool lists all known reactors with fire-readiness status, using a specific verb ('List') and resource ('reactors'). It distinguishes from sibling tools like 'fire_reactor' and 'reactor_timing' by focusing on listing and status.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states it is read-only and requires no wallet, giving clear context for when to use. It does not mention when not to use or alternatives, but the context is sufficient for safe usage.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

hatch_eggC

Hatch an egg into a baseling

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenIdYesEgg token ID to hatch

TDQS

C2.6/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, and the description gives no behavioral details. It does not disclose whether the egg is consumed, if there are costs, prerequisites, or what happens upon hatching. This is a critical gap for a mutation tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise, but it sacrifices necessary information. While efficient, it lacks the detail needed for an agent to understand usage and behavior.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no annotations or output schema, the description should compensate with more detail on return values, side effects, and prerequisites. It fails to provide a complete picture for this simple tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% for tokenId, and the schema already describes it as 'Egg token ID to hatch'. The description adds no additional semantics, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (hatch) and the resource (egg) and the result (baseling). It distinguishes from siblings like buy_egg or feed_baseling. However, it could be more specific about what 'baseling' means in context.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. The agent is left to infer that it should be used when an egg token is available, but no prerequisites, exclusions, or side effects are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenNoToken symbol (default: MfT). Checks all pools for this token.
impactPctNoPrice impact percentage to calculate depth for (default: 2.0 = 2%)

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It discloses READ-ONLY, no wallet needed, and describes internal state reading. However, it does not cover error cases or permissions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is only two sentences plus a brief note, front-loaded with key purpose, and no unnecessary information. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description explains what is returned (per-pool depth, health classification, max profitable trade size). It could detail output structure further, but is sufficient for a simple tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, but the description adds context: 'Measure how much USD can be traded before moving price by X%' clarifies impactPct, and 'Checks all pools for this token' adds meaning beyond schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool measures USD trade amount before price moves by X%, reads V3 pool state, returns per-pool depth, health classification, and max profitable trade size. It is specific and distinguishes from siblings like swap_quote or mft_price.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for MfT arb pools and mentions it's read-only, but does not explicitly state when to use or not use compared to alternatives. No sibling differentiation is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

mft_flywheelB

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description implies a read-only informational tool but does not explicitly state that it has no side effects or requires no permissions. The behavioral impact is implicitly safe, but transparency could be enhanced by stating it is a knowledge query.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two concise sentences that front-load the core purpose. Every word serves a clear function with no fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no parameters and no output schema, the description explains what the tool does but does not mention what the output looks like (e.g., text summary). It is adequate for a simple informational tool but could be more specific.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has no parameters, so the description does not need to explain parameters. Schema coverage is 100%, and the description adds no redundancy. A higher score is not warranted because there is no parameter information to add.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description specifies a clear purpose: understanding the MfT tokenomics flywheel, specifically how game actions burn MfT supply. It distinguishes from siblings like 'tokenomics_metrics' by focusing on the conceptual flywheel mechanism rather than numerical metrics.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description offers no explicit guidance on when to use this tool versus alternatives like 'why_mft' or 'tokenomics_metrics'. It merely states the function without contextual usage advice.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so the description carries the full burden. It discloses read-only nature, no wallet requirement, and specifies return values (price, pool, timestamp). This adds useful context beyond the empty schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with purpose, no wasted words. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no parameters and no output schema, the description provides complete context: what it does, how it works, and what it returns. No gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema has 0 parameters with 100% coverage (none needed). Baseline is 4; description does not need to add param info.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Get', the resource 'MfT token price in USD', and the method 'via Uniswap V3 Quoter'. It is specific and distinguishes from siblings like swap_quote and liquidity_depth.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by stating 'READ-ONLY, no wallet needed', but does not explicitly provide when-to-use/not-use guidance or mention alternatives among siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

next_actionsA

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

ParametersJSON Schema
NameRequiredDescriptionDefault
strategyYesYour chosen strategy

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must convey behavior. It states the tool 'analyzes current game state and returns prioritized list,' suggesting a read-only operation. However, it does not explicitly confirm lack of side effects, permissions needed, or other behavioral details.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that front-loads the key information: input (strategy), action (analyzes), and output (prioritized list). No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one parameter and no output schema, the description adequately covers what the tool does and what input it requires. It could briefly mention the output format, but 'prioritized list' gives sufficient context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description adds no additional meaning beyond the schema's 'Your chosen strategy' and enum values. It merely restates the parameter context without enriching it.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: given a strategy, it analyzes the game state and returns a prioritized list of immediate actions. This distinguishes it from siblings like 'choose_strategy' (strategy selection) and 'game_guide' (general guidance).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage after a strategy is chosen ('Given your chosen strategy'), but it does not explicitly state when to use or not use this tool, nor does it mention alternatives. The prerequisite is implied but not spelled out.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden. It discloses read-only nature, no signing needed, behavior without wallet (returns empty), and use of Uniswap V3. This is informative but omits potential rate limits or latency. Still, it covers key behavioral traits well for a simple query.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences. First states core purpose, second adds constraints and edge case behavior. No redundancy, all sentences earn their place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, description explains the output (total portfolio value in USD) and tool behavior sufficiently. It mentions token scope and fallback case. Minor omission: return format (number) could be explicit, but adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema has 0 parameters (100% coverage). Baseline is 4 per rules for 0 params. Description adds full meaning by explaining what the tool computes and how (token balances, Uniswap V3 quoting). No further parameter info needed; description compensates completely.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states verb 'reads' and resource 'portfolio value in USD for the trade wallet'. It specifies token scope and quoting mechanism. However, it does not explicitly differentiate from sibling tools like get_balances or mft_price, which could be confused for similar purposes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Description provides context: it is read-only and works without a wallet. It implies safe usage but does not specify when not to use it or suggest alternative tools for more granular data (e.g., get_balances). No explicit exclusions or comparative guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Discloses read-only nature and that no wallet is needed, which is valuable since no annotations exist. Lists outputs but does not mention freshness or rate limits; adequate for a prediction tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no filler, front-loaded with main action and outputs. Highly efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, description provides a high-level summary of return values but lacks specifics on format (e.g., list vs. single value). Adequate for a simple tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters in schema, so description carries full burden. It explains what the tool returns beyond the empty schema, including multiple signals. Baseline 4 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: predicting reactor fire timing, with specific outputs (time, clustering, prime imminent, buy-window signal), differentiating it from siblings like 'fire_reactor' and 'get_reactor_list'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied through context, but no explicit guidance on when to use this vs. other timing/analysis tools; no alternatives or exclusions mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

resurrect_baselingB

Revive a dead baseling (needs 10 feeds after)

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenIdYesBaseling token ID

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It mentions a mutation (revive) and a requirement, but does not disclose side effects, authorization needs, or state changes beyond the implied revival.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single short phrase that is front-loaded. It is concise with no wasted words, though it lacks structured detail.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema and minimal description, the tool lacks completeness. It does not explain success/failure conditions, prerequisites for the baseling being 'dead', or what 'needs 10 feeds after' implies mechanistically.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The parameter tokenId has 100% schema description coverage ('Baseling token ID'), and the tool description adds no additional meaning beyond the schema. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action 'revive' and the resource 'dead baseling', with a specific prerequisite. It distinguishes from sibling tools like feed_baseling or freeze_baseling.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage when a baseling is dead and mentions a post-condition (needs 10 feeds), but provides no explicit guidance on when to use this tool versus alternatives, nor exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenInYesToken symbol or address to sell (e.g. "USDC" or "0x833...")
tokenOutYesToken symbol or address to buy (e.g. "MfT" or "0x8FB...")
amountUSDYesAmount in USD (max 0.10)

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden. It discloses read-only nature, non-execution, and cost constraint, but lacks details on failure modes, staleness, or rate limits. Adequate but not exhaustive.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences with no extraneous information. Front-loaded with purpose and key details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is complete enough for a simple quote tool with 3 parameters and no output schema. It covers purpose, behavior, and a constraint. Could mention return format but not necessary.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description does not add new parameter information beyond what the schema already provides (e.g., token symbols, address format, max amount).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool provides a price quote for a token swap, specifies it is read-only with no execution, and lists what it shows (expected output, pool fee, slippage). This distinguishes it from siblings like swap_token (execution) and swap_status (status of executed swap).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implicitly guides usage by stating it is read-only and has a max limit of $0.10, suggesting it should be used before executing a swap. However, it does not explicitly mention alternatives or when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

swap_statusA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. Description implies read-only (check) but does not explicitly declare non-destructive nature or other constraints. Adequate but could state that it does not modify state.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences, front-loaded with purpose and key items, no wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, description lists expected fields but not their structure. Still sufficient for a check tool with simple return. Minor gap in not specifying return format.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters, so schema coverage is 100% trivially. Description adds value by explaining what the output conceptually contains, beyond the empty schema. Baseline 4 with no params.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States specific verb 'check' and resource 'swap readiness', listing specific items (cooldown timer, daily spend, remaining budget, allowed tokens), and distinguishes from sibling swap_token.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly advises 'Call this before swap_token', providing clear when-to-use and linking to a sibling tool, which helps agent select correctly.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenInYesToken symbol or address to sell (e.g. "USDC" or "0x833...")
tokenOutYesToken symbol or address to buy (e.g. "MfT" or "0x8FB...")
amountUSDYesAmount in USD (max 0.10)

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of disclosing behavior. It specifies hard limits ($0.10 max, 60s cooldown, $5/day), a dedicated trade wallet, and automatic guardrails. This is strong but could mention what the tool returns (e.g., transaction hash) or if it requires prior approvals.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences, both essential. First sentence states the core action, second lists constraints. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers platform, limits, and wallet details. However, it lacks guidance on prerequisites (e.g., need approvals) and does not describe the return value or how to interpret results. Given the tool's complexity and no output schema, a bit more context would be beneficial.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, and each parameter already has a clear description. The tool description does not add new semantics beyond what the schema provides (e.g., max 0.10 is repeated). Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the purpose: 'Execute a token swap on Uniswap V3 (Base).' It uses a specific verb-resource pair and distinguishes from sibling tools like swap_quote (quote vs execution) and swap_status (status check).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description mentions hard limits and guardrails, implying safe usage, but does not explicitly say when to use this tool versus alternatives (e.g., after obtaining a quote from swap_quote). No when-not-to-use guidance is provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tokenomics_metricsB

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description must disclose behavior. It indicates live read-only data but lacks details on caching, rate limits, or what 'live' means (e.g., real-time vs. recent). Adequate for a simple read tool but not thorough.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences with key information front-loaded. No wasted words. Efficiently communicates the tool's purpose and the data it provides.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no parameters, no output schema, and no annotations, the description is sufficient for a basic data retrieval tool. However, it does not specify the output format or whether it returns historical data, which could help agents compare with sibling tools like economy_rules.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters exist, so schema coverage is trivially 100%. The description adds value by listing the returned metrics but does not explain their units or definitions beyond the names. Baseline score applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it provides live on-chain tokenomics data and lists specific metrics (MfT supply, POOP burn ratio, etc.). It distinguishes itself from siblings like mft_flywheel and mft_price by focusing on a set of numeric values, though it doesn't explicitly contrast them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives. It implies use for tokenomics data but doesn't mention exclusions or prerequisites. For a tool with 0 parameters and many siblings, more context would help.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

unassign_workerC

Remove a baseling from their job

ParametersJSON Schema
NameRequiredDescriptionDefault
baselingIdYesBaseling token ID to unassign

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must stand alone. It only says 'remove', implying a destructive action, but does not disclose reversibility, permissions, or consequences.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

One concise sentence without fluff. However, it may be too brief for a tool with no annotations or output schema.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simple tool (1 parameter, no output schema, no annotations), the description is minimal. It does not explain the result of unassignment or the state change, leaving gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with one parameter 'baselingId' described as 'Baseling token ID to unassign'. The description adds no extra meaning beyond the schema, so baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (remove) and the resource (baseling from their job). It distinguishes from sibling tools like assign_worker, but could be more specific about what 'job' means.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives like freeze_baseling or assign_worker. The description does not mention prerequisites, side effects, or context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

unfreeze_baselingB

Wake baseling from cryo

ParametersJSON Schema
NameRequiredDescriptionDefault
tokenIdYesBaseling token ID

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description must disclose behavior. It only states the action but does not mention side effects (e.g., resource cost, cooldowns), required permissions, or whether it can fail. For a mutation tool, this is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Extremely concise at 4 words, no filler. Front-loads the action. However, slight under-specification prevents a perfect score.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one parameter, the description is adequate but could mention that 'cryo' refers to frozen state or that the tool requires no other inputs. Absence of output schema is acceptable as return values are likely straightforward.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the parameter is well-described in the schema ('Baseling token ID'). The description adds no extra meaning beyond the schema. Baseline 3 is appropriate as the schema already carries the full burden.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Wake') and resource ('baseling from cryo'), clearly indicating the action of reactivating a frozen baseling. Distinguishes from sibling 'freeze_baseling' and 'resurrect_baseling' by implying reverse of freeze. However, 'cryo' is informal and not fully defined.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives like 'freeze_baseling' or 'resurrect_baseling'. Implied context is only that it reverses a freeze, but lacks when-not or prerequisite conditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

unrugable_check_reactorA

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

ParametersJSON Schema
NameRequiredDescriptionDefault
addressYesReactor address to check

TDQS

A4.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It accurately describes a read-only check but omits details such as the return type (e.g., boolean, or throws error if invalid), error handling, or any side effects. For a simple query tool, this is minimally adequate but could be more transparent.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence that conveys the entire purpose without extraneous words. Every word is necessary, achieving maximum conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (one parameter, no nested objects, no output schema), the description provides sufficient context for an agent to understand what the tool does. It is complete for its scope, similar to the get_calls example which had no output schema but scored 5.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema coverage is 100% with one parameter, and the description ('Reactor address to check') duplicates the schema's description exactly. No additional semantic information is provided beyond what the schema already offers, meeting the baseline for high coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Check'), the target resource ('address'), and the specific domain ('registered Unrugable reactor (valid target for invite links)'). It distinctly differentiates from sibling tools like unrugable_info (info about a reactor) and unrugable_invite_link (generate invite links).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies that this tool is for verifying reactor validity before using invite links, which provides context. However, it does not explicitly state when not to use it (e.g., if the address is not a reactor, or that this is a read-only check). Given sibling tools exist for other operations, the guidance is clear but not exhaustive.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

unrugable_infoA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It describes what the tool returns but does not explicitly state that it is read-only or non-destructive. The name and description imply a safe info retrieval, but this is not confirmed.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, no wasted words. Purpose is front-loaded, and the description is efficient and clear.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description lists key return fields (number of tokens, seed requirement, recent launches) which is adequate for a simple info tool. Without an output schema, this explains the response sufficiently, though a little more detail on format would improve it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, and schema coverage is 100% trivially. The description adds no param information because none are needed. Baseline for 0 parameters is 4, and the description suffices.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the tool retrieves Unrugable launcher info including number of tokens launched, seed requirement, and recent launches. It also positions itself as a starting point for learning about token launching, distinguishing it from siblings like unrugable_launch or unrugable_recent.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'Start here to learn how token launching works' implies this is the initial tool to use among the unrugable family. However, it does not explicitly state when not to use it or provide alternatives, leaving some ambiguity.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesToken name (e.g. "My Token")
symbolYesToken ticker (e.g. "MTK")
totalSupplyYesTotal supply (e.g. "1000000")
inviteReactorNoReactor address that invited you (optional, defaults to MfT Prime)

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Discloses key behaviors: token creation, permanently locked Uniswap V3 liquidity, reactor fee burning/compounding. Since no annotations exist, this adequately informs the agent of effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, front-loaded with action, no redundancy. Every sentence provides necessary information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers the token launch process and prerequisites adequately. Missing output details but acceptable given no output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers 100% of parameters with descriptions. The tool description adds no extra parameter-specific guidance beyond the overall workflow. Baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states 'Launch a new token on Unrugable' with specific verb and resource. Describes creation, liquidity pairing, and reactor wiring, distinguishing it from sibling unrugable_* tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Lists prerequisites (GAME_WALLET_KEY and SDK) but does not explicitly state when to use this tool versus alternatives. Usage context is implied but not contrasted with siblings.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

unrugable_recentB

Get the most recent token launches from Unrugable.

ParametersJSON Schema
NameRequiredDescriptionDefault
countNoNumber of recent launches (default 5, max 20)

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description must disclose behavioral traits. It only says 'Get' implying read-only, but no details on limitations, auth needs, or side effects.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence with no wasted words; front-loaded and appropriately sized for a simple list tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Adequate for a simple read tool with limited parameters and no output schema, but could mention ordering or default behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage of 'count' parameter is 100%, so description does not need to add meaning. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states verb 'Get' and resource 'most recent token launches' from Unrugable. It distinguishes from sibling tools like 'unrugable_info' and 'unrugable_launch'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives, no exclusions or prerequisites mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

welcomeA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description implies a read-only operation by saying 'Shows'. With no annotations provided, the description carries the full burden. It is sufficient for a simple informational tool with no side effects, though it doesn't detail response format or behavior if called multiple times.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Extremely concise with two sentences. 'Start here.' is a clear directive, and the second sentence explains content. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given zero parameters and no output schema, the description adequately explains what the tool does. It covers the tool's purpose without needing additional details.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

No parameters exist (0 params, 100% schema coverage), so baseline score is 4. The description does not need to add parameter info.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it shows what Baselings is, how it works, and strategy options. The phrase 'Start here' implies it's an introductory tool, but it does not explicitly differentiate from sibling informational tools like 'game_guide' or 'feeding_guide', so a slight deduction.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this vs other informational tools. The only hint is 'Start here', which suggests it's the first tool to use, but no explicit when-not or alternatives are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

why_mftA

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

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, and the description does not disclose behavioral traits such as read-only nature, side effects, or permissions. It only describes content, not safety or performance characteristics, leaving the agent to assume it's safe but without confirmation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the key purpose, and each sentence adds value with specific topics (deflationary mechanics, impact story, exposure). No fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema or annotations, the description covers purpose and content adequately but lacks details on output format (e.g., text, markdown) or interaction model. For a simple informational tool, this is minimally complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, and schema coverage is 100% trivially. The description adds no parameter information, but the baseline is 4 for tools with no parameters, and there is no need for compensation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it provides a pitch explaining why MfT is the token to buy, covering deflationary mechanics, impact story, and exposure strategies. The verb 'pitch' and topic are specific, distinguishing it from sibling tools like mft_price or tokenomics_metrics.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives. The description implies use for persuasive/educational content but lacks 'when not to use' or references to sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

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

  1. 49 tool updatesv1.4.0
    • First observedarb_signal
    • First observedassign_to_house
    • First observedassign_worker
    • First observedbuild_phase
    • First observedbuy_egg
    • First observedbuy_food
    • First observedbuy_house
    • First observedchoose_strategy
    • First observedclaim_poop
    • First observeddeposit_garden
    • First observedeconomy_rules
    • First observedensure_approvals
    • First observedfeed_baseling
    • First observedfeeding_guide
    • First observedfire_reactor
    • First observedfreeze_baseling
    • First observedgame_guide
    • First observedget_assignments
    • First observedget_balances
    • First observedget_baseling
    • First observedget_egg_prices
    • First observedget_food_stock
    • First observedget_garden_status
    • First observedget_global_stats
    • First observedget_houses
    • First observedget_my_baselings
    • First observedget_pending_poop
    • First observedget_reactor_list
    • First observedhatch_egg
    • First observedliquidity_depth
    • First observedmft_flywheel
    • First observedmft_price
    • First observednext_actions
    • First observedportfolio_value
    • First observedreactor_timing
    • First observedresurrect_baseling
    • First observedswap_quote
    • First observedswap_status
    • First observedswap_token
    • First observedtokenomics_metrics
    • First observedunassign_worker
    • First observedunfreeze_baseling
    • First observedunrugable_check_reactor
    • First observedunrugable_info
    • First observedunrugable_invite_link
    • First observedunrugable_launch
    • First observedunrugable_recent
    • First observedwelcome
    • First observedwhy_mft

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

ActivitySlowing
ResponsivenessUnresponsive

Related MCP Connectors

Related MCP Servers