@getmocked/mcp

MCP server for GetMocked — create, manage, and test mock APIs from natural language, with built-in data persistence for sticky responses.

Works with Claude Code, Cursor, Windsurf, VS Code Copilot, and any MCP-compatible client.

Quick Start (Claude Code)

npx @getmocked/mcp login

This opens a browser to sign in. After authenticating:

• Credentials are stored locally
• The MCP server is registered globally (works in all projects)
• Tool permissions are pre-approved (no per-tool prompts)

Restart Claude Code and you're ready to go.

Setup for Other Clients

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "getmocked": {
      "command": "npx",
      "args": ["@getmocked/mcp"]
    }
  }
}

VS Code (Copilot)

Add to .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "getmocked": {
        "command": "npx",
        "args": ["@getmocked/mcp"]
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "getmocked": {
      "command": "npx",
      "args": ["@getmocked/mcp"]
    }
  }
}

Manual / Other Clients

Run npx @getmocked/mcp login first to authenticate, then configure your client to run npx @getmocked/mcp as a stdio MCP server.

Available Tools

| Tool | Description | |------|-------------| | create_mock_api | Create a mock API from a natural language description | | list_mock_apis | List all your mock APIs | | get_mock_api | Get details of a specific mock API | | update_mock_api | Update name, description, schemas, or persistence settings using AI | | test_mock_api | Execute a mock API and see sample response (supports persistence control) | | delete_mock_api | Delete a mock API | | list_persisted_data | List stored responses for a persisted mock API | | delete_persisted_data | Delete stored responses or clear all persisted data | | create_mock_project | Create a multi-API project from a description | | list_mock_projects | List all your mock projects | | get_mock_project | Get project details with all APIs | | add_api_to_project | Add a new API to an existing project | | delete_mock_project | Delete a mock project |

CLI Commands

npx @getmocked/mcp login      # Sign in and auto-configure
npx @getmocked/mcp status     # Check authentication status
npx @getmocked/mcp logout     # Clear stored credentials
npx @getmocked/mcp --help     # Show help
npx @getmocked/mcp --version  # Show version

Authentication

You can authenticate in two ways:

1. Interactive login (recommended): npx @getmocked/mcp login
2. API key: Set the GETMOCKED_API_KEY environment variable

Credentials are stored in ~/.getmocked/credentials.json.

License

MIT