> ## 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](https://docs.summerengine.com/mcp/operations.md).

> [!NOTE]
>
> Generated from the `summer-engine` npm package `4.8.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.

| 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] 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] Result JSON schema
>
> ```json theme={null}
> {
>   "type": "object",
>   "properties": {
>     "operation": {
>       "type": "object",
>       "additionalProperties": {}
>     }
>   },
>   "required": [
>     "operation"
>   ],
>   "additionalProperties": false
> }
> ```

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

```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
```

***

### 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] 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] 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
> }
> ```

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

```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'
```


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