Reference
Changelog
What changed in DECA's tools for agents, newest first.
20 November 2026 · v1.4.0
- Score an idea for 1 USDC:
POST /api/agent/scorereads your own idea against live app-store demand and answers with a verdict, the closest apps and the sign-ups to expect. Fixed price, no quote, no key; charged only when a score comes back. See Score an idea. - The score endpoint carries the x402 Bazaar discovery block, so marketplaces that read it can list and call it.
- DECA is in the official MCP Registry as
ai.decalabs/deca. - The OpenAPI document now describes the paid endpoints too:
/api/agent/scoreand/api/agent/tests. - New errors:
idea_invalid,not_an_idea,engine_unavailable,score_failed.
19 November 2026 · v1.3.2
- The rate limit is now counted across all of DECA's servers, so the numbers in the
RateLimit-*headers are exact. - A webhook is sent only to a public address, checked when it is sent.
19 November 2026 · v1.3.1
- Real payments are open on Base. The sandbox stays for building.
- A payment that got no answer is never lost: a test left in
settlingis looked up on Base and moved on; a repeated request with the same payment andidempotency_keyreturns the test with a newaccess_token. - Stricter keys over REST: reading tests needs the
readscope and cancelling needstest, as over MCP. - Refunds of unspent budget are recorded the moment a test ends.
- MCP batches hold at most 20 messages, each tool call counted. Webhooks no longer follow redirects. New errors:
payments_unavailable,idempotency_key_used.
18 November 2026 · v1.3.0
- Paid tests over x402:
start_testanswers with an x402 v2 payment request for the exact ad budget in USDC; paying it opens the test, reviewed by a person before its ads run.get_test,list_my_tests,cancel_test, webhooks, idempotency keys and key caps. Runs in the sandbox on Base Sepolia, and for real in USDC on Base.
18 November 2026 · v1.2.0
get_my_ideas: the ideas DECA's engine wrote for your own workspace, each with why it is yours, and the day's public ideas picked for you. Needs an API key; a key sees only its own workspace. Read only.quote_testprices an idea written for your workspace by itsid, with the same key.
18 November 2026 · v1.1.0
- API keys, made in the dashboard under MCP & API. Sent as
Authorization: Bearer, over MCP or REST. Scopes (read,quote,test), caps per test and per month, 600 calls a minute per key, and calls counted per key. quote_testmarks each optionwithin_capand addskey_capwhen the key has a cap.- New error codes:
invalid_key,key_revoked,scope_missing.
18 November 2026 · v1.0.0
The first release.
- MCP server at
https://app.decalabs.ai/mcp: streamable HTTP, JSON answers, no key. get_signals: the day's demand patterns, with the apps, what people say and want, and the posts behind them.get_ideas: ideas judged worth testing, with their evidence and expected sign-up rate.quote_test: the price of a ten-day demand test as options sized to the idea. Only the ad budget, at cost, in USDC on Base.- REST under
/api/agent, an OpenAPI description, and these docs, each page also as Markdown, with/llms.txtand/llms-full.txt.