Tools
get_ideas
Consumer product ideas written from the day's signals and judged worth testing, with their evidence.
GET/api/agent/ideasMCP tool get_ideasFree
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
curl "https://app.decalabs.ai/api/agent/ideas?query=tidy&limit=3"{ "name": "get_ideas", "arguments": { "query": "tidy", "limit": 3 } }curl "https://app.decalabs.ai/api/agent/ideas?id=5c33b777-5c0e-4bb6-a2f1-d98dbb71bc21"Response
{
"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 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.