Smithery · Schema

Smithery MCP Server

Schema for the MCP server resource in the Smithery Platform API. A server is identified by its qualifiedName (namespace/server) and exposes one or more tools via the Model Context Protocol. Returned by GET /servers and GET /servers/{qualifiedName}.

AIAgentsMCPModel Context ProtocolRegistryHostingToolsSkillsMarketplaceDeveloper Platform

Properties

Name	Type	Description
qualifiedName	string	Fully qualified server name in the form `namespace/server`.
displayName	string	Human-readable display name for the server.
description	string	Short description of what the server does.
homepage	string	Optional homepage URL for the server.
iconUrl	string	URL of the server icon (uploaded via PUT /servers/{qualifiedName}/icon, max 1 MB).
namespace	string	The namespace under which the server is published.
owner	object	The user or organization that owns the namespace.
transport	string	The MCP transport this server uses. Smithery hosts Streamable HTTP servers and distributes stdio servers via MCPB bundles.
hosted	boolean	Whether the server is hosted on Smithery infrastructure (true) or registered as an external server (false).
deployment	object	Latest deployment metadata for the server.
domains	array	Custom domains associated with this server.
tools	array	Tools exposed by the server.
triggers	array	Trigger types exposed by the server.
tags	array
license	string
sourceUrl	string
stats	object
createdAt	string
updatedAt	string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.com/schemas/smithery/smithery-server-schema.json",
  "title": "Smithery MCP Server",
  "description": "Schema for the MCP server resource in the Smithery Platform API. A server is identified by its qualifiedName (namespace/server) and exposes one or more tools via the Model Context Protocol. Returned by GET /servers and GET /servers/{qualifiedName}.",
  "type": "object",
  "required": ["qualifiedName"],
  "properties": {
    "qualifiedName": {
      "type": "string",
      "description": "Fully qualified server name in the form `namespace/server`.",
      "pattern": "^[a-z0-9_-]+/[a-z0-9_-]+$"
    },
    "displayName": {
      "type": "string",
      "description": "Human-readable display name for the server."
    },
    "description": {
      "type": "string",
      "description": "Short description of what the server does."
    },
    "homepage": {
      "type": "string",
      "format": "uri",
      "description": "Optional homepage URL for the server."
    },
    "iconUrl": {
      "type": "string",
      "format": "uri",
      "description": "URL of the server icon (uploaded via PUT /servers/{qualifiedName}/icon, max 1 MB)."
    },
    "namespace": {
      "type": "string",
      "description": "The namespace under which the server is published."
    },
    "owner": {
      "type": "object",
      "description": "The user or organization that owns the namespace.",
      "properties": {
        "type": { "type": "string", "enum": ["user", "organization"] },
        "id": { "type": "string" },
        "name": { "type": "string" }
      }
    },
    "transport": {
      "type": "string",
      "enum": ["streamable-http", "stdio", "sse"],
      "description": "The MCP transport this server uses. Smithery hosts Streamable HTTP servers and distributes stdio servers via MCPB bundles."
    },
    "hosted": {
      "type": "boolean",
      "description": "Whether the server is hosted on Smithery infrastructure (true) or registered as an external server (false)."
    },
    "deployment": {
      "type": "object",
      "description": "Latest deployment metadata for the server.",
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "description": "Streamable HTTP endpoint for the server."
        },
        "bundleUrl": {
          "type": "string",
          "format": "uri",
          "description": "URL to the MCPB bundle for stdio servers (download via GET /servers/{qualifiedName}/download)."
        },
        "version": { "type": "string" },
        "releaseId": { "type": "string" }
      }
    },
    "domains": {
      "type": "array",
      "description": "Custom domains associated with this server.",
      "items": {
        "type": "object",
        "properties": {
          "id": { "type": "string" },
          "domain": { "type": "string" },
          "managed": { "type": "boolean" }
        }
      }
    },
    "tools": {
      "type": "array",
      "description": "Tools exposed by the server.",
      "items": { "$ref": "#/$defs/Tool" }
    },
    "triggers": {
      "type": "array",
      "description": "Trigger types exposed by the server.",
      "items": { "$ref": "#/$defs/Trigger" }
    },
    "tags": {
      "type": "array",
      "items": { "type": "string" }
    },
    "license": { "type": "string" },
    "sourceUrl": { "type": "string", "format": "uri" },
    "stats": {
      "type": "object",
      "properties": {
        "installs": { "type": "integer", "minimum": 0 },
        "calls30d": { "type": "integer", "minimum": 0 }
      }
    },
    "createdAt": { "type": "string", "format": "date-time" },
    "updatedAt": { "type": "string", "format": "date-time" }
  },
  "$defs": {
    "Tool": {
      "type": "object",
      "required": ["name"],
      "properties": {
        "name": { "type": "string" },
        "description": { "type": "string" },
        "inputSchema": { "type": "object", "description": "JSON Schema for the tool's input arguments." },
        "outputSchema": { "type": "object", "description": "Optional Zod-inferable JSON Schema for the tool's output." },
        "category": { "type": "string" },
        "hints": {
          "type": "object",
          "properties": {
            "readOnly": { "type": "boolean" },
            "destructive": { "type": "boolean" },
            "idempotent": { "type": "boolean" }
          }
        }
      }
    },
    "Trigger": {
      "type": "object",
      "required": ["name"],
      "properties": {
        "name": { "type": "string" },
        "description": { "type": "string" },
        "schema": { "type": "object" }
      }
    }
  }
}