# Virtual Mail

> Virtual Mail lets customers manage their physical mail online. Integrate through the MCP server (for AI assistants) or the Public API (REST over HTTPS + JSON).

Every page of this site is available as Markdown under https://reference.earthclassmail.com/_llms_txt/, at the same path as the web page: https://reference.earthclassmail.com/v1/rest-api/quickstart/ is https://reference.earthclassmail.com/_llms_txt/v1/rest-api/quickstart.md. Links inside those files point to the other Markdown files.

## Overview

- [Overview](https://reference.earthclassmail.com/_llms_txt/index.md): Virtual Mail - API Documentation — programmatic access to your virtual mail via the MCP server and the Public API.

## Public MCP Documentation

- [Overview](https://reference.earthclassmail.com/_llms_txt/v2/mcp.md): Connect your AI assistant to Virtual Mail via MCP — authentication, capabilities, and limitations.
- [Tools Reference](https://reference.earthclassmail.com/_llms_txt/v2/mcp/tools.md): Every tool exposed by the MCP server.

## Public MCP Documentation › Connect

- [ChatGPT](https://reference.earthclassmail.com/_llms_txt/v2/mcp/chatgpt.md): Install the Virtual Mail app in ChatGPT from the ChatGPT app directory.
- [Claude](https://reference.earthclassmail.com/_llms_txt/v2/mcp/claude.md): Install the Virtual Mail connector in Claude from the Claude connectors directory.
- [Other MCP clients](https://reference.earthclassmail.com/_llms_txt/v2/mcp/connect.md): Connect your AI client to the Virtual Mail MCP server — setup snippets for Claude Code, Codex, Cursor, and VS Code.

## Public API Documentation

- [Overview](https://reference.earthclassmail.com/_llms_txt/v1/rest-api.md): Authentication, rate limits, paging, and key concepts for the Virtual Mail Public API.
- [Quickstart](https://reference.earthclassmail.com/_llms_txt/v1/rest-api/quickstart.md): Make your first Virtual Mail Public API requests — fetch your user, your inboxes, and recent mail.
- [Playbooks](https://reference.earthclassmail.com/_llms_txt/v1/rest-api/playbooks.md): Step-by-step workflows for common Virtual Mail Public API use cases.
- [Specification](https://reference.earthclassmail.com/_llms_txt/v1/rest-api/spec.md): Base URL, authentication and every endpoint, grouped by tag.

## Optional

- [Complete documentation](https://reference.earthclassmail.com/_llms_txt/llms-full.txt): every page, endpoints included, in one file
- [Public API OpenAPI specification](https://reference.earthclassmail.com/rest-api-v1.yaml): the spec the endpoint pages are built from
- [MCP tool catalog](https://api.earthclassmail.com/v2/mcp_catalog.json): machine-readable tool definitions and input schemas