# US Global Mail MCP Server A stateless Streamable HTTP MCP server that lets compatible AI coding agents manage a US Global Mail mailbox through the USGM API. It supports mailbox organization, scan requests, address and bank-account management, shipment viewing, and account lookup using an API key. - Findings24: - ウェブサイト: - 料金: Freemium - カテゴリー: MCPツール ## US Global Mail MCP Serverとは？ The US Global Mail MCP Server is a remote, stateless Streamable HTTP MCP server for managing a US Global Mail mailbox through compatible AI coding agents. It provides an MCP interface over the USGM API gateway, allowing agents to work with mail, scans, folders, addresses, bank accounts, shipments, and account information. The server uses the same bearer API key as direct USGM REST calls. MCP clients connect to `https://mcp.usglobalmail.com/mcp`, while the gateway continues to enforce authentication, rate limits, and audit behavior. Production and sandbox keys are supported, allowing development against a sandbox before using live mailbox data. The available tools cover both read and account-management workflows. List tools use cursor pagination, and destructive actions are explicitly annotated. API keys should be handled as passwords and dedicated keys are recommended for individual agents. ## US Global Mail MCP Serverでできること ### Mailbox and folder management List and fetch mail items with folder, search, status, and scan-status filters; mark items read or unread; move them between folders; archive or restore them; and create, update, or delete folders. ### Scan request workflows List and inspect scan or open-and-scan requests, request a scan for a mail item, cancel pending requests, delete scan requests, and obtain a short-lived signed download URL for a completed scan. Scan requests are billable. ### Address and bank-account tools List, retrieve, create, update, set defaults for, and delete shipping or deposit addresses. Agents can also manage bank accounts used for check deposits; retrieved account numbers show only the last four digits. ### Shipment and account lookup View shipment requests in read-only mode and retrieve the account profile, virtual mailing address, mailbox addresses, or default address by category. ### MCP client and environment support Connect through a common remote HTTP configuration in Claude Code, Cursor, VS Code, Windsurf, Cline, and other MCP clients, using either production live keys or sandbox test keys. ### Cursor pagination and action annotations List responses include \`data\`, \`next\_cursor\`, and \`total\_count\`, allowing agents to request additional pages. Read-only and destructive tools carry annotations that help distinguish safe lookups from actions requiring confirmation. ## 利用シーン ### Mailbox triage by an AI coding agent Connect an MCP client so an agent can search incoming mail, inspect individual items, mark them read, move them into folders, and archive messages as part of a guided mailbox-organization workflow. ### Requesting and retrieving mail scans Use the agent to identify a mail item, request an open-and-scan operation, monitor the scan request, and obtain a temporary download URL after the scan is complete. ### Maintaining delivery and deposit details Manage shipping and deposit addresses or update bank-account records used for check deposits without building separate direct REST integrations for each resource. ### Reviewing mailbox logistics Ask an agent to inspect shipment requests and retrieve the account profile or virtual mailing address when a workflow needs current US Global Mail account information. ## よくある質問 ### How is the MCP server connected? Configure an MCP client with the remote endpoint \`https://mcp.usglobalmail.com/mcp\` and send the USGM API key as a bearer token in the \`Authorization\` header. Claude Code also supports adding the server with its \`claude mcp add --transport http\` command. ### Which MCP clients are supported? The documentation provides configurations for Claude Code, Cursor, and VS Code, and states that Windsurf, Cline, and other MCP clients using a remote HTTP server with a URL and authorization header follow the same configuration shape. ### Can I test the connection without using live mail? Yes. Use a \`usgmk\_test\_…\` key with the USGM sandbox. The sandbox is described as a full copy of the API that does not touch live mail; production uses a \`usgmk\_live\_…\` key and the live endpoint. ### What actions require extra care? Discarding mail is destructive, and deleting folders, scan requests, addresses, or bank accounts is also marked destructive. The server annotates destructive tools so agents can ask for confirmation. API keys should be treated like passwords and rotated if exposed. ## クイック情報 - **Product type**: MCP server for a virtual mailbox API - **Connection**: Streamable HTTP at https://mcp.usglobalmail.com/mcp - **Authentication**: USGM API key passed as a bearer token - **Compatible clients**: Claude Code, Cursor, VS Code, Windsurf, Cline, and other MCP clients - **Environments**: Production and sandbox - **API behavior**: Stateless requests with cursor-paginated list results