x402mail

Provides a crypto-payable MCP server to send and receive emails using a wallet with paid actions.

python

1

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "muzsailajos-x402mail": {
      "command": "x402mail",
      "args": [
        "mcp"
      ],
      "env": {
        "CDP_API_KEY_ID": "your-key-id",
        "CDP_WALLET_SECRET": "your-wallet-secret",
        "CDP_API_KEY_SECRET": "your-key-secret"
      }
    }
  }
}

You can send and receive emails using crypto micropayments without accounts or API keys. This MCP server lets you run local email services backed by a wallet, paying every API call with USDC on Base via the x402 protocol.

How to use

You run a local MCP server and connect your MCP client or AI agent to it. Start the server, provide your CDP credentials to enable paid API calls, then use the client to send emails, check your inbox, list messages, or read specific messages. The server pays for each action using your USDC wallet, so you only need to manage wallet secrets and API keys for authentication.

How to install

Prerequisites: You need Python and pip installed on your system.

pip install x402mail[cdp]

Additional setup notes

Configure credentials and wallet to enable paid API calls. You provide: CDP_API_KEY_ID, CDP_API_KEY_SECRET, and CDP_WALLET_SECRET. You can set these in your environment before starting the MCP server.

export CDP_API_KEY_ID="your-key-id"          # from cdp.coinbase.com
export CDP_API_KEY_SECRET="your-key-secret"
export CDP_WALLET_SECRET="your-wallet-secret"

Run the MCP server

Start the MCP server locally so AI agents can send and receive emails.

x402mail mcp

Configuration example

Below is an example configuration snippet showing how to expose the MCP server for an agent. This registers the local server under the name x402mail and wires the required credentials into the environment used by the MCP runner.

{
  "mcpServers": {
    "x402mail": {
      "command": "x402mail",
      "args": ["mcp"],
      "env": {
        "CDP_API_KEY_ID": "your-key-id",
        "CDP_API_KEY_SECRET": "your-key-secret",
        "CDP_WALLET_SECRET": "your-wallet-secret"
      }
    }
  }
}

MCP Tools

The MCP provides a set of paid actions that agents can perform through the server. Each action incurs a small cost in USDC.

Available tools

send_email

Send an email to a recipient with a subject and body.

get_inbox

Retrieve your inbox address and the count of messages.

list_messages

List messages in your inbox.

read_message

Read the content of a specific message by its identifier.