Agent Skills · JSON Structure

Agent Skills Mcp Server Structure

A Model Context Protocol server that exposes agent skills (tools, resources, prompts) to AI clients.

Type: object Properties: 6 Required: 2

Agent SkillsAI AgentsTool UseFunction CallingMCPAgentic AIAutomation

MCPServer is a JSON Structure definition published by Agent Skills, describing 6 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

name version transport tools resources prompts

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/agent-skills/refs/heads/main/json-structure/agent-skills-mcp-server-structure.json",
  "name": "MCPServer",
  "description": "A Model Context Protocol server that exposes agent skills (tools, resources, prompts) to AI clients.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the MCP server.",
      "example": "filesystem-server"
    },
    "version": {
      "type": "string",
      "description": "Server version.",
      "example": "1.0.0"
    },
    "transport": {
      "type": "string",
      "description": "Communication transport used by the server.",
      "enum": [
        "http",
        "stdio",
        "websocket"
      ],
      "example": "http"
    },
    "tools": {
      "type": "array",
      "description": "List of tools exposed by this MCP server.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "inputSchema": {
            "type": "object"
          }
        }
      }
    },
    "resources": {
      "type": "array",
      "description": "List of resources (data sources) the server can provide.",
      "items": {
        "type": "object",
        "properties": {
          "uri": {
            "type": "uri"
          },
          "name": {
            "type": "string"
          },
          "mimeType": {
            "type": "string"
          }
        }
      }
    },
    "prompts": {
      "type": "array",
      "description": "Reusable prompt templates exposed by the server.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "name",
    "transport"
  ]
}