Mailpal README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Mailpal listing page.
MailPal
The honest API client for VS Code.
Collections, variables, unlimited history, an MCP server for AI agents, and a free tier that stays free.
Install from the VS Code Marketplace
Why MailPal exists
The most popular REST client for VS Code has 7.4 million installs and a 2.5 star rating, because its free tier slowly moved everything, including your own request history, behind a paywall.
MailPal makes the opposite promise, and treats it like a contract:
- The free tier is fully usable for a single user, forever.
- Unlimited requests, unlimited collections, unlimited local history.
- Pro adds new value only. It never gates access to your own data.
- If a license lapses, Pro features stop. Everything else keeps working.
Highlights
- Full request builder with a Postman-style editor: auto-growing key/value rows, header autocomplete, color-coded JSON editing with format and validation
- Auto headers surfaced, so you see and control everything sent on the wire
- Syntax-highlighted responses (JSON and XML), HTML raw/preview toggle, resizable request/response split
- Per-collection variables with
{{VAR}}placeholders; secret values live in your OS keychain, never in files - Unlimited local history with one-click re-send
- Import Postman v2.1, Thunder Client, OpenAPI 3.x, and curl; export Postman and curl
- Assertions per request with pass/fail on every send
- A bundled MCP server, registered with VS Code agent mode automatically, so AI agents can list, run, and (with Pro) create requests
For AI agents (MCP)
The MCP server also ships standalone on npm as mailpal-mcp:
Works with any MCP client (Cursor, Claude Desktop, and friends) via npx -y mailpal-mcp.
Support
Questions, bugs, and feature requests: open an issue.
This repository hosts the project's public home, issues, and media. The extension itself ships through the VS Code Marketplace.