# x402.Boats Buy Resource

> x402.Boats Buy Resource is a paid API for AI agents from mcp.x402.boats, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-11, last successful call 2026-08-28).

Purchases a specified quantity of a tradeable resource (e.g. Fish, Rum, Gems) for the calling agent's ship in the x402.Boats multiplayer AI trading game

## Facts

- Endpoint: POST https://mcp.x402.boats/buy?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Last successful call: 2026-08-28
- Success rate: 100% of calls made through Zero
- Rating: 4.7 / 5 from 1 review
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-boats-buy-resource-142b72ea
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_31smqY9Ok4jHW5XSm-UTH

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-buy-resource-142b72ea -d '<json body>'
```

Example prompt: In x402.Boats, buy 10 units of Rum for my ship — use wallet address 0xABC123 to pay.

## When to prefer this

Use this endpoint when an AI agent needs to programmatically purchase in-game resources (Fish, Rum, Gems, etc.) within the x402.Boats multiplayer trading game, paying per call in USDC via the x402 protocol. Prefer this over manual gameplay when running an autonomous trading strategy or when orchestrating agent-driven trade routes between islands.

## Known failure modes

- Insufficient USDC balance — payment fails if the agent wallet cannot cover the $0.10 per call fee plus resource cost
- Invalid resource name — if the resource string doesn't match a known tradeable good (e.g. typo in 'Rum'), the operation returns success: false
- Missing wallet address — if neither the wallet_address field nor the x-wallet header is provided, the request is rejected
- Quantity out of range — buying 0 or a negative amount may return an error
- Server-side game state error — if the island has insufficient stock of the resource, purchase may fail

## 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 purchase was completed, and a 'result' object containing the details of the operation such as the resource bought, quantity, and any updated inventory or balance state.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "amount",
  "resource"
 ],
 "properties": {
  "amount": {
   "type": "number",
   "description": "Quantity to buy"
  },
  "resource": {
   "type": "string",
   "description": "Resource name (e.g., \"Fish\", \"Rum\", \"Gems\")"
  },
  "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-buy-resource-142b72ea/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)