@mockbite/mcp

Model Context Protocol (MCP) server for Mockbite. Let your LLM manage your mock APIs directly from your editor.

Requirements

• Node.js >= 18.0.0
• A Mockbite account with an MCP key (get yours at mockbite.com/dashboard/mcp)

Quick Start (Recommended)

The easiest way to use this server is via npx — no installation required:

{
  "mcpServers": {
    "mockbite": {
      "command": "npx",
      "args": ["-y", "@mockbite/mcp"],
      "env": {
        "MOCKBITE_API_KEY": "mcp_your_key_here"
      }
    }
  }
}

Security note: Always pass your API key via the env block, never as a command-line argument. CLI arguments are visible to all processes on the system via ps aux and /proc/<pid>/cmdline.

IDE Configuration

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "mockbite": {
      "command": "npx",
      "args": ["-y", "@mockbite/mcp"],
      "env": {
        "MOCKBITE_API_KEY": "mcp_your_key_here"
      }
    }
  }
}

Cursor

Edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "mockbite": {
      "command": "npx",
      "args": ["-y", "@mockbite/mcp"],
      "env": {
        "MOCKBITE_API_KEY": "mcp_your_key_here"
      }
    }
  }
}

Devin Desktop

Edit ~/.config/devin/mcp_config.json (macOS/Linux) or %APPDATA%\devin\mcp_config.json (Windows):

{
  "mcpServers": {
    "mockbite": {
      "command": "npx",
      "args": ["-y", "@mockbite/mcp"],
      "env": {
        "MOCKBITE_API_KEY": "mcp_your_key_here"
      }
    }
  }
}

Gemini CLI

Edit ~/.gemini/config/config.json:

{
  "mcp": {
    "servers": {
      "mockbite": {
        "command": "npx",
        "args": ["-y", "@mockbite/mcp"],
        "env": {
          "MOCKBITE_API_KEY": "mcp_your_key_here"
        }
      }
    }
  }
}

Antigravity IDE

Edit ~/.gemini/antigravity-ide/mcp_config.json:

{
  "mcpServers": {
    "mockbite": {
      "command": "npx",
      "args": ["-y", "@mockbite/mcp"],
      "env": {
        "MOCKBITE_API_KEY": "mcp_your_key_here"
      }
    }
  }
}

Antigravity 2.0

Edit ~/.gemini/antigravity-ide/mcp_config.json:

{
  "mcpServers": {
    "mockbite": {
      "command": "npx",
      "args": ["-y", "@mockbite/mcp"],
      "env": {
        "MOCKBITE_API_KEY": "mcp_your_key_here"
      }
    }
  }
}

Self-Hosting

If you run your own Mockbite API, point the MCP server to your local instance:

{
  "env": {
    "MOCKBITE_API_KEY": "mcp_your_key_here",
    "MOCKBITE_API_URL": "http://localhost:8080"
  }
}

Available Tools

| Tool | Description | |------|-------------| | list_mock_apis | List all Mock APIs for the authenticated user | | create_mock_api | Create a new Mock API | | update_mock_api | Update the name and/or slug of an existing Mock API | | delete_mock_api | Permanently delete a Mock API and all its endpoints | | list_endpoints | List all endpoints of a specific Mock API | | create_endpoint | Create a new mock endpoint (supports faker interpolation, chaos/latency) | | update_endpoint | Update an existing mock endpoint | | delete_endpoint | Permanently delete a mock endpoint | | list_tokens | List all authentication tokens for a Mock API | | create_token | Create a new authentication token | | revoke_token | Revoke an authentication token | | get_usage | Get usage statistics for your Mockbite account | | generate_fake_user | Generate a fake user profile for testing |

Security

• API keys are read exclusively from the MOCKBITE_API_KEY environment variable — never from CLI arguments.
• MCP keys are scoped — they can only manage Mockbite resources and cannot authenticate against mock API endpoints in production.
• GUEST accounts cannot use MCP. You must have a registered Mockbite account.

Changelog

1.0.4

• Docs: Split Antigravity configuration into three separate sections: Gemini CLI (mcp.servers format at ~/.gemini/config/config.json), Antigravity IDE (mcpServers format at ~/.gemini/antigravity-ide/mcp_config.json), and Antigravity 2.0. Fixes incorrect config format and file path that were previously documented.

1.0.3

• Docs: Updated configuration documentation, replacing deprecated Windsurf instructions with the new Devin Desktop paths.

1.0.1

• Security: Removed --key CLI argument. API keys must now be passed exclusively via the MOCKBITE_API_KEY environment variable to prevent exposure in process listings (ps aux).

License

MIT