Apighost

APIGhost

[](https://github.com/Coding-Dev-Tools/apighost/stargazers)

OpenAPI spec → mock server with VCR recording

> ⭐ Star this repo if you build or test APIs — it helps others discover APIGhost!

[](https://github.com/Coding-Dev-Tools/apighost) [](https://github.com/Coding-Dev-Tools/apighost/blob/main/LICENSE) [](https://github.com/Coding-Dev-Tools/apighost/actions/workflows/ci.yml) [](https://www.opensourcealternative.to/project/apighost)

Why APIGhost?

Every frontend and integration test needs a mock API. Most teams either hardcode responses (brittle), run a shared staging server (slow, flaky), or hand-write mock configurations (time-consuming). APIGhost reads your OpenAPI spec and generates a working mock server in seconds — with realistic fake data, scenario switching for edge cases, and VCR recording for deterministic test replay. When your API spec changes, your mock server updates automatically.

Installation

pip (Python):

pip install git+https://github.com/Coding-Dev-Tools/apighost.git

Or via the self-hosted PyPI index:

pip install --index-url https://coding-dev-tools.github.io/pypi-index/simple/ apighost

Homebrew:

brew tap Coding-Dev-Tools/homebrew-tap
brew install apighost

Quick Start

# Start a mock server from an OpenAPI spec
apighost serve petstore.yaml

# Or run directly from a URL
apighost serve https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v3.0/petstore.yaml

Commands

apighost serve

Start a mock server from an OpenAPI spec file.

apighost serve spec.yaml                    # Default port 8080
apighost serve api.json -p 3000             # Custom port
apighost serve spec.yaml --scenario error    # Use error scenario
apighost serve spec.yaml --record            # Record interactions to cassette

apighost record

Start a server, make sample requests, and record them to a cassette.

apighost record petstore.yaml
apighost record spec.yaml --output my-test-cassette

apighost replay

Replay a recorded cassette as a deterministic mock server.

apighost replay my-recording
apighost replay /path/to/cassette.json -p 3000

apighost scenario

Manage response scenarios — named sets of overrides.

apighost scenario create error-test -d "API error scenarios"
apighost scenario edit error-test "GET /users" --status 500 --body '{"error":"oops"}'
apighost scenario list
apighost scenario delete error-test

apighost generate

Generate realistic sample data from an OpenAPI spec into a scenario.

apighost generate petstore.yaml

apighost info

Show APIGhost configuration and storage info.

Features

• OpenAPI 3.0/3.1 parsing — full path, parameter, and response parsing
• Realistic fake data — Faker-powered with property name hints (emails, names, IDs)
• VCR recording — capture real interactions for deterministic replay
• Scenario system — named response presets for testing edge cases
• Path parameter support — dynamic URL path resolution
• Status code selection — picks appropriate response codes per scenario

CI/CD Integration

# GitHub Actions — start mock API for integration tests
- name: Start mock API
  run: |
    apighost serve api-spec.yaml -p 8080 &
    sleep 2

- name: Run integration tests against mock
  run: pytest tests/integration/

# Deterministic replay — no flaky tests
apighost record petstore.yaml                    # Record once
apighost replay my-recording -p 8080            # Replay forever, same responses

Alternatives Comparison

| Feature | APIGhost | Prism | WireMock | Mockoon | |---------|----------|-------|----------|---------| | OpenAPI → mock server | ✅ | ✅ | ❌ | ✅ | | VCR record/replay | ✅ | ❌ | ✅ | ❌ | | Scenario switching | ✅ | ❌ | ✅ | ✅ | | Realistic fake data | ✅ | ✅ | ❌ | ❌ | | Zero-config from spec | ✅ | ✅ | ❌ | ✅ | | CLI-first (no GUI) | ✅ | ✅ | ✅ | ❌ | | Spec change auto-sync | ✅ | ✅ | ❌ | ❌ |

APIGhost vs Prism: Prism generates mock responses but can't record/replay or switch scenarios. APIGhost adds VCR cassettes and scenario presets.

APIGhost vs WireMock: WireMock requires hand-coded stubs. APIGhost generates everything from your OpenAPI spec — zero config.

APIGhost vs Mockoon: Mockoon needs a GUI. APIGhost is CLI-first — perfect for CI and headless environments.

Pricing

| Tier | Price | Features | |------|-------|----------| | Free | $0 | Unlimited local use, 100 requests/session | | Pro | $12/mo ($119/yr) | Unlimited requests, VCR cassettes, CI/CD integration | | Suite | $49/mo ($39 billed annually) | All tools in the Coding-Dev-Tools ecosystem under one license |

Storage

Cassettes and scenarios are stored in ~/.apighost/:

• ~/.apighost/cassettes/ — recorded interaction cassettes (JSON)
• ~/.apighost/scenarios/ — response scenario definitions (JSON)

Roadmap

• [ ] OpenAPI 3.1 full support (JSON Schema draft 2020-12)
• [ ] Webhook simulation
• [ ] Latency simulation with per-endpoint config
• [ ] Dashboard UI for real-time request inspection
• [ ] MCP server integration for AI-assisted testing
• [ ] Docker image

Development

git clone https://github.com/Coding-Dev-Tools/apighost.git
cd apighost
pip install -e ".[dev]"
pytest

License

MIT — see [LICENSE](LICENSE)

---

Part of DevForge — a suite of 10 developer CLI tools built by autonomous AI agents. Also check out API Contract Guardian (breaking change detection), DeployDiff (infrastructure diffs), json2sql (JSON → SQL), ConfigDrift (config drift detection), DeadCode (dead code cleanup), APIAuth (API key management), Envault (env sync), SchemaForge (ORM converter), and click-to-mcp (CLI → MCP server).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Coding-Dev-Tools
• Source: Coding-Dev-Tools/apighost
• License: MIT
• Homepage: https://coding-dev-tools.github.io/devforge/

Install and usage instructions live in the source repository linked above.