# check_idea

> Any product idea, checked against today's app-store charts.

**POST /api/agent/check · MCP tool check_idea · Free**
Send an idea in a few sentences. DECA places it by meaning among the apps climbing the App Store charts today and returns **facts, not an opinion**:

- **The closest apps**, how alike they are, how long they have been on the store, and their best chart position today.
- **The demand pattern** those apps belong to, and how much people talk about it (`heat`).
- **What their users complain about**, quoted from reviews, and **what people search for that nobody answers**.
- **How crowded the field is**: `crowd`, `demand` and `openings`, in the same plain words every time.

No model writes a verdict here, so the answer is fast and the same for the same idea on the same day. For an expected sign-up rate and a pass line, call [quote_test](https://app.decalabs.ai/docs/tools/quote-test). For a full written reading, see [Score an idea](https://app.decalabs.ai/docs/guides/score-idea).

## Parameters

| Name | Type | Description |
|---|---|---|
| `idea.pitch` | string | Who it is for and what it does for them, 20 to 2,000 characters. Required. |
| `idea.name` | string | The product's name, if it has one. |

## Request

```bash title="cURL"
curl -X POST https://app.decalabs.ai/api/agent/check \
  -H "Content-Type: application/json" \
  -d '{"idea":{"pitch":"A calm sorting puzzle where players type any theme and get a fresh ad-free level pack."}}'
```

```json title="MCP"
{ "name": "check_idea", "arguments": { "idea": { "pitch": "A calm sorting puzzle where players type any theme and get a fresh ad-free level pack." } } }
```

## Response

```json
{
  "day": "2026-11-21",
  "field": { "crowd": "contested", "demand": "rising", "openings": "2 complaint themes and 6 unanswered searches to build on", "alike_seen_on_charts": 4, "alike_charting_today": 2, "young_and_charting": 2 },
  "closest_apps": [ { "name": "…", "url": "…", "developer": "…", "likeness": 0.61, "days_on_store": 102, "chart": "#9 top free Puzzle games (BR)" } ],
  "demand_patterns": [ { "name": "…", "summary": "…", "heat": "rising", "people_want": ["…"], "complaints": [ { "theme": "…", "quote": "…" } ], "unanswered_searches": ["…"] } ],
  "next": "For an expected sign-up rate and a pass line, call quote_test with this pitch. …"
}
```

The values above show the shape of the answer. Yours come from the day's charts.

## Reading the field

| `crowd` | Apps this alike the radar has seen on the charts |
|---|---|
| `nothing alike charting` | none |
| `few alike` | 1 to 2 |
| `contested` | 3 to 5 |
| `crowded` | 6 or more |

`alike_charting_today` counts those with a chart position today. Counts stop at 12.

`demand` is `rising` when people talk about the pattern more than usual, `present` when alike apps chart, and `not seen on the charts` otherwise. A field with nothing alike can mean an opening or no demand. `openings` tells you which.

## Errors

| Code | When |
|---|---|
| `bad_idea` | The pitch is missing, shorter than 20 characters or longer than 2,000. |
| `radar_unavailable` | The charts or the matching cannot be read right now. Try again in a minute. |

Source: https://app.decalabs.ai/docs/tools/check-idea
