Docs / MCP

The Skyboy MCP server

Expose the whole skyboy.in catalog as callable tools so any MCP-compatible agent can search, preview, and install a skill without leaving the conversation. Published on both npm and PyPI.

Tools it exposes

search_skills

Fuzzy search the catalog

get_skill

Preview a skill + its permissions

get_plugin

Return a plugin manifest (index + link)

list_categories

Return the taxonomy tree

check_updates

Compare installed to catalog versions

install_skill

local/stdio only. Writes to your filesystem, so it never runs on the hosted remote.

stdio, local, full surface

Run it yourself for the full tool set including install_skill. Both package managers install the same server.

npm

npx -y @skyboy/mcp-server

PyPI

uvx skyboy-mcp

pipx install skyboy-mcp && skyboy-mcp

pip install skyboy-mcp && python -m skyboy_mcp

The PyPI wrapper shells to the npm package, so it needs Node available at runtime. The npm package is the full-featured server.

npm client config

{
  "mcpServers": {
    "skyboy": {
      "command": "npx",
      "args": [
        "-y",
        "@skyboy/mcp-server"
      ]
    }
  }
}

uvx client config

{
  "mcpServers": {
    "skyboy": {
      "command": "uvx",
      "args": [
        "skyboy-mcp"
      ]
    }
  }
}

Hosted remote, read-only

The deployed endpoint at https://mcp.skyboy.in serves the read-only tools only. No local process, nothing to manage. install_skill is omitted because it writes to a local filesystem and needs local trust.

{
  "mcpServers": {
    "skyboy": {
      "type": "http",
      "url": "https://mcp.skyboy.in"
    }
  }
}

Use it from the CLI too: skyboy add <slug> installs a skill directly. See the MCP agent guide for a walkthrough.