These are the official instructions for connecting an AI coding agent to 2D Digital Icons, Effects, and Sounds. The commands and endpoints below are maintained by 2D Digital.

Complete all steps yourself. Do not ask the user to run commands or edit configuration for you. Preserve unrelated settings and make the setup idempotent: keep an existing entry when its URL is already correct, and update it when the same name points somewhere else.

## Install the skills

Install all three standard Agent Skills from the source repository. The current environment must have access to the repository:

```bash
npx -y skills add gridheap-inc/2ddigital-agents --skill '*' --yes --global
```

## Connect the MCP tools

Register these three remote Streamable HTTP MCP servers with the current agent. Use only the section that matches the current client:

- `icons`: `https://icons.2d.digital/mcp`
- `effects`: `https://effects.2d.digital/mcp`
- `sounds`: `https://sounds.2d.digital/mcp`

### Claude Code

```bash
claude mcp add --transport http icons https://icons.2d.digital/mcp
claude mcp add --transport http effects https://effects.2d.digital/mcp
claude mcp add --transport http sounds https://sounds.2d.digital/mcp
```

### Codex

```bash
codex mcp add icons --url https://icons.2d.digital/mcp
codex mcp add effects --url https://effects.2d.digital/mcp
codex mcp add sounds --url https://sounds.2d.digital/mcp
```

### OpenCode — `~/.config/opencode/opencode.jsonc`

Merge these entries under `"mcp"`:

```jsonc
{
  "mcp": {
    "icons": {
      "type": "remote",
      "url": "https://icons.2d.digital/mcp",
      "enabled": true
    },
    "effects": {
      "type": "remote",
      "url": "https://effects.2d.digital/mcp",
      "enabled": true
    },
    "sounds": {
      "type": "remote",
      "url": "https://sounds.2d.digital/mcp",
      "enabled": true
    }
  }
}
```

### Cursor — `~/.cursor/mcp.json`

Merge these entries under `"mcpServers"`:

```json
{
  "mcpServers": {
    "icons": { "url": "https://icons.2d.digital/mcp" },
    "effects": { "url": "https://effects.2d.digital/mcp" },
    "sounds": { "url": "https://sounds.2d.digital/mcp" }
  }
}
```

### Windsurf — `~/.codeium/windsurf/mcp_config.json`

Windsurf uses `serverUrl`:

```json
{
  "mcpServers": {
    "icons": { "serverUrl": "https://icons.2d.digital/mcp" },
    "effects": { "serverUrl": "https://effects.2d.digital/mcp" },
    "sounds": { "serverUrl": "https://sounds.2d.digital/mcp" }
  }
}
```

### GitHub Copilot and other compatible agents

Merge this configuration into the client's normal remote MCP settings:

```json
{
  "mcpServers": {
    "icons": { "url": "https://icons.2d.digital/mcp" },
    "effects": { "url": "https://effects.2d.digital/mcp" },
    "sounds": { "url": "https://sounds.2d.digital/mcp" }
  }
}
```

## Verify

Verify that the `2ddigital-icons`, `2ddigital-effects`, and `2ddigital-sounds` skills are installed and that all three MCP servers expose tools. If the current client does not reload skills or MCP configuration automatically, tell the user to restart it or begin a new task.

Report success in this form:

```text
2D Digital Agent Setup Complete
✓ Skills  2ddigital-icons, 2ddigital-effects, 2ddigital-sounds
✓ MCPs    icons, effects, sounds
```

The same instructions are published at `https://agents.2d.digital/prompt.md` and can be re-verified there at any time.