
Mailpal
io.github.michaelyousriePublished by GitHub account michaelyousriev0.1.1Updated Oct 24, 2026
List, inspect, and run saved HTTP requests from MailPal collections; write tools on Pro
Overview
Lets an assistant list, inspect, and run saved HTTP requests from MailPal collections, and on Pro create new requests.
- What you can do
- MailPal is an HTTP/API client for VS Code whose bundled MCP server also ships standalone on npm. Through it an assistant can list and inspect saved requests in MailPal collections and run them, with write tools such as creating requests reserved for Pro. It reads collections from a workspace folder and records run history locally.
- When to use it
- Useful when you already keep API requests in MailPal collections and want an assistant to review or execute them during development or debugging, instead of rebuilding calls by hand. Less relevant if you do not use MailPal or keep requests elsewhere.
- Requirements
- Runs as a local stdio process, typically started with npx, so Node.js and network access to npm are needed. It reads collections from the folder given by MAILPAL_WORKSPACE and writes run history to MAILPAL_HISTORY_DIR (default ~/.mailpal/history). Desktop only; no authentication is declared. Pro is needed for write tools.
Installation
In SourceWeft
- Open Mailpal in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
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.
Source: README.md at commit 3623fb2
Tools
0Version history
1- v0.1.1LatestSep 16, 2026
Score
40% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.