# Quickstart

> Your first call to DECA in under a minute, with no key and no account.

DECA needs no key and no account for reading signals, reading ideas and pricing a test. Pick the way your agent talks to tools.

## 1. Connect

```bash title="Claude Code"
claude mcp add --transport http deca https://app.decalabs.ai/mcp
```

```json title="Claude Desktop · Cursor"
{
  "mcpServers": {
    "deca": { "type": "http", "url": "https://app.decalabs.ai/mcp" }
  }
}
```

```bash title="REST"
curl https://app.decalabs.ai/api/agent/ideas?limit=1
```

More clients, and one-click install buttons, are on [Connect over MCP](https://app.decalabs.ai/docs/mcp).

## 2. Ask for ideas

Over MCP, ask your agent something like *"What product ideas does DECA have in photo apps?"* It will call `get_ideas` with `query: "photo"`. Over REST:

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

```ts title="TypeScript"
const res = await fetch("https://app.decalabs.ai/api/agent/ideas?query=photo&limit=3");
const { ideas } = await res.json();
for (const idea of ideas) console.log(idea.name, "·", idea.one_line);
```

```python title="Python"
import requests

r = requests.get("https://app.decalabs.ai/api/agent/ideas", params={"query": "photo", "limit": 3})
for idea in r.json()["ideas"]:
    print(idea["name"], "·", idea["one_line"])
```

Each idea carries its `evidence` (the apps and posts it rests on), its `expected` sign-up rate and a `url` a person can open.

## 3. Price a test

Take an idea's `id`, or describe your own, and ask what testing it would cost:

```bash title="cURL"
curl -X POST https://app.decalabs.ai/api/agent/quote \
  -H "content-type: application/json" \
  -d '{"idea": {"pitch": "A pantry app that tells families what to cook from what is about to expire"}, "markets": ["US", "GB"]}'
```

```ts title="TypeScript"
const res = await fetch("https://app.decalabs.ai/api/agent/quote", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    idea: { pitch: "A pantry app that tells families what to cook from what is about to expire" },
    markets: ["US", "GB"],
  }),
});
const quote = await res.json();
for (const o of quote.options) console.log(o.label, `$${o.budget_usd}`, `pass at ${o.pass_line}`);
```

The answer lists a few options. The cheapest reliable one is marked `recommended`:

```json
{
  "fee_usd": 0,
  "currency": "USDC",
  "network": "base",
  "recommended": "signal",
  "options": [
    { "id": "signal", "label": "Signal: is there demand at all", "budget_usd": 700, "expected_visits": 737, "pass_line": 15 },
    { "id": "clear", "label": "Clear read: a result that rests less on luck", "budget_usd": 1400, "expected_visits": 1474, "pass_line": 31 },
    { "id": "compare", "label": "Market comparison: where it is strongest", "budget_usd": 1400, "expected_visits": 1484, "pass_line": 31, "pass_line_by_market": { "US": 15, "GB": 16 } }
  ]
}
```

Read [How a test is priced](https://app.decalabs.ai/docs/guides/pricing) for what these numbers mean.

## Next

- [`get_signals`](https://app.decalabs.ai/docs/tools/get-signals), [`get_ideas`](https://app.decalabs.ai/docs/tools/get-ideas) and [`quote_test`](https://app.decalabs.ai/docs/tools/quote-test) in full.
- [Errors](https://app.decalabs.ai/docs/reference/errors): every code your agent can meet and what to do about it.

Source: https://app.decalabs.ai/docs/quickstart
