tree: 521a415dfe9d381ee9e593f19550623e950fcc75
  1. index.js
  2. LICENSE
  3. package.json
  4. README.md
mcp/ponymail-mcp/README.md

PonyMail MCP Server

An MCP (Model Context Protocol) server that provides access to the Apache PonyMail mailing list archive API. Public lists only.

Tools

ToolDescription
list_listsGet an overview of all available mailing lists and message counts
search_listSearch/browse a mailing list with filters (date, sender, subject, body, query)
get_emailFetch a specific email by ID with full body and attachments
get_threadFetch the root message of a thread by thread ID
get_mboxDownload mbox-formatted archive data for bulk export

Setup

cd ponymail-mcp
npm install

Configure in Your MCP Client

Add a local (stdio) MCP server with:

  • Command: node
  • Args: /path/to/ponymail-mcp/index.js

Refer to your MCP client's documentation for how to add a local stdio server.

Environment Variables

VariableDefaultDescription
PONYMAIL_BASE_URLhttps://lists.apache.orgBase URL of the PonyMail instance

Usage Examples

Once connected, you can ask things like:

  • “Search the dev@iceberg.apache.org list for messages about partition spec in the last 30 days”
  • “Show me the available mailing lists”
  • “Fetch email with ID xyz...”
  • “Get the mbox archive for dev@httpd.apache.org for 2024-03”