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

VerifiedSTDIODesktop onlyFiles & StorageDeveloper Tools

Overview

AI-generated 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.
Before you install
Running saved requests sends real HTTP traffic to whatever endpoints those requests target, which may change or delete remote data. Requests may carry credentials or secrets; per-collection secret values are described as stored in the OS keychain rather than in files. Run history is written to MAILPAL_HISTORY_DIR on disk, so review what that directory retains.

Installation

In SourceWeft

  1. Open Mailpal in the dashboard and add it to a workspace.
  2. 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 icon]

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

[MailPal request panel]

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:

bash
claude mcp add mailpal -- npx -y 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

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  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.