Get started
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
claude mcp add --transport http deca https://app.decalabs.ai/mcp{
"mcpServers": {
"deca": { "type": "http", "url": "https://app.decalabs.ai/mcp" }
}
}curl https://app.decalabs.ai/api/agent/ideas?limit=1More clients, and one-click install buttons, are on Connect over 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:
curl "https://app.decalabs.ai/api/agent/ideas?query=photo&limit=3"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);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:
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"]}'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:
{
"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 for what these numbers mean.
Next
get_signals,get_ideasandquote_testin full.- Errors: every code your agent can meet and what to do about it.