Skip to main content
POST
/
api
/
v1
/
agents
curl --request POST \
  --url https://mcp.echozero.app/api/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My agent"
}
'
{
  "success": true,
  "data": {
    "id": "<string>",
    "name": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

User JWT access token issued by POST /api/auth/verify or POST /api/auth/social/verify. Routes that accept both auth modes declare api-key and bearer-jwt security schemes.

Headers

​
x-signature
string

HMAC-SHA256 signature: HMAC-SHA256(secretKey, timestamp + METHOD + path + body). Optional -- when omitted, HMAC verification is skipped.

​
x-timestamp
string

Request timestamp in epoch milliseconds. Required when x-signature is provided. Rejected if drift exceeds 5 minutes.

Body

application/json

JSON body — OpenAPI schema McpCreateAgentBodyDto (also listed under Schemas). Pick an example below or compose from the schema; optional nested objects are personalization and **feeConfiguration**.

​
name
string
required

Display name

Example:

"My trading agent"

​
description
string
Example:

"Momentum strategies on Solana memecoins"

​
imageUrl
string
Example:

"avatars/my-agent.png"

​
tags
string[]
Example:
["SOL", "DEFI"]
​
personalization
object
​
isPublic
boolean

Whether the agent is public

Example:

false

​
feeConfiguration
object
​
isDraft
boolean

When true, agent is saved as draft (not fully activated)

Example:

true

​
strategyDescription
string
​
marketplacePricingModel
enum<string>
Available options:
subscription,
success-fee,
both,
free
​
marketplaceMonthlyPrice
number
Required range: x >= 0
​
marketplaceSuccessFeePercent
number
Required range: x >= 0
​
listingStatus
enum<string>
Available options:
pending-review,
beta,
public,
rejected
​
betaStartDate
string<date-time>
​
maxBetaUsers
number
Required range: x >= 1
​
riskLevel
enum<string>
Available options:
low,
medium,
high
​
performanceStats
object
​
featured
boolean
​
featuredRank
number
​
inboundWebhookUrl
string
​
signalSourceKind
enum<string>
Available options:
webhook,
signal_group
​
connectedChannels
object[]
​
signalDetectionRule
object
​
signalExecutionDefaults
object
​
parserAiMode
enum<string>

Per-agent hybrid parser: inherit (server env), off, shadow, or fallback.

Available options:
inherit,
off,
shadow,
fallback
​
membershipGated
boolean
​
externalSignupUrl
string

Response

Created agent.

​
success
boolean
required
Example:

true

​
data
object
required

Endpoint-specific payload