Tools
get_my_ideas
The ideas DECA's engine wrote for your own workspace, each with why it is yours.
GET/api/agent/my-ideasMCP tool get_my_ideasNeeds a keyFree
get_ideas returns what DECA's radar found for everyone. get_my_ideas returns what it found for you: ideas the engine wrote for your workspace from what it knows about you, and the day's public ideas it picked as the best fit for you, each with the reason.
The engine learns about you in the dashboard, under Settings → Your radar: your company's site and what you sell, or, for one person, what you can do, spend and care about. New ideas for you arrive every day.
Private by design
- It needs an API key. The key says whose ideas to return. Without one the call is refused with
key_required. - A key sees only its own workspace. No call can read another workspace's ideas, profile or picks.
- Read only. The tool returns what the engine has already written. It never asks the engine to write more; that stays your choice in the dashboard.
- Ideas written for you are never published. They do not appear in
get_ideasor on the public board.
Parameters
| Name | Type | Description |
|---|---|---|
include |
all · written · picks |
Ideas written for you, the day's picks for you, or both. Default both. |
limit |
integer | How many of each to return, 1 to 25. Default 10. |
Request
curl -H "Authorization: Bearer deca_sk_…" \
"https://app.decalabs.ai/api/agent/my-ideas?limit=5"{ "name": "get_my_ideas", "arguments": { "limit": 5 } }Response
{
"day": "2026-11-18",
"profile": {
"state": "ready",
"kind": "company",
"summary": "A booking platform for hair salons in Germany, with 4,000 salons as customers…"
},
"written": [
{
"id": "…",
"name": "…",
"one_line": "…",
"why_you": "Your salons already hold their clients' booking history, so…",
"verdict": "go",
"evidence": { "apps": ["…"], "posts": ["…"] },
"expected": { "signup_rate": 0.034, "…": "…" },
"url": "https://app.decalabs.ai/board/…"
}
],
"picks": [
{ "id": "…", "name": "…", "why": "It sells to the same small businesses you already reach…", "…": "…" }
]
}Each idea has the same fields as in get_ideas, plus:
| Field | Description |
|---|---|
written[].why_you |
Why the engine wrote this idea for you. |
picks[].why |
Why this public idea fits you. |
profile.state |
none (not set up yet), reading (being made, ideas follow in minutes), ready or failed. |
next |
Present when there is something to do first, such as setting up your radar. |
An idea written for you can be priced with quote_test by its id, with the same key.