Smithery · JSON Structure

Smithery Server Structure

JSON structure documentation for a Smithery MCP server object

Type: object Properties: 0
Artificial IntelligenceLarge Language ModelsMCPModel Context ProtocolAI AgentsDeveloper ToolsRegistrySkillsTool Discovery

Smithery Server Structure is a JSON Structure definition published by Smithery.

Meta-schema:

JSON Structure

Raw ↑
{
  "title": "Smithery MCP Server Structure",
  "description": "JSON structure documentation for a Smithery MCP server object",
  "type": "object",
  "fields": [
    {"name": "qualifiedName", "type": "string", "required": true, "description": "Unique identifier in namespace/server format"},
    {"name": "displayName", "type": "string", "required": true, "description": "Human-readable server name"},
    {"name": "description", "type": "string", "required": false, "description": "What the server does"},
    {"name": "iconUrl", "type": "uri", "required": false, "description": "Server icon image URL"},
    {"name": "isVerified", "type": "boolean", "required": false, "description": "Smithery verification status"},
    {"name": "useCount", "type": "integer", "required": false, "description": "Usage/install count"},
    {"name": "namespace", "type": "string", "required": false, "description": "Owning namespace"},
    {"name": "tools", "type": "array", "required": false, "description": "MCP tools exposed by the server", "items": {
      "type": "object",
      "fields": [
        {"name": "name", "type": "string"},
        {"name": "description", "type": "string"},
        {"name": "inputSchema", "type": "object"}
      ]
    }},
    {"name": "connections", "type": "array", "required": false, "description": "Available connection methods", "items": {
      "type": "object",
      "fields": [
        {"name": "type", "type": "enum", "values": ["http", "stdio", "uplink"]},
        {"name": "url", "type": "uri"},
        {"name": "configSchema", "type": "object"}
      ]
    }},
    {"name": "createdAt", "type": "datetime", "required": false},
    {"name": "updatedAt", "type": "datetime", "required": false}
  ]
}