store_settings
WritePause (enabled=false) or resume purchases for this game, and set how its store looks on the game's page; each field only when given.
/api/agent/store/settingsBehavior
Pause (enabled=false) or resume purchases for this game, and set how its store looks on the game's page; each field only when given. While paused the catalog stays visible and no quotes are signed; a pause by Looping operators cannot be lifted here. headline is one short line over the store ("" clears it). accent colours the store's buttons and its checkout from a fixed palette that stays readable (default is the site's own).
sections is the whole ordered list of headings, each with the skus it holds (an item sits in at most one; items in no section are listed after them; a section left out is removed and its items ungrouped). order lists skus first to last (unlisted items follow). featured pins up to 2 items at the top ([] clears). The banner and item pictures are uploaded by the creator on the Store tab, not through this tool. Agree the look with the creator first.
Input parameters
enabledOptionalbooleanheadlineOptionalstring- Max. length: 80
accentOptional"default" | "mint" | "lime" | "gold" | "orange" | "coral" | "rose" | "violet" | "blue"sectionsOptionalobject[]- Max. items: 8
Nested schema
{
"maxItems": 8,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 24
},
"skus": {
"maxItems": 60,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40
}
}
},
"required": [
"name"
],
"additionalProperties": false
}
}orderOptionalstring[]- Max. items: 60
Nested schema
{
"maxItems": 60,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40
}
}featuredOptionalstring[]- Max. items: 2
Nested schema
{
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40
}
}The descriptions above include conditional requirements. The full schema below shows structural validation; runtime checks also apply.
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"headline": {
"type": "string",
"maxLength": 80
},
"accent": {
"type": "string",
"enum": [
"default",
"mint",
"lime",
"gold",
"orange",
"coral",
"rose",
"violet",
"blue"
]
},
"sections": {
"maxItems": 8,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 24
},
"skus": {
"maxItems": 60,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40
}
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"order": {
"maxItems": 60,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40
}
},
"featured": {
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"minLength": 2,
"maxLength": 40
}
}
},
"additionalProperties": false
}Use its name in your connected MCP client. For the HTTP API, the route is relative to your Convex site URL and requires your agent key as a bearer token. Keep the key on the agent side, outside a game build.