Documentation version: 2026-09-24.7
Canonical: https://docs.creator.gg/tools/growth_ideas_search.md

# growth_ideas_search

Read the maintained shared growth idea library. Filter by objective, relevant AAARRR categories and context. Returns revisioned ideas, source evidence and freshness, not guaranteed results or private customer outcomes. Select only categories necessary for the objective; one category may suffice.

## Execution

Interface: Creators MCP tool at https://mcp.creator.gg/mcp. Do not construct a REST route from the tool name. The connection selects the workspace.

Effect: read-only or navigation handoff; no marketing mutation.

## Behavior and limits

Use only relevant categories. Source freshness does not establish effectiveness; no private customer outcomes are included.

## Example arguments

Illustrative placeholders only. Replace IDs with values from this workspace, resolve sender/content/recipients, recalculate dates, and generate a new requestId for a new action.

```json
{
  "goal": "winback",
  "stages": [
    "retention"
  ],
  "query": "reconnect with an existing audience",
  "limit": 10
}
```

## Input schema

Generated from the current executable Creators contract. Runtime rules in Behavior and limits and the linked guide also apply; JSON Schema alone cannot express all cross-field constraints.

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "enum": [
        "acquire",
        "awareness",
        "winback"
      ]
    },
    "stages": {
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "awareness",
          "acquisition",
          "activation",
          "retention",
          "referral",
          "revenue"
        ]
      }
    },
    "query": {
      "type": "string",
      "maxLength": 1000
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 40
    }
  },
  "additionalProperties": false
}
```

## Result interpretation

Results use status and message, with operation-specific data and optional link, code, nextAction, and operationId. Data may retain different list/record envelopes. A completed read or accepted send is not proof of delivery/publication. An unknown result must be reconciled. HUMAN_ACTION_REQUIRED returns instructions without performing the action.

## Related guides

- [start](https://docs.creator.gg/guides/start.md)
- [Recovery](https://docs.creator.gg/guides/recovery.md)