> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wiremock.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installing the agent skills plugin

> Install the WireMock Cloud agent skills plugin for your coding agent

This guide walks you through installing the WireMock Cloud [agent skills](/ai-mcp/agent-skills) plugin - the recommended way to give your coding agent the ability to build, validate, and manage mock APIs in WireMock Cloud.

The plugin bundles both the skills and a connection to WireMock Cloud's remote, hosted MCP server (`https://mcp.wiremock.cloud/mcp`). For tools with native plugin support, installing the plugin is enough - the MCP connection comes configured automatically, and you authenticate via an OAuth sign-in in your browser the first time your agent uses it. No separate MCP setup step is needed.

<Note>
  Need the local, CLI-based MCP server instead - for example because your network can't reach `mcp.wiremock.cloud`, or you need [locally stored HTTP request credentials](/ai-mcp/http-request-authentication)? See [Installing the local agent skills plugin](/ai-mcp/local-installation).
</Note>

<Note>
  Running in a headless or CI environment that can't complete an interactive OAuth sign-in? Configure the remote MCP server directly with an [API token](/ai-mcp/mcp-installation#authenticating-with-an-api-token) instead of installing the plugin.
</Note>

## Prerequisites

Just an existing WireMock Cloud account - if you don't have one, the OAuth sign-in described below will guide you through creating one.

## Supported agents

<Tabs>
  <Tab title="Claude Code">
    Claude Code has native support for agent skills via its [plugin system](https://code.claude.com/docs/en/skills).

    Add the marketplace registry, then install the plugin:

    ```bash theme={null}
    claude plugin marketplace add wiremock-inc/skills
    claude plugin install wiremock-cloud@wiremock-inc-skills
    ```

    Or within an interactive Claude Code session:

    ```
    /plugin marketplace add wiremock-inc/skills
    /plugin install wiremock-cloud@wiremock-inc-skills
    ```

    This installs all eight [skills](/ai-mcp/agent-skills#available-skills) and configures the remote MCP server. You can verify by asking Claude Code:

    ```
    What skills are available?
    ```

    You should see the WireMock Cloud skills listed. You can invoke the main skill directly:

    ```
    /build-api-simulation
    ```

    The first time a skill calls a WireMock Cloud MCP tool, Claude Code will prompt you to complete an OAuth sign-in in your browser.
  </Tab>

  <Tab title="Cursor">
    Cursor has native support for agent skills and MCP servers via its [plugin system](https://cursor.com/docs/context/plugins).

    Add the marketplace registry, then install the plugin:

    ```
    /plugin marketplace add wiremock-inc/skills
    /plugin install wiremock-cloud@wiremock-inc-skills
    ```

    Run `/reload-plugins` afterwards. This works the same way from the Cursor editor or the [Cursor CLI](https://cursor.com/docs/cli/overview) (`cursor agent`).

    This installs all eight [skills](/ai-mcp/agent-skills#available-skills) and configures the remote MCP server. Cursor will show a "needs authentication" indicator the first time a skill calls a WireMock Cloud MCP tool - click **Connect** to complete an OAuth sign-in in your browser.

    You can then invoke the main skill directly:

    ```
    /build-api-simulation
    ```
  </Tab>

  <Tab title="Codex CLI">
    [Codex CLI](https://developers.openai.com/codex) has a built-in plugin system for installing skills and MCP servers from marketplaces.

    Add the marketplace registry:

    ```bash theme={null}
    codex plugin marketplace add wiremock-inc/skills
    ```

    Then install `wiremock-cloud` from the `/plugins` picker, or your Codex CLI version's equivalent install command.

    This installs all eight [skills](/ai-mcp/agent-skills#available-skills) and configures the remote MCP server. The first time a skill calls a WireMock Cloud MCP tool, Codex will prompt you to complete an OAuth sign-in in your browser.
  </Tab>

  <Tab title="GitHub Copilot CLI">
    [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing) has a built-in plugin system for installing skills from marketplaces and Git repositories.

    Add the marketplace registry containing the WireMock skills, then install the plugin:

    ```bash theme={null}
    copilot plugin marketplace add wiremock-inc/skills
    copilot plugin install wiremock-cloud@wiremock-inc-skills
    ```

    Or within an interactive session:

    ```
    /plugin marketplace add wiremock-inc/skills
    /plugin install wiremock-cloud@wiremock-inc-skills
    ```

    You can also install directly from the GitHub repository without adding a marketplace first:

    ```bash theme={null}
    copilot plugin install wiremock-inc/skills
    ```

    Verify the installation:

    ```bash theme={null}
    copilot plugin list
    ```

    This installs all eight [skills](/ai-mcp/agent-skills#available-skills) and configures the remote MCP server. You can then invoke the main skill directly:

    ```
    /build-api-simulation
    ```

    The first time a skill calls a WireMock Cloud MCP tool, Copilot CLI will prompt you to complete an OAuth sign-in in your browser.
  </Tab>

  <Tab title="GitHub Copilot">
    The [GitHub Copilot coding agent](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) and VS Code agent mode discover skills from `.github/skills/` or `.claude/skills/` directories in your repository - they don't yet support the marketplace plugin system above, so skills and the MCP server are set up as two separate steps.

    Clone the skills into your project's `.github/skills/` directory:

    ```bash theme={null}
    git clone https://github.com/wiremock-inc/skills.git /tmp/wiremock-skills
    cp -r /tmp/wiremock-skills/copilot/skills/* .github/skills/
    rm -rf /tmp/wiremock-skills
    ```

    Alternatively, add them as a Git submodule for easier updates:

    ```bash theme={null}
    git submodule add https://github.com/wiremock-inc/skills.git .github/wiremock-skills
    ```

    The skills will be discovered automatically by the Copilot coding agent and in VS Code agent mode.

    You'll also need to configure the remote MCP server separately - see [Installing the WireMock Cloud MCP server](/ai-mcp/mcp-installation#option-1-remote-server-recommended).

    <Note>
      Always review shared skills before using them. See the [GitHub Copilot agent skills documentation](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) for details.
    </Note>
  </Tab>

  <Tab title="VS Code + Copilot">
    VS Code discovers agent skills from `.github/skills/` or `.claude/skills/` directories in your workspace - it doesn't yet support the marketplace plugin system above, so skills and the MCP server are set up as two separate steps.

    Copy the skills into your project:

    ```bash theme={null}
    git clone https://github.com/wiremock-inc/skills.git /tmp/wiremock-skills
    cp -r /tmp/wiremock-skills/copilot/skills/* .github/skills/
    rm -rf /tmp/wiremock-skills
    ```

    After reloading VS Code, the skills will be available in Copilot chat agent mode. See the [VS Code agent skills documentation](https://code.visualstudio.com/docs/copilot/customization/agent-skills) for more details.

    You'll also need to configure the remote MCP server separately - see [Installing the WireMock Cloud MCP server](/ai-mcp/mcp-installation#option-1-remote-server-recommended).
  </Tab>

  <Tab title="Other agents">
    The Agent Skills format is supported by many other coding agents including Gemini CLI, JetBrains Junie, Windsurf, Goose, Roo Code, and more. See [agentskills.io](https://agentskills.io/home) for the full list. None of these support the marketplace plugin system above yet, so skills and the MCP server are set up as two separate steps.

    For any compatible agent, clone the skills repository and copy the `copilot/skills/` directory contents into the location your agent expects (any of the `copilot/`, `cursor/`, or `codex/` skill directories are equivalent open-standard content):

    ```bash theme={null}
    git clone https://github.com/wiremock-inc/skills.git /tmp/wiremock-skills
    cp -r /tmp/wiremock-skills/copilot/skills/* <your-agent-skills-directory>/
    rm -rf /tmp/wiremock-skills
    ```

    Common skill directory locations:

    | Agent | Directory |
    | - | - |
    | Gemini CLI | `.gemini/skills/` |
    | JetBrains Junie | `.junie/skills/` |
    | Goose | `.goose/skills/` |
    | Roo Code | `.roo/skills/` |

    Consult your agent's documentation for the exact path and any additional configuration.

    You'll also need to configure the remote MCP server separately - see [Installing the WireMock Cloud MCP server](/ai-mcp/mcp-installation#option-1-remote-server-recommended).
  </Tab>
</Tabs>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.