> ## Documentation Index
> Fetch the complete documentation index at: https://docs.summerengine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Operations: find operations

> Find any operation by describing the job, and read its exact input. For each operation: what it does, whether it asks you first, its inputs and an example call.

Find any operation by describing the job, and read its exact input. 2 operations. How to call them, and what the answers mean: [Operations reference](/mcp/operations).

<Note>
  Generated from the `summer-engine` npm package `4.2.0`: its public operation catalog (`registry/operations/public-catalog.json`) and its engine and local operations. If something here is wrong, the operation's definition is wrong.
</Note>

| Operation | What it does | Asks you first |
| - | - | - |
| [`ops.describe`](#describe) | Read one operation in full by its name (or a 3.x tool name): input and output schemas, effect, approval, examples. | Never |
| [`ops.search`](#search) | Find any Summer operation by describing the job in plain words. | Never |

***

### describe

`ops.describe`: **Describe a Summer operation**

Read one operation in full by its name (or a 3.x tool name): input and output schemas, effect, approval, examples. Next: summer\_call.

| | |
| - | - |
| **MCP** | `summer_call` with `"op": "ops.describe"` |
| **CLI** | `summer ops describe` |
| **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 |
| - | - | - | - |
| `name` | string | Yes | An op name such as pricing.set\_base, or a 3.x tool name. Length 1 to 80. |

<Accordion title="Input JSON schema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "name": {
        "description": "An op name such as pricing.set_base, or a 3.x tool name.",
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      }
    },
    "required": [
      "name"
    ]
  }
  ```
</Accordion>

<Accordion title="Result JSON schema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "operation": {
        "type": "object",
        "additionalProperties": {}
      }
    },
    "required": [
      "operation"
    ],
    "additionalProperties": false
  }
  ```
</Accordion>

**Example:** The exact input of games.list.

<CodeGroup>
  ```json MCP theme={null}
  {
    "name": "summer_call",
    "arguments": {
      "op": "ops.describe",
      "input": {
        "name": "games.list"
      }
    }
  }
  ```

  ```bash CLI theme={null}
  summer ops describe --name games.list
  ```
</CodeGroup>

***

### search

`ops.search`: **Find a Summer operation**

Find any Summer operation by describing the job in plain words. Returns the best matches with their exact input schema, effect and approval. Next: summer\_call with the name.

| | |
| - | - |
| **MCP** | `summer_search`, a tool on the hosted MCP and the npm assets profile. Elsewhere: `summer_call` with `"op": "ops.search"` |
| **CLI** | `summer ops 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 | Yes | The job in plain words: "lower my game's price", "upload a web build". Length 1 to 300. |
| `area` | string | No | Only this area: assets, store, pricing, analytics... |
| `effect` | "read" \| "write" \| "spend" \| "publish" \| "player\_facing" \| "destructive" | No | |
| `limit` | integer | No | Default `5`. Range 1 to 20. |

<Accordion title="Input JSON schema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "query": {
        "description": "The job in plain words: \"lower my game's price\", \"upload a web build\".",
        "type": "string",
        "minLength": 1,
        "maxLength": 300
      },
      "area": {
        "description": "Only this area: assets, store, pricing, analytics...",
        "type": "string",
        "pattern": "^[a-z]+$"
      },
      "effect": {
        "type": "string",
        "enum": [
          "read",
          "write",
          "spend",
          "publish",
          "player_facing",
          "destructive"
        ]
      },
      "limit": {
        "default": 5,
        "type": "integer",
        "minimum": 1,
        "maximum": 20
      }
    },
    "required": [
      "query"
    ]
  }
  ```
</Accordion>

<Accordion title="Result JSON schema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "items": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "summary": {
              "type": "string"
            },
            "effect": {
              "type": "string",
              "enum": [
                "read",
                "write",
                "spend",
                "publish",
                "player_facing",
                "destructive"
              ]
            },
            "approval": {
              "type": "string"
            },
            "provider": {
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "available": {
              "type": "boolean"
            },
            "mcpTool": {
              "description": "Call it directly with this tool; else use summer_call.",
              "type": "string"
            },
            "input": {
              "description": "The exact input JSON Schema for summer_call.",
              "type": "object",
              "additionalProperties": {}
            }
          },
          "required": [
            "name",
            "title",
            "summary",
            "effect",
            "approval",
            "provider",
            "status",
            "available",
            "input"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "items"
    ],
    "additionalProperties": false
  }
  ```
</Accordion>

**Example:** Find the pricing operation and its input.

<CodeGroup>
  ```json MCP theme={null}
  {
    "name": "summer_call",
    "arguments": {
      "op": "ops.search",
      "input": {
        "query": "lower the price of my game"
      }
    }
  }
  ```

  ```bash CLI theme={null}
  summer ops search --query 'lower the price of my game'
  ```
</CodeGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.