Skip to content

Home

MockLoop Logo

A Model Context Protocol server for generating and managing mock API servers with AI-powered testing capabilities.

Get Started →

What is MockLoop MCP?

The world's first AI-native API testing platform powered by the Model Context Protocol. Revolutionary AI-driven scenario generation, automated test execution, and intelligent analysis capabilities. MockLoop MCP is a Model Context Protocol server that generates mock API servers from OpenAPI specifications and provides AI-powered testing tools. It includes 50 MCP capabilities for automated testing, scenario management, and audit logging.

Core Components

MCP Tools (16)

  • Mock server generation and management
  • Test scenario validation and deployment
  • Test execution and monitoring
  • Result analysis and reporting

MCP Prompts (5)

  • OpenAPI analysis for testing strategies
  • Test scenario configuration generation
  • Load testing optimization
  • Error scenario generation
  • Security test generation

MCP Resources (15)

  • Pre-built scenario packs for common testing patterns
  • Error simulation scenarios
  • Load testing configurations
  • Security testing suites

MCP Context Management (10)

  • Test session state management
  • Workflow orchestration
  • Cross-session data sharing
  • State snapshots and rollback

Audit Logging (4)

  • Request/response logging
  • Compliance tracking
  • Performance metrics
  • Security event monitoring

Key Features

  • Mock Server Generation: Creates mock servers from OpenAPI v2/v3 specifications
  • MCP Proxy Functionality: Seamless switching between mock, proxy, and hybrid modes
  • Dual-Port Architecture: Separate ports for business API (8000) and admin UI (8001)
  • Request Logging: SQLite-based logging with query capabilities
  • Docker Support: Containerized deployment with Docker Compose
  • AI Integration: Compatible with LangGraph, CrewAI, and LangChain

Quick Start

  1. Install 

    pip install mockloop-mcp

  2. Run MCP Server 

    mockloop-mcp

  3. Generate Mock Server Use the generate_mock_api tool with your OpenAPI specification

  4. Access Mock Server Mocked API: http://localhost:8000 Admin UI: http://localhost:8001

Add to Claude Code

Simply run claude mcp add -t stdio mockloop-mcp mockloop-mcp

Or if using virtual environment:

claude mcp add -t stdio mockloop-mcp /path/to/venv/bin/mockloop_mcp

MCP Proxy Functionality

MockLoop MCP includes powerful proxy capabilities that enable seamless switching between mock and live API environments:

Proxy Modes

  • Mock Mode: All requests handled by generated mock responses
  • Proxy Mode: All requests forwarded to live API endpoints
  • Hybrid Mode: Intelligent routing between mock and proxy based on rules

Key Capabilities

  • Universal Authentication: API Key, Bearer Token, Basic Auth, OAuth2 support
  • Dynamic Routing: Configure rules to route requests based on patterns and conditions
  • Response Comparison: Automated comparison between mock and live responses
  • Zero-Downtime Switching: Change modes without service interruption

Quick Example

# Create a proxy-enabled plugin
plugin_result = await create_mcp_plugin(
    spec_url_or_path="https://api.example.com/openapi.json",
    mode="hybrid",
    target_url="https://api.example.com",
    auth_config={"auth_type": "bearer_token", "credentials": {"token": "your-token"}}
)

📚 Complete MCP Proxy Guide - Detailed configuration, examples, and best practices

Documentation

Architecture

Dual-Port Design

  • Mocked API Port (8000): Serves mock API endpoints
  • Admin Port (8001): Management interface and logging
  • No Path Conflicts: Eliminates /admin endpoint conflicts

Database Schema

  • Request Logs: Complete request/response audit trail
  • Test Sessions: Stateful test execution tracking
  • Compliance Events: Regulatory compliance monitoring
  • Performance Metrics: Response time and throughput data

Community and Support

Continue to the Installation Guide to set up MockLoop MCP.