Ring Skills MCP Service

An MCP (Model Context Protocol) service for fetching and installing company Skills.

Features

• list_skills - Fetch company Skills and Skill Groups list, supports search and pagination
• install_skill - Install skill to local project by gitUrl (supports GitHub and GitLab)
• install_skill_group - Install all skills from a skill group to local project

Installation

npm install
npm run build

Configuration

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | SKILLS_API_HOST | API server address | None | | SKILLS_AUTH_TOKEN | API authentication token (required) | None |

Usage in Cursor

Add the following MCP configuration in Cursor settings:

Option 1: Run with npx (Recommended)

{
  "mcpServers": {
    "ring-skills-mcp": {
      "command": "npx",
      "args": ["ring-skills-mcp@latest"],
      "env": {
        "SKILLS_API_HOST": "http://your-api-host:8000",
        "SKILLS_AUTH_TOKEN": "your-auth-token-here"
      }
    }
  }
}

Option 2: Run with Node

{
  "mcpServers": {
    "ring-skills-mcp": {
      "command": "node",
      "args": ["/path/to/ring-skills-mcp/dist/index.js"],
      "env": {
        "SKILLS_API_HOST": "http://your-api-host:8000",
        "SKILLS_AUTH_TOKEN": "your-auth-token-here"
      }
    }
  }
}

Option 3: Run with npx (development mode)

{
  "mcpServers": {
    "ring-skills-mcp": {
      "command": "npx",
      "args": ["tsx", "/path/to/ring-skills-mcp/src/index.ts"],
      "env": {
        "SKILLS_API_HOST": "http://your-api-host:8000",
        "SKILLS_AUTH_TOKEN": "your-auth-token-here"
      }
    }
  }
}

Tool Documentation

list_skills

Fetch company Skills and Skill Groups list. When searching, it returns both matching skills and skill groups that contain skills with the searched capability.

Parameters:

• host (optional): API server address
• search (optional): Search keyword for filtering skills and skill groups
• pageSize (optional): Number of results per page, default 5000
• token (required): Authorization token, can be passed as parameter or set via environment variable SKILLS_AUTH_TOKEN

Returns:

• Skills: Individual skills matching the search keyword
• Skill Groups: Groups that contain skills matching the search keyword, with full group description and all skills in the group

Example usage:

Get all skills list
Search for skills containing "pdf"
Search for skills with "account" capability

install_skill

Install the specified skill to local project by gitUrl.

Parameters:

• gitUrl (required): Git URL of the skill. Supports both GitHub and GitLab URLs.
• projectPath (required): Project path where the skill will be installed. Please provide the project root directory path of the currently opened file in IDE
• targetDir (optional): Installation target directory, default is .claude/skills

Supported URL Formats:

| Platform | URL Format | Installation Method | |----------|------------|---------------------| | GitHub | https://github.com/{owner}/{repo}/tree/{branch}/{path} | npx degit (fast, no git history) | | GitLab | https://{host}/{owner}/{repo}/-/tree/{branch}/{path} | git sparse-checkout (supports private repos) |

Example URLs:

# GitHub
https://github.com/anthropics/skills/tree/main/skills/docx

# GitLab (self-hosted)
https://git.ringcentral.com/ai-testing/aiter-skills/-/tree/main/.agent/skills/nova-scripts-generator

Example usage:

Install skill from GitHub URL to /Users/xxx/my-project
Install skill from GitLab URL to /Users/xxx/my-project

install_skill_group

Install all skills from a skill group to local project.

Parameters:

• groupId (required): The ID of the skill group to install (e.g., '697190fc88f4e586fb1a7114')
• host (optional): API server address
• token (optional): Authorization token, can be passed as parameter or set via environment variable SKILLS_AUTH_TOKEN
• projectPath (required): Project path where the skills will be installed
• targetDir (optional): Installation target directory, default is .claude/skills

Example usage:

Install all skills from skill group "697190fc88f4e586fb1a7114" to /Users/xxx/my-project

Output:

• Shows the group name and icon
• Lists all successfully installed skills
• Reports any installation errors

Development

# Run in development mode
npm run dev

# Build
npm run build

# Run built version
npm start

API Response Format

The service supports the following API response formats:

// Format 1: Direct array
[{ "id": "1", "name": "skill1" }]

// Format 2: data field
{ "data": [{ "id": "1", "name": "skill1" }] }

// Format 3: skills field
{ "skills": [{ "id": "1", "name": "skill1" }] }

// Format 4: items field
{ "items": [{ "id": "1", "name": "skill1" }] }

License

MIT