Ensure your game is monetization-enabled in the mod.io admin panel before calling any Marketplace endpoints
Call GET /me/wallets (scoped to your game ID) with a user OAuth token to register the user with the marketplace and retrieve their token balance
List paid mods by calling GET /games/{game-id}/mods with the revenue_type=1 query parameter to surface only paid content
POST to the purchase endpoint for the chosen mod, supplying the mod ID and the expected price in tokens so the API can validate against price changes
Confirm ownership by calling GET /me/purchases and verifying the mod ID appears; enforce download access server-side if api_access_options bit 8 is set
Known gotchas
All Marketplace endpoints return 403 if the game's monetization feature is not activated — enabling it requires a separate agreement with mod.io
The purchase endpoint requires the price field to match the current mod price exactly as a concurrency guard; stale prices cause a 409 conflict
User Delegation Tokens used for server-to-server purchase calls on behalf of a user are short-lived; cache Service Tokens (valid 90 days) separately to avoid unnecessary re-authentication
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp