> ## 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 local agent skills plugin

> Install the WireMock Cloud agent skills plugin using the local, CLI-based MCP server

The WireMock Cloud [agent skills](/ai-mcp/agent-skills) plugin is also available in a local-server variant, `wiremock-cloud-local`. It ships the same eight skills as the [recommended remote plugin](/ai-mcp/installation), but talks to a local, stdio MCP server launched by the WireMock CLI (`wiremock mcp`) instead of the hosted `mcp.wiremock.cloud` server.

Choose the local variant if:

* your network can't reach `mcp.wiremock.cloud` directly
* you need [HTTP request authentication](/ai-mcp/http-request-authentication) with credentials stored locally
* you have an existing local WireMock CLI setup you want the skills to use

Install whichever variant matches your setup - not both, since they'd both register an MCP server named `wiremock`.

## Prerequisites

The local plugin's bundled MCP configuration runs `wiremock mcp`, so you need the WireMock CLI installed and authenticated first:

```bash theme={null}
npm i -g @wiremock/cli
wiremock login
```

## Supported agents

<Tabs>
  <Tab title="Claude Code">
    Add the marketplace registry, then install the local plugin:

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

    Or within an interactive Claude Code session:

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

    This installs all eight [skills](/ai-mcp/agent-skills#available-skills) and configures the local MCP server to run `wiremock mcp`.
  </Tab>

  <Tab title="Cursor">
    Add the marketplace registry, then install the local plugin:

    ```
    /plugin marketplace add wiremock-inc/skills
    /plugin install wiremock-cloud-local@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`).
  </Tab>

  <Tab title="Codex CLI">
    Add the marketplace registry:

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

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

  <Tab title="GitHub Copilot CLI">
    Add the marketplace registry containing the WireMock skills, then install the local plugin:

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

    Or within an interactive session:

    ```
    /plugin marketplace add wiremock-inc/skills
    /plugin install wiremock-cloud-local@wiremock-inc-skills
    ```
  </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 support the marketplace plugin system above, so skills and the MCP server are set up as two separate steps.

    Clone the local-variant 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-local/skills/* .github/skills/
    rm -rf /tmp/wiremock-skills
    ```

    Then configure the local MCP server separately - see [Installing the WireMock Cloud MCP server](/ai-mcp/mcp-installation#option-2-local-server).
  </Tab>

  <Tab title="VS Code + Copilot">
    Copy the local-variant 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-local/skills/* .github/skills/
    rm -rf /tmp/wiremock-skills
    ```

    After reloading VS Code, the skills will be available in Copilot chat agent mode. Then configure the local MCP server separately - see [Installing the WireMock Cloud MCP server](/ai-mcp/mcp-installation#option-2-local-server).
  </Tab>

  <Tab title="Other agents">
    For any agent that supports the Agent Skills format but not the marketplace plugin system above, clone the skills repository and copy the `copilot-local/skills/` directory contents into the location your agent expects (any of the `copilot-local/`, `cursor-local/`, or `codex-local/` 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-local/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. Then configure the local MCP server separately - see [Installing the WireMock Cloud MCP server](/ai-mcp/mcp-installation#option-2-local-server).
  </Tab>
</Tabs>