DECADocs
decalabs.aiDashboard

Reference

REST API

The same tools as plain HTTPS endpoints, for agents and code that do not speak MCP.

Every MCP tool is also a plain endpoint. Requests and answers are JSON, and an answer is the same object the MCP tool returns.

Base URL https://app.decalabs.ai
Format JSON in, JSON out
Authentication Optional Authorization: Bearer key. See Authentication.
CORS Open to any origin
OpenAPI /api/agent/openapi.json

Endpoints

Method Path Tool
GET /api/agent/signals get_signals
GET /api/agent/ideas get_ideas
GET /api/agent/my-ideas get_my_ideas (needs a key)
POST /api/agent/quote quote_test
POST /api/agent/score Score an idea, 1 USDC over x402 (REST only)
POST /api/agent/tests start_test, paid over x402: see Paid tests
GET /api/agent/tests list_my_tests (needs a key)
GET /api/agent/tests/{id} get_test
POST /api/agent/tests/{id}/cancel cancel_test

GET endpoints take their parameters in the query string. POST endpoints take a JSON object in the body with content-type: application/json.

Status codes

Code When
200 The call worked
201 A paid test was opened
202 The payment was sent but its settlement has not answered yet; read the test again
400 Something in the request is wrong; the body says what
401 The API key is not valid or was revoked
402 Payment required: the body and the PAYMENT-REQUIRED header carry the x402 request
403 The API key may not use this tool
404 No idea or endpoint by that name
405 The wrong method for the endpoint
409 The payment or the idempotency key was already used
422 The text sent to be scored is not a product idea; nothing was charged
429 Too many requests; wait for Retry-After seconds
503 The radar, the scoring engine or the payment service is not available right now; nothing was charged

Every non-200 answer has the error shape.

Caching

GET answers may be cached for five minutes (Cache-Control: public, s-maxage=300). The radar itself changes once a day.