Meta AI enhances machine learning, NLP, and computer vision capabilities.
MCP server
0Popularity
About MCP server
The US Global Mail MCP server is a stateless HTTP wrapper around the US Global Mail API gateway that allows AI coding agents such as Claude Code, Cursor, VS Code, Windsurf, or Cline to manage a mailbox on behalf of a user. It enables reading and organizing scanned mail, managing folders, requesting scans, handling shipping and deposit addresses, bank accounts, shipment requests, and viewing account profiles or virtual mailing addresses. Every tool call is forwarded to the gateway using the user’s API key, so authentication, rate limits, and auditing remain consistent with direct REST calls. The server exposes a set of tools for listing, fetching, creating, updating, and deleting mail items, folders, scans, addresses, bank accounts, and shipments. It supports pagination for list operations and provides signed download URLs for completed scans. Destructive actions are flagged to prompt confirmation before execution. The server is designed to be lightweight and does not maintain session state, allowing any instance to serve requests.
Key features
- Read and organize scanned mail
- Manage folders (create, rename, delete)
- Request and retrieve scans of mail items
- Handle shipping and deposit addresses
- Manage bank accounts for check deposits
- View shipment requests and account profile
- Pagination for list operations
- Signed download URLs for completed scans
Use cases
- Automating mail management tasks via AI coding agents
- Integrating mailbox operations into automated workflows
- Processing and organizing scanned mail for business or personal use
Pros
- Stateless HTTP wrapper with API-key passthrough
- Supports multiple AI coding agents (Claude Code, Cursor, VS Code, Windsurf, Cline)
- Exposes tools for mail, folder, scan, address, bank account, and shipment management
- Pagination support for list operations
- Signed download URLs for completed scans
Cons
- Requires an API key for authentication
- No OAuth 2.1 support yet (browser consent not available)
- Dedicated key per agent recommended for security
- Limited to US Global Mail API functionality
Frequently asked questions about MCP server
What is the US Global Mail MCP server?
The US Global Mail MCP server is a stateless HTTP wrapper around the US Global Mail API gateway that allows AI coding agents to manage a user's mailbox. It enables reading, organizing, and requesting scans of mail, managing folders, addresses, bank accounts, and shipment requests.
Which AI coding agents can use the MCP server?
The MCP server supports AI coding agents such as Claude Code, Cursor, VS Code, Windsurf, and Cline. It provides a standardized interface for these agents to interact with the US Global Mail API.
How do I authenticate with the MCP server?
Authentication is done by sending your US Global Mail API key as a bearer token in the Authorization header. The same key used for direct REST calls works here, and it is recommended to use a dedicated key per agent for security.
Does the MCP server maintain session state?
No, the MCP server is stateless and does not maintain session state. Any instance can serve requests, and there is no session affinity required.
What types of operations can I perform with the MCP server?
The MCP server exposes tools for listing, fetching, creating, updating, and deleting mail items, folders, scans, addresses, bank accounts, and shipments. It also supports pagination for list operations and provides signed download URLs for completed scans.
Are destructive actions flagged in the MCP server?
Yes, destructive actions such as discarding mail, deleting folders, addresses, or bank accounts are flagged with a destructiveHint annotation. This prompts agents to confirm before executing these actions.
