mailpal-mcp

mailpal-mcp

MCP server for MailPal, the honest API client for VS Code. It gives AI agents structured access to your saved HTTP requests: list collections, inspect requests, run them, and read results, with write tools (create collections, upsert requests, scaffold tests) available on MailPal Pro.

If you use the MailPal VS Code extension, you do not need this package: the extension registers the same server with VS Code agent mode automatically. This package is for every other MCP client.

Setup

Claude Code:

claude mcp add mailpal -- npx -y mailpal-mcp

Generic MCP JSON config (Cursor, Claude Desktop, and friends):

{
  "mcpServers": {
    "mailpal": {
      "command": "npx",
      "args": ["-y", "mailpal-mcp"],
      "env": { "MAILPAL_WORKSPACE": "/path/to/your/project" }
    }
  }
}

Configuration

Variable	Meaning	Default
MAILPAL_WORKSPACE	Folder containing the .mailpal/ collections directory	current directory
MAILPAL_HISTORY_DIR	Where run history is written	~/.mailpal/history
MAILPAL_LICENSE_FILE	License mirror written by the VS Code extension	unset (free tools only)
MAILPAL_SECRET_<NAME>	Value for the secret variable NAME	unset

Secret values are resolved when a request runs and are never returned by any tool.

Tools

Free: list_collections, get_request, run_request, get_history_recent, list_variables

Pro: create_collection, create_or_update_request, set_collection_variable, generate_tests, scaffold_test_suite

Links

• VS Code extension: https://marketplace.visualstudio.com/items?itemName=MichaelYousrie.mailpal
• Issues: https://github.com/michaelyousrie/mailpal/issues