microcks-local-server

microcks-local-server is a skill for Claude Code, Codex from emmanuelperu/microcks-skills. It costs 54 tokens per session (954 once invoked), scanned A, original, Apache-2.0.

A setup guide for running Microcks, an open-source tool that creates mock APIs for development and testing, on your computer.

In plain words
What is it for?
Creating a local Docker-based Microcks server from an OpenAPI description, checking that it is ready, and opening its web console.
Why use it?
It lets developers test against a simulated REST API before the real service is available.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Creating a local Docker-based Microcks server from an OpenAPI description, checking that it is ready, and opening its web console.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/emmanuelperu/microcks-skills/microcks-local-server
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add emmanuelperu/microcks-skills --skill microcks-local-server
Clone the repo
git clone --depth 1 https://github.com/emmanuelperu/microcks-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for microcks-local-server

README.md
[![agentmods](https://agentmods.dev/badge/skills/emmanuelperu/microcks-skills/microcks-local-server/github.svg)](https://agentmods.dev/skills/emmanuelperu/microcks-skills/microcks-local-server)
Your own site
<a href="https://agentmods.dev/skills/emmanuelperu/microcks-skills/microcks-local-server"><img src="https://agentmods.dev/badge/skills/emmanuelperu/microcks-skills/microcks-local-server/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for microcks-local-server

Your own site · 80×15
<a href="https://agentmods.dev/skills/emmanuelperu/microcks-skills/microcks-local-server"><img src="https://agentmods.dev/badge/skills/emmanuelperu/microcks-skills/microcks-local-server.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 54 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 954 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00054 $0.00954
Opus 5 $0.00027 $0.00477
Sonnet 5 $0.00011 $0.00191
Haiku 4.5 $0.00005 $0.00095

Measured 9d ago against content hash c719f2c0c5a1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

microcks-local-server scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

until curl -s -o /dev/null http://localhost:8080/api; do
skills/microcks-local-server/SKILL.md · 122 lines

How it starts

The opening of the file, as written. The whole thing — 122 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Microcks Local Server

Set up and run a local Microcks server using Docker Compose for API mocking and testing.

When to Use

  • A developer wants to mock a REST API locally from an OpenAPI specification
  • A project needs a local API mock server for development or integration testing
  • Someone asks to "start Microcks", "run a mock server", or "set up API mocking"

Prerequisites

  • Docker and Docker Compose installed and running

Start the Server

  1. Create a mocking/ directory at the project root (if it doesn't exist):
mkdir -p mocking
  1. Copy the Docker Compose template from templates/docker-compose.yml into it:
cp templates/docker-compose.yml mocking/docker-compose.yml
  1. Start the containers:
# From the project root
docker compose -f mocking/docker-compose.yml up -d

# Or from the mocking/ directory
cd mocking && docker compose up -d
  1. Wait for Microcks to be ready:
until curl -s -o /dev/null http://localhost:8080/api; do
  echo "Waiting for Microcks to be up..."
  sleep 3
done
echo "Microcks is ready!"

Verify the Server

  • Health check: curl -s http://localhost:8080/api
  • Web console: open http://localhost:8080 in a browser
  • List services: curl -s http://localhost:8080/api/services

Stop the Server

When confirming the server is running, ALWAYS remind the user they can stop it by asking "stop the Microcks server" or by running docker compose -f mocking/docker-compose.yml down.

# From the project root
docker compose -f mocking/docker-compose.yml down

# Or from the mocking/ directory
cd mocking && docker compose down

Configuration Details

Setting Value Notes
Microcks image quay.io/microcks/microcks:1.13.2 Pinned stable version
MongoDB image mongo:7.0 LTS version
Microcks port 8080 REST API and web console
MongoDB port 27017 Exposed for debugging, not required
Authentication Disabled KEYCLOAK_ENABLED=false, no login needed
Storage Ephemeral Data is lost when containers stop

Read the full file on GitHub · 122 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 122 lines · 54 tokens per session scan A c719f2c0c5a1

Subscribe to this mod's changes

microcks-local-server is a skill published in the GitHub repository emmanuelperu/microcks-skills (4 stars, last pushed 5mo ago), licensed Apache-2.0. It adds 54 tokens to every session and 954 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.