# get_ideas

> Consumer product ideas written from the day's signals and judged worth testing, with their evidence.

**GET /api/agent/ideas · MCP tool get_ideas · Free**
From each strong pattern DECA's engine writes product ideas. A second pass judges each one: what it would take to build, the risks, and the sign-up rate a test can expect. `get_ideas` returns the ideas judged `go` or `maybe` from the last two weeks, best first, with the apps and posts each one rests on.

Ideas a founder is testing are not shown, and neither is anything written for one company.

## Parameters

| Name | Type | Description |
|---|---|---|
| `id` | string | One idea's id, to read only that idea. Optional. |
| `query` | string | Words that must all appear in the idea. Optional. |
| `verdict` | `go` · `maybe` | Only ideas the judge rated this way. Optional. |
| `limit` | integer | How many to return, 1 to 25. Default 10. |

## Request

```bash title="cURL"
curl "https://app.decalabs.ai/api/agent/ideas?query=tidy&limit=3"
```

```json title="MCP"
{ "name": "get_ideas", "arguments": { "query": "tidy", "limit": 3 } }
```

```bash title="One idea"
curl "https://app.decalabs.ai/api/agent/ideas?id=5c33b777-5c0e-4bb6-a2f1-d98dbb71bc21"
```

## Response

```json
{
  "day": "2026-11-18",
  "count": 1,
  "ideas": [
    {
      "id": "5c33b777-5c0e-4bb6-a2f1-d98dbb71bc21",
      "name": "Drawerly",
      "one_line": "An app for people who love tidy-up games: photograph a messy drawer or shelf and get a short, step-by-step sorting plan to tick off.",
      "promise": "Snap your messy drawer and get a ten-minute plan to sort it.",
      "who": "Women aged 25 to 45 in the US and UK who play cosy organising games and follow tidying content on short video",
      "what": [
        "Take one photo of a drawer, shelf or toy box and the app lists what it sees",
        "Get five to eight short steps grouped by colour or type, each ticked off with a satisfying sound"
      ],
      "why_now": "Tidy Everything! reached the top of a UK free chart in 16 days with a toy store tidying theme…",
      "first_version": "Camera capture, an image model call that lists items and returns grouped steps, a tick-off checklist…",
      "risks": ["The model may misread cluttered photos and give steps that feel generic"],
      "verdict": "maybe",
      "written": "2026-11-18",
      "from_signal": "Casual sorting and logic puzzle games",
      "evidence": {
        "apps": [{ "name": "Tidy Everything!", "url": "https://apps.apple.com/us/app/tidy-everything/id6824655215", "fact": "16 days old, #1 top free in Family games (GB), #14 top grossing in Family games (GB)" }],
        "posts": [{ "title": "Why Is Putting Together Virtual Puzzles SO FUN?! - Puzzle Simulator", "url": "https://www.youtube.com/watch?v=ysWmGHnPSC8", "where": "YouTube (Kelly Kas)" }]
      },
      "expected": {
        "signup_rate": 0.037,
        "signup_rate_low": 0.022,
        "signup_rate_high": 0.056,
        "cost_per_click_usd": 0.77,
        "basis": "an estimate from our default rates and the judge's reading; no test of this idea has run"
      },
      "build_days": 15,
      "url": "https://app.decalabs.ai/board/5c33b777-5c0e-4bb6-a2f1-d98dbb71bc21?utm_source=agent&utm_medium=mcp"
    }
  ]
}
```

| Field | Description |
|---|---|
| `id` | The idea's id. Pass it to [`quote_test`](https://app.decalabs.ai/docs/tools/quote-test) as `idea_id`. |
| `one_line` | The idea in one plain sentence. |
| `verdict` | `go` or `maybe`, from the judge. |
| `evidence` | The apps and posts the idea rests on. |
| `expected` | The share of cold visitors expected to leave their email, with a low and high bound, and the expected cost of a click. An estimate until the idea is tested. |
| `build_days` | The judge's estimate of the days to a first version. |
| `url` | The idea's page on DECA, for a person to open. |

> **Note** · Idea names are written by the engine and can match an existing product by chance. Check a name before you use it in public.

Source: https://app.decalabs.ai/docs/tools/get-ideas
