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