API reference · Account
Read an MCP server's tools before pricing them
POST/api/tools/inspectSigned in session
Same origin, ten a minute. The server is reached through the network guard; the header is used for this listing and not kept. A 404 at every path while the operator has not opened the tools market.
Request body
application/json, required
| Field | Type | What it is |
|---|---|---|
| urlrequired | string | |
| header | object | |
| header. | string | A header name, lower case. |
| header. | string | Stored encrypted, never returned. |
Example
{
"url": "string",
"header": {
"name": "string",
"value": "string"
}
}Answer 200
The tools the server lists and how long the listing took.
| Field | Type | What it is |
|---|---|---|
| tools | array of object | |
| ms | integer |
Errors
- 400OpenAI shaped error.
- 401OpenAI shaped error.
- 404OpenAI 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.