API reference

API reference · Account

List an MCP server on the tools market

POST/api/tools/serversSigned in session

Same origin. The server is listed for its tools before anything is saved, and every priced tool must be among them. At most 5 live servers an account. The operator reviews every one at /admin/tools. A 404 at every path while the operator has not opened the tools market.

Request body

application/json, required

Request body fields
FieldTypeWhat it is
slugrequiredstring2 to 32 lower case letters, digits and single hyphens.
namerequiredstring
descriptionrequiredstring
categoryrequiredstringOne of "search", "data", "code", "media", "finance", "chain", "productivity", "other".
urlrequiredstringThe MCP endpoint, https.
headerobject
header.namerequiredstringA header name, lower case.
header.valuerequiredstringStored encrypted, never returned.
payout_addressrequiredstringAn EVM address.
toolsrequiredarray of object
tools[].namerequiredstring
tools[].price_usdrequirednumberThe provider's own price per call in dollars, before the margin. From 0 to 5.

Example

{
  "slug": "string",
  "name": "string",
  "description": "string",
  "category": "search",
  "url": "string",
  "payout_address": "string",
  "tools": [
    {
      "name": "string",
      "price_usd": 0
    }
  ]
}

Answer 201

The listings, the new one pending review.

Fields of the 201 answer
FieldTypeWhat it is
serversarray of object

Errors

  • 400OpenAI shaped error.
  • 401OpenAI shaped error.
  • 404OpenAI shaped error.
  • 409OpenAI shaped error.
  • 422OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.

Antimatter