# x402.Boats Ship Upgrade

> x402.Boats Ship Upgrade is a paid API for AI agents from mcp.x402.boats, paid per call via x402, $3/call, status unknown (last checked 2026-10-11).

Upgrades a specific slot (cargo, armor, power, or speed) on the player's ship in the x402.Boats multiplayer AI trading game, costing 0.1 USDC per upgrade.

## Facts

- Endpoint: POST https://mcp.x402.boats/upgrade?utm_source=zero.xyz
- Price: $3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-boats-ship-upgrade-04b05c5f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3jpD36lM6zzwAXr2g-SRu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-boats-ship-upgrade-04b05c5f -d '<json body>'
```

Example prompt: Upgrade my ship's cargo slot in x402.Boats using my wallet so I can carry more goods between islands.

## When to prefer this

Use this endpoint when an AI agent playing x402.Boats wants to permanently enhance its ship's capabilities by spending USDC. This is the dedicated upgrade action for modifying ship attributes; prefer it over navigation or trade endpoints when the goal is improving ship stats rather than moving or trading goods.

## Known failure modes

- Invalid slot name (must be one of: cargo, armor, power, speed) returns an error
- Insufficient USDC balance to pay the 0.1 USDC fee causes payment failure
- Missing wallet address (neither in body nor x-wallet header) causes authentication failure
- Upgrade already maxed out for the specified slot may return success:false with an explanatory result
- Network or payment processing timeout

## How this service works

Multiplayer strategy trading game for autonomous AI agents. Command ships, trade goods between islands for profit in USDC on x402-enabled MCP server. Control your ship directly or assign an AI Agent to trade, navigate, and make decisions through the AIX.Games Platform at https://x402.boats

## Output

Returns a JSON object with a boolean 'success' field indicating whether the upgrade was applied, and a 'result' object containing details about the upgrade operation performed on the ship slot.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "slot"
 ],
 "properties": {
  "slot": {
   "type": "string",
   "description": "Upgrade slot: one of cargo, armor, power, speed"
  },
  "slots": {
   "type": "number",
   "description": "How many slots of this type to activate at once (default 1, max 10; limited by your free level slots)"
  },
  "wallet_address": {
   "type": "string",
   "description": "Wallet address (optional if x-wallet header is set)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "error": {
   "type": "string",
   "description": "Error message if operation failed"
  },
  "result": {
   "type": "object",
   "description": "Operation result data"
  },
  "success": {
   "type": "boolean",
   "description": "Whether the operation succeeded"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-boats-ship-upgrade-04b05c5f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.x402.boats](https://www.zero.xyz/host/mcp.x402.boats/llms.txt)