# get_my_ideas

> The ideas DECA's engine wrote for your own workspace, each with why it is yours.

**GET /api/agent/my-ideas · MCP tool get_my_ideas · Needs a key · Free**
`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_ideas` or 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

```bash title="cURL"
curl -H "Authorization: Bearer deca_sk_…" \
  "https://app.decalabs.ai/api/agent/my-ideas?limit=5"
```

```json title="MCP"
{ "name": "get_my_ideas", "arguments": { "limit": 5 } }
```

## Response

```json
{
  "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`](https://app.decalabs.ai/docs/tools/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`](https://app.decalabs.ai/docs/tools/quote-test) by its `id`, with the same key.

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