Installing the agent skills plugin

This guide walks you through installing the WireMock Cloud 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.

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? See Installing the local agent skills plugin.

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 instead of installing the plugin.

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

Claude Code has native support for agent skills via its plugin system.Add the marketplace registry, then install the plugin:

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 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.

Cursor has native support for agent skills and MCP servers via its plugin system.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 (cursor agent).This installs all eight 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

Codex CLI has a built-in plugin system for installing skills and MCP servers from marketplaces.Add the marketplace registry:

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 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.

GitHub Copilot CLI 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:

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:

copilot plugin install wiremock-inc/skills

Verify the installation:

copilot plugin list

This installs all eight 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.

The GitHub Copilot coding agent 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:

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:

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.

Always review shared skills before using them. See the GitHub Copilot agent skills documentation for details.

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:

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 for more details.You’ll also need to configure the remote MCP server separately - see Installing the WireMock Cloud MCP server.

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 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):

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.

Concepts

Tutorials

How-to Guides

Reference

Installing the agent skills plugin

Prerequisites

Supported agents

​Prerequisites

​Supported agents

Prerequisites

Supported agents