skills.rest
humansys
humansysOFFICIAL
Explore all skills by this author →
WebsiteGitHub

rai-mcp-remove

Remove an MCP server from RaiSE after validating no dependent adapters exist.

71|8|Updated Feb 13, 2026
Search Tags:#mcp#yaml#config#server#dependency#rai#unregister
One-click install
npx skills add https://github.com/humansys/raise --skill rai-mcp-remove
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rai-mcp-remove
Source: https://github.com/humansys/raise/tree/main/packages/raise-cli/src/raise_cli/skills_base/rai-mcp-remove
Command: npx skills add https://github.com/humansys/raise --skill rai-mcp-remove

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safely unregister an MCP server from your RaiSE project only after confirming no adapter dependencies exist that would be broken by removal.

Core Features & Use Cases

  • Dependency-aware removal: Checks for references to the target MCP server in .raise/adapters and prevents deletion if dependencies are found.
  • Safe override when no dependencies exist: Allows removal when there are no dependent adapters, with a clear migration note.
  • Use Case: When you need to clean up unused MCP servers without destabilizing the governance configuration.

Quick Start

Provide the server_name argument to remove a registered MCP server once all dependencies are verified.

Frequently Asked Questions about rai-mcp-remove

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I unregister an MCP server from my YAML config safely?▼

To unregister an MCP server safely, the system checks for adapter dependencies in your project directory and deletes the YAML config only after confirming no references exist. This prevents broken governance configurations by validating adapters before removal.

What happens if I try to remove an MCP server that has dependent adapters?▼

If dependent adapters exist in the .raise/adapters directory, the MCP server removal process aborts to prevent breaking your configuration. You must resolve or remove those adapter references before the YAML config can be safely deleted.

How do I check adapter dependencies before deleting an MCP server?▼

Dependency checking is automated during the unregistration process. The tool scans the .raise/adapters directory for references to the target MCP server and blocks deletion if any are found, ensuring safe removal without manual verification.

Can I force remove an MCP server when no adapters are using it?▼

Yes, when no dependent adapters are found in the .raise/adapters directory, the MCP server can be removed. The tool provides a clear migration note and safely deletes the YAML config after confirming there are zero references.

Why does removing an MCP server cause configuration errors in RaiSE?▼

Removing an MCP server causes configuration errors when dependent adapters still reference it. The unregistration tool prevents this by scanning for adapter references and aborting the deletion if dependencies are detected, ensuring governance stability.

Related Skills

Explore More Software Engineering Skills→
blueman82blueman82
1

adapter-factory

Create CLI and HTTP adapters for AI models with configuration and testing.

Community
Advanced
alicanerdoganalicanerdogan
1

add-mcp-server

Add and configure MCP server entries in pi-mcp-adapter configurations.

Community
Intermediate
humansyshumansys
71

rai-welcome

Detects project state and guides users through profile creation and setup verification.

Official
Advanced
schpetschpet
5

svbump

Read and write semantic versions across JSON, TOML, and YAML config files.

Community
Basic