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
| Field | Type | What it is |
|---|---|---|
| slugrequired | string | 2 to 32 lower case letters, digits and single hyphens. |
| namerequired | string | |
| descriptionrequired | string | |
| categoryrequired | string | One of "search", "data", "code", "media", "finance", "chain", "productivity", "other". |
| urlrequired | string | The MCP endpoint, https. |
| header | object | |
| header. | string | A header name, lower case. |
| header. | string | Stored encrypted, never returned. |
| payout_addressrequired | string | An EVM address. |
| toolsrequired | array of object | |
| tools[] | string | |
| tools[] | number | The 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.
| Field | Type | What it is |
|---|---|---|
| servers | array 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.