Operations: plugins

Plugins for desktop projects. 2 operations. How to call them, and what the answers mean: Operations reference.

Generated from the operation catalog: src/lib/ops/public-catalog.json in publicsummerengine at 0d85f61e2b and the summer-engine npm package 4.0.0 for engine and local operations. If something here is wrong, the operation’s definition is wrong.

Operation	What it does	Asks you first
`plugins.search`	Find add-ons for a desktop project in Summer’s plugin catalog by words, category or tier: name, what it does, its tier and how well agents work with it.	Never
`plugins.suggest`	Ask the person to send the Summer team a plugin to review for the catalog: its link, why, and what project it fits.	Yes, by default

search

plugins.search: Find plugins Find add-ons for a desktop project in Summer’s plugin catalog by words, category or tier: name, what it does, its tier and how well agents work with it. Next: the Summer Engine plugin tools to add one.


MCP	`summer_call` with `"op": "plugins.search"`
CLI	`summer plugins search`
Runs	On Summer’s servers: the hosted MCP, or the npm MCP after `summer login`. Needs your Summer sign-in.
Effect	Reads only. Changes nothing.
Asks you first	No. It changes nothing.

Inputs:

Input	Type	Required	Description
`query`	string	No	What the plugin should do: “steam achievements”, “dialogue”. Length 0 to 200.
`category`	string	No	Length 0 to 80.
`tier`	”summer-verified” \| “curated-godot” \| “godot-assetlib”	No
`limit`	integer	No	Default `10`. Range 1 to 50.

Input JSON schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "What the plugin should do: \"steam achievements\", \"dialogue\".",
      "type": "string",
      "maxLength": 200
    },
    "category": {
      "type": "string",
      "maxLength": 80
    },
    "tier": {
      "type": "string",
      "enum": [
        "summer-verified",
        "curated-godot",
        "godot-assetlib"
      ]
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  }
}

Result JSON schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "author": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "tier": {
            "description": "summer-verified, curated-godot or godot-assetlib.",
            "type": "string"
          },
          "link": {
            "type": "string"
          },
          "aiSafe": {
            "description": "verified, likely or unknown: how well agents work with it.",
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "url": {
            "description": "Its page on summerengine.com.",
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name",
          "author",
          "description",
          "category",
          "tags",
          "tier",
          "link",
          "aiSafe",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}

Example: Is there a Steam plugin?

{
  "name": "summer_call",
  "arguments": {
    "op": "plugins.search",
    "input": {
      "query": "steam achievements"
    }
  }
}

summer plugins search --query 'steam achievements'

suggest

plugins.suggest: Suggest a plugin to Summer Ask the person to send the Summer team a plugin to review for the catalog: its link, why, and what project it fits. Returns a link; nothing is sent until they confirm. Next: jobs.wait.


MCP	`summer_call` with `"op": "plugins.suggest"`
CLI	`summer plugins suggest`
Runs	On Summer’s servers: the hosted MCP, or the npm MCP after `summer login`. Needs your Summer sign-in.
Effect	Changes your own drafts, files or settings. Nobody else sees it yet.
Asks you first	Yes: Contact people is off by default in Agent permissions.

Inputs:

Input	Type	Required	Description
`pluginUrl`	string	Yes	The plugin’s page or repository. Length 0 to 2048.
`reason`	string	Yes	Why it should be in the catalog. Length 1 to 4000.
`projectKind`	string	No	The kind of project it fits. Length 0 to 240.
`dryRun`	boolean	No	Check and describe the call without doing it: nothing changes, nothing is spent.
`idempotencyKey`	string	No	Retry key. Reuse it only to retry the identical request, so it never happens twice. Length 1 to 128.

Input JSON schema

{
  "type": "object",
  "properties": {
    "pluginUrl": {
      "description": "The plugin's page or repository.",
      "type": "string",
      "maxLength": 2048
    },
    "reason": {
      "description": "Why it should be in the catalog.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    },
    "projectKind": {
      "description": "The kind of project it fits.",
      "type": "string",
      "maxLength": 240
    },
    "dryRun": {
      "description": "Check and describe the call without doing it: nothing changes, nothing is spent.",
      "type": "boolean"
    },
    "idempotencyKey": {
      "description": "Retry key. Reuse it only to retry the identical request, so it never happens twice.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "pluginUrl",
    "reason"
  ]
}

Result JSON schema

{
  "type": "object",
  "properties": {
    "requestId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string"
    },
    "received": {
      "type": "boolean"
    }
  },
  "required": [
    "requestId",
    "status",
    "received"
  ],
  "additionalProperties": false
}

Example: Ask Summer to review a plugin.

{
  "name": "summer_call",
  "arguments": {
    "op": "plugins.suggest",
    "input": {
      "pluginUrl": "https://github.com/example/dialogue-plugin",
      "reason": "Branching dialogue for story games."
    }
  }
}

summer plugins suggest --plugin-url https://github.com/example/dialogue-plugin --reason 'Branching dialogue for story games.'

Overview

Operations

HTTP API

GDScript API

Migration and extensions

MCP

search

suggest

​search

​suggest

search

suggest