Infer a tool output schema - Smithery Documentation

GET

servers

{qualifiedName}

experimental

tools

{toolName}

output-schema

Infer a tool output schema

curl --request GET \
  --url https://api.smithery.ai/servers/{qualifiedName}/experimental/tools/{toolName}/output-schema \
  --header 'Authorization: Bearer <token>'

{
  "qualifiedName": "smithery-ai/github",
  "toolName": "search_repositories",
  "sampleCount": 25,
  "zodSchema": "z.object({ \"items\": z.array(z.object({})).optional() })"
}

Authorizations

Authorization

string

header

required

Smithery API key as Bearer token

Path Parameters

qualifiedName

string

required

The server's qualified name (e.g. 'namespace/server' or 'namespace' for namespace-only servers). Use %2F to encode the slash.

toolName

string

required

Response

Inferred tool output schema

qualifiedName

string

required

Example:

"smithery-ai/github"

toolName

string

required

Example:

"search_repositories"

sampleCount

number

required

Example:

25

zodSchema

string

required

Example:

"z.object({ \"items\": z.array(z.object({})).optional() })"

List all serversSearch and browse public MCP servers in the Smithery registry. Supports full-text and semantic search via the `q` parameter, and filtering by deployment status, verification, ownership, and more.

⌘I

Infer a tool output schema

curl --request GET \
  --url https://api.smithery.ai/servers/{qualifiedName}/experimental/tools/{toolName}/output-schema \
  --header 'Authorization: Bearer <token>'

{
  "qualifiedName": "smithery-ai/github",
  "toolName": "search_repositories",
  "sampleCount": 25,
  "zodSchema": "z.object({ \"items\": z.array(z.object({})).optional() })"
}