# MCP Configurator

Add or update workspace MCP servers using holaOS mcp_registry syntax.

- Repository: https://github.com/holaboss-ai/holaOS (11451 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add holaboss-ai/holaOS --skill mcp-configurator -g -a claude-code -y`
Codex: `npx skills add holaboss-ai/holaOS --skill mcp-configurator -g -a codex -y`
Cursor: `npx skills add holaboss-ai/holaOS --skill mcp-configurator -g -a cursor -y`
Gemini CLI: `npx skills add holaboss-ai/holaOS --skill mcp-configurator -g -a gemini-cli -y`

## Description

Add or update workspace MCP servers using holaOS mcp_registry syntax.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MCP Configurator

Use this skill when the task is to add, remove, or update MCP access in a holaOS workspace.

## Core Rules
1. Edit `workspace.yaml` at the workspace root. Do not create `mcp.json`, `.cursor/mcp.json`, `claude_desktop_config.json`, or another generic MCP config unless the user explicitly asks for that format.
2. Workspace-level MCP lives under `mcp_registry`.
3. Tool ids in `mcp_registry.allowlist.tool_ids` must use strict `server.tool` syntax.
4. Omitting `mcp_registry.allowlist.tool_ids` or setting it to `[]` means all discovered tools from enabled configured servers stay available for that run.
5. Mixed mode is valid: some servers can be constrained by explicit allowlisted tool ids while other enabled servers stay discover-all.
6. This embedded skill is guidance only. When the user asks to add MCP to a workspace, update the target workspace config instead of writing new files under `runtime/harnesses/src/embedded-skills/`.

## Remote Server Shape

Use this shape for remote HTTP MCP servers:

```yaml
mcp_registry:
  servers:
    context7:
      type: remote
      url: https://mcp.context7.com/mcp
      enabled: true
      timeout_ms: 30000
      headers:
        CONTEXT7_API_KEY: "{env:CONTEXT7_API_KEY}"
  allowlist:
    tool_ids:
      - context7.lookup
      - context7.search
```

Header values must be either:
- a literal secret value
- or `{env:ENV_VAR_NAME}`

This is invalid:

```yaml
headers:
  CONTEXT7_API_KEY: "{env:ctx7sk-live-abc123}"
```

That is a placeholder-shaped literal secret, not an environment-variable reference.

## Local Server Shape

Use this shape for local stdio MCP servers:

```yaml
mcp_registry:
  servers:
    my_server:
      type: local
      command:
        - npx
        - -y
        - "@acme/my-mcp"
      enabled: true
      timeout_ms: 30000
      environment:
        MY_SERVER_API_KEY: "{env:MY_SERVER_API_KEY}"
```

Local MCP commands must be a non-empty list of command tokens.

## Workspace Tool Catalog Shape

The rest: https://github.com/holaboss-ai/holaOS/blob/HEAD/runtime/harnesses/src/embedded-skills/mcp-configurator/SKILL.md