Skill4agent MCP Server logo

Skill4agent MCP Server

by osulivan

Searches skill4agent, reads SKILL.md documentation, and returns installation information through MCP.

Install Skill4agent MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "osulivan-skill4agent-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@skill4agent/mcp-server"
      ],
      "env": {
        "SKILL4AGENT_API_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The osulivan/skill4agent-mcp-server MCP server connects AI applications to the skill4agent API for discovering and evaluating AI skills. It exposes tools to search by keyword and category, retrieve a skill's complete SKILL.md content, and obtain installation methods. Run it through npm or npx as an MCP stdio server, with an optional environment variable for a custom API endpoint. Reach for it when an agent needs to identify a suitable skill, inspect its documentation, or prepare installation instructions during a conversation.

Use cases

  • Search the skill catalog by domain or keyword
  • Review a skill's complete SKILL.md before using it
  • Get installation commands for a selected skill
  • Point the server at a custom skill4agent API endpoint

Key features

  • Keyword and category skill search
  • English and Chinese category filters
  • Configurable search result limits
  • Complete SKILL.md retrieval
  • Installation links and commands
  • Custom API endpoint configuration

Tools3

What Skill4agent MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~635 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

18/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · @skill4agent/mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads75Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Tools exposed3Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Skill4agent MCP Server works

What osulivan/skill4agent-mcp-server MCP server does

The osulivan/skill4agent-mcp-server MCP server makes skill4agent's skill catalog available to MCP-compatible AI applications. It focuses on three stages of working with a skill: discovery, inspection, and installation guidance. An agent can search the catalog, examine the full documentation associated with a result, and request the available download links or installation commands.

This is a catalog and information interface rather than a tool that installs files directly. The installation operation returns information needed to install a selected skill. A typical workflow is to search with a broad term, use the returned skill ID with the detail tool, assess the SKILL.md content, and then request installation information for the chosen result.

How it works

The package communicates with the skill4agent API through MCP tools. search_skills requires a keyword and accepts optional category and result-limit parameters. Categories can be supplied in English or Chinese. The default result limit is 10, and the maximum is 100.

get_skill requires a skillId, normally obtained from search_skills. It returns detailed information for that skill, including the complete SKILL.md content. install_skill also takes a skillId and provides the skill's installation information, including download links and installation commands as described by the project.

The server is launched as a command process, making it suitable for MCP clients that support standard command-based server configuration.

Setup and configuration

Install the package globally with npm:

Terminal
npm install -g @skill4agent/mcp-server

Alternatively, run it without a global install:

Terminal
npx @skill4agent/mcp-server

For a Claude Desktop setup, add an MCP server entry whose command is npx and whose argument list runs the package with -y. The server uses https://skill4agent.com/api/mcp by default. Set SKILL4AGENT_API_URL in the client's env object to point to a different API endpoint, such as a custom deployment.

Local development uses the repository's normal Node.js workflow: install dependencies with npm install, build with npm run build, use npm run dev for development mode, or run the compiled entry point with node dist/index.js.

Tools and capabilities

The osulivan/skill4agent-mcp-server MCP server provides these tools:

  • search_skills: Finds skills using a required keyword, with optional category filtering and a configurable result limit.
  • get_skill: Retrieves detailed information and the full SKILL.md document for a required skill ID.
  • install_skill: Returns installation information for a required skill ID, including available links and commands.

The tools support a decision process before installation: search can narrow the catalog, the detail operation can expose the skill's documentation for review, and the installation operation can provide the next commands or links.

Limitations and notes

get_skill and install_skill depend on a valid skill ID; the documented way to obtain one is from search results. Category filtering is optional, while the search keyword is required.

Claude Desktop is the only client shown in the README configuration example; other MCP clients may require their own command-server configuration format.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Skill4agent MCP Server

osulivan/skill4agent-mcp-server is an MCP server that connects AI applications to the skill4agent API. Its main tools search skills by keyword, retrieve a selected skill's complete SKILL.md documentation, and return installation links and commands for that skill.

Install it with `npm install -g @skill4agent/mcp-server`, or run it directly with `npx @skill4agent/mcp-server`. Configure the resulting command as an MCP server in your client.

Set `SKILL4AGENT_API_URL` in the MCP server environment configuration. If it is not set, the server uses `https://skill4agent.com/api/mcp`.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSkill4agent MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/osulivan-skill4agent-mcp-server?style=directory)](https://allmcps.com/mcp/osulivan-skill4agent-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/osulivan-skill4agent-mcp-server"><img src="https://allmcps.com/api/badge/osulivan-skill4agent-mcp-server?style=directory" alt="Skill4agent MCP Server on AllMCPs" /></a>