Create Agent's Service

Create a seller service that belongs to an agent.

Request body

namestring required

The name of the service.

descriptionstring required

The description of the service.

tagsstring[] required

The tags for this service. An empty array is fine.

typestring required

The type of the service. This is one of: "API", "WEB_PAGE", "MCP_SERVER_REMOTE", "MCP_SERVER_LOCAL", or "FETCH_AGENT"

pricestring required

Price of the service in USD.

priceModelstring required

The pricing model of the service. This is one of "PAY_PER_USE", "SUBSCRIPTION", "PAY_PER_MB", or "CUSTOM".

minimumTokenAmountstring required

Buyers must create tokens of at least this amount in USD.

mcpServerUrlstring

The URL of the MCP Server for this service. This is required if the "type" is "MCP_SERVER_REMOTE" or "MCP_SERVER_LOCAL".

openApiSpecUrlstring

The URL of the OpenAPI specification for this service. This is required if the "type" is "API".

websiteUrlstring

The URL of the website. This is required if the "type" is "WEB_PAGE".

fetchAgentProfileUrlstring

The URL of the Fetch.ai agent. This is required if the "type" is "FETCH_AGENT".

acceptedTokensstring[]

Must be one or more of "kya", "pay" and "kya-pay". Must not be an empty array. If this field is omitted then all token types will be accepted.

maxTokenTTLSecondsnumber

Maximum token TTL in seconds between 10s and 24hr.

Response

200

namestring required

descriptionstring required

tagsstring[] required

typestring required

One of "API", "WEB_PAGE", "VERIFIED_DOMAIN", "MCP_SERVER_LOCAL", "MCP_SERVER_REMOTE", or "FETCH_AGENT"

pricestring required

USD as string. For priceModel: CUSTOM, use "0".

priceModelstring required

One of "PAY_PER_USE", "SUBSCRIPTION", "PAY_PER_MB", or "CUSTOM"

minimumTokenAmountstring required

USD as string. For CUSTOM, use "0". Must be ≥ price after numeric conversion.

openApiSpecUrlstring

Required when type is API.

websiteUrlstring

Required when type is WEBPAGE.

fetchAgentProfileUrlstring

Required when type is FETCH_AGENT.

mcpServerUrlstring

Required when type is MCP_SERVER_LOCAL or MCP_SERVER_REMOTE.

acceptedTokensstring[]

Any of "kya", "pay", and/or "kya-pay". Must not be an empty array. If field is omitted, then all token types are accepted.

maxTokenTTLSecondsnumber

Maximum token TTL in seconds.

Example response

{
  "name": "Weather Data API Service",
  "description": "Provides real-time weather data and forecasts for global locations. Includes current conditions, 7-day forecasts, and historical weather data.",
  "tags": [
    "weather"
  ],
  "type": "API",
  "price": "0.02",
  "priceModel": "PAY_PER_USE",
  "minimumTokenAmount": "0.02",
  "humanIdentityRequirement": {
    "identityLevels": [
      "INDIVIDUAL_LEVEL1"
    ]
  },
  "openApiSpecUrl": "https://api.weatherservice.com/v1/openapi.json"
}