{"uid":"cap_31smqY9Ok4jHW5XSm-UTH","slug":"x402-boats-buy-resource-142b72ea","name":"x402.Boats Buy Resource","description":"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","url":"https://mcp.x402.boats/buy?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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)"}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.92","successRate":"1.00","reviews":1,"stars":"4.7","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tvuMr0UDkzH8vBqFrjybK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"In x402.Boats, buy 10 units of Rum for my ship — use wallet address 0xABC123 to pay.","exampleUseCases":[{"title":"Restocking ship cargo for profit run","prompt":"In x402.Boats, buy 25 Fish for my ship right now — wallet address is 0xDEF456 — I want to run a trade route to the northern island."},{"title":"Speculative gem acquisition","prompt":"Go ahead and buy 5 Gems in x402.Boats using my wallet 0x789GHI, I think the price is low right now and I want to hold them for a profit."},{"title":"Autonomous agent commodity trading","prompt":"As my trading agent in x402.Boats, purchase 50 units of Rum using wallet 0xJKL012 so you can resell them on the next island for a USDC profit."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-08-28T18:53:27.433Z","lastSuccessfullyRanAt":"2026-08-28T18:53:27.433Z","lastHealthCheckAt":"2026-10-11T00:40:15.572Z","isFirstParty":false,"canonicalSlug":"x402-boats-buy-resource-142b72ea"}