---
title: "Create Agent's Service"
method: POST
path: "/api/v1/agents/seller-services"
---

# Create Agent's Service

`POST /api/v1/agents/seller-services`

Create a seller service that belongs to an agent.

## Request body

- object
  - `name` string, required — The name of the service.
  - `description` string, required — The description of the service.
  - `tags` string[], required — The tags for this service. An empty array is fine.
  - `type` string, required — The type of the service. This is one of: "API", "WEB_PAGE", "MCP_SERVER_REMOTE", "MCP_SERVER_LOCAL", or "FETCH_AGENT"
  - `price` string, required — Price of the service in USD.
  - `priceModel` string, required — The pricing model of the service. This is one of "PAY_PER_USE", "SUBSCRIPTION", "PAY_PER_MB", or "CUSTOM".
  - `minimumTokenAmount` string, required — Buyers must create tokens of at least this amount in USD.
  - `mcpServerUrl` string — The URL of the MCP Server for this service. This is required if the "type" is "MCP_SERVER_REMOTE" or "MCP_SERVER_LOCAL".
  - `openApiSpecUrl` string — The URL of the OpenAPI specification for this service. This is required if the "type" is "API".
  - `websiteUrl` string — The URL of the website. This is required if the "type" is "WEB_PAGE".
  - `fetchAgentProfileUrl` string — The URL of the Fetch.ai agent. This is required if the "type" is "FETCH_AGENT".
  - `humanIdentityRequirement` object, required — The identity verification requirements for individuals, organizations, or both. See https://docs.skyfire.xyz/reference/identity-fields for more info.
    - `individual` string[], required — List of identity fields required from verified individuals. An empty array indicates no verification required.
    - `organization` string[], required — List of identity fields required from verified organizations. An empty array indicates no verification required.
  - `termsOfService` object — The details of the terms of service if they exist.
    - `url` string — The URL where the terms of service are available to review.
    - `required` boolean — 'true' if acceptance of the terms of service is required.
  - `acceptedTokens` string[] — 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.
  - `maxTokenTTLSeconds` number — Maximum token TTL in seconds between 10s and 24hr.

## Response `200`

200

- object
  - `name` string, required
  - `description` string, required
  - `tags` string[], required
  - `type` string, required — One of "API", "WEB_PAGE", "VERIFIED_DOMAIN", "MCP_SERVER_LOCAL", "MCP_SERVER_REMOTE", or "FETCH_AGENT"
  - `price` string, required — USD as string. For priceModel: CUSTOM, use "0".
  - `priceModel` string, required — One of "PAY_PER_USE", "SUBSCRIPTION", "PAY_PER_MB", or "CUSTOM"
  - `minimumTokenAmount` string, required — USD as string. For CUSTOM, use "0". Must be ≥ price after numeric conversion.
  - `humanIdentityRequirement` object, required
    - `identityLevels` string[]
    - `organization` string[] — Values must be allowed identity field names.
    - `individual` string[] — Values must be allowed identity field names.
  - `openApiSpecUrl` string — Required when `type` is API.
  - `websiteUrl` string — Required when `type` is WEBPAGE.
  - `fetchAgentProfileUrl` string — Required when `type` is FETCH_AGENT.
  - `mcpServerUrl` string — Required when `type` is MCP_SERVER_LOCAL or MCP_SERVER_REMOTE.
  - `termsOfService` object
    - `url` string
    - `required` boolean
  - `acceptedTokens` string[] — Any of "kya", "pay", and/or "kya-pay". Must not be an empty array. If field is omitted, then all token types are accepted.
  - `maxTokenTTLSeconds` number — Maximum token TTL in seconds.

## Other responses

- `422` — 422

---

[API](https://skmtc.net/skyfire/apis/skyfire-agent-and-token-apis.md) · [All operations](https://skmtc.net/skyfire/apis/skyfire-agent-and-token-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyfire/skyfire-agent-and-token-apis/revisions/209ba8f90d59/schema)