How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Smithery servers API

Browse the MCP server registry, manage server configuration, and handle deployments

Smithery servers API is one of 9 APIs that Smithery publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Servers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a JSON-LD context, rate-limit docs, and 3 JSON Schemas.

This API exposes 19 operations across 12 paths, and defines 30 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://api.smithery.ai.

19 operations 12 paths 30 schemas 3 DELETE10 GET1 PATCH1 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.smithery.ai
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Smithery servers API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Smithery API key as Bearer token

Paths & Operations 19

Across 12 paths, the API surfaces 19 operations — 3 DELETE, 10 GET, 1 PATCH, 1 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

servers 19

Browse the MCP server registry, manage server configuration, and handle deployments

GET
/servers/{qualifiedName}
Get a server
getServers:namespace 1 param → 200404
PUT
/servers/{qualifiedName}
Create a server
putServers:namespace 1 param body → 201400401403404
PATCH
/servers/{qualifiedName}
Update a server
patchServers:namespace 1 param body → 200400403404
DELETE
/servers/{qualifiedName}
Delete a server
deleteServers:namespace 1 param → 200404
GET
/servers/{qualifiedName}/download
Download server bundle
getServers:namespaceDownload 1 param → 200404
PUT
/servers/{qualifiedName}/releases
Publish a server
putServers:namespaceReleases 1 param body → 202400
GET
/servers/{qualifiedName}/releases
List releases
getServers:namespaceReleases 3 params → 200404
GET
/servers/{qualifiedName}/releases/{id}
Get a release
getServers:namespaceReleases:id 2 params → 200404
GET
/servers/{qualifiedName}/releases/{id}/stream
Stream release logs
getServers:namespaceReleases:idStream 2 params → 200404
POST
/servers/{qualifiedName}/releases/{id}/resume
Resume a release
postServers:namespaceReleases:idResume 2 params → 202400404
GET
/servers/{qualifiedName}/logs
List runtime logs
getServers:namespaceLogs 5 params → 200403404500
GET
/servers/{qualifiedName}/secrets
List secrets
getServers:namespaceSecrets 1 param → 200404
PUT
/servers/{qualifiedName}/secrets
Set a secret
putServers:namespaceSecrets 1 param body → 200404
DELETE
/servers/{qualifiedName}/secrets/{secretName}
Delete a secret
deleteServers:namespaceSecrets:secretName 2 params → 200404
PUT
/servers/{qualifiedName}/icon
Upload server icon
putServers:namespaceIcon 1 param → 200400403404
DELETE
/servers/{qualifiedName}/icon
Delete server icon
deleteServers:namespaceIcon 1 param → 200403404
GET
/servers/{qualifiedName}/icon
Get server icon
getServers:namespaceIcon 1 param → 200404
GET
/servers/{qualifiedName}/experimental/tools/{toolName}/output-schema
Infer a tool output schema
getServers:namespaceExperimentalTools:toolNameOutput-schema 2 params → 200401403404503
GET
/servers
List all servers
getServers 16 params → 200400401422

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are ServerSummary (16 properties), Server (11 properties), DeploymentInfo (11 properties), Invocation (7 properties). Each schema is shown below with its type and property counts.

StdioConnection
object
4 properties 4 required
InputSchemaProperties
object
InvocationRequest
object
2 properties 2 required
Server
object
11 properties 11 required
ServerTool
object
4 properties 3 required
DeploymentError
object
1 property 1 required
ServerPrompt
object
3 properties 1 required
InvocationResponse
object
2 properties 2 required
RuntimeLogEntry
object
3 properties 3 required
ConfigSchema
object
RuntimeLogsError
object
1 property 1 required
ToolOutputSchema
object
3 properties 1 required
ServerSecurity
object
1 property 1 required
ResumeResponse
object
2 properties 2 required
DeploymentLogEntryError
object
1 property
HttpConnection
object
3 properties 3 required
OutputSchemaProperties
object
Invocation
object
7 properties 7 required
RuntimeLogsResponse
object
2 properties 2 required
ToolInputSchema
object
2 properties 1 required
ServersListError
object
1 property 1 required
DeployResponse
object
4 properties 3 required
DeploymentLogEntry
object
5 properties 4 required
ServerSummary
object
16 properties 16 required
RegistryError
object
1 property 1 required
ExceptionEntry
object
3 properties 3 required
DeploymentInfo
object
11 properties 5 required
ServerResource
object
4 properties 2 required
ServersListResponse
object
2 properties 2 required
InvocationDuration
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

smithery-servers-api-openapi.yml Raw ↑

Other APIs Smithery publishes across the network.

Smithery connect API
Smithery connect.mcp API
Smithery domains API
Smithery Health API
Smithery namespaces API
Smithery organizations API
Smithery skills API
Smithery tokens API
Where this information came from

This is an independent, third-party profile of Smithery servers API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.