Каталог MCP
ExpertVagabond/solmail-mcp

ExpertVagabond/solmail-mcp

Name: ExpertVagabond/solmail-mcp
Availability: InStock
Author: expertvagabond

MCP сервер solmail позволяет AI-агентам отправлять физические письма и открытки в 200+ стран с оплатой в Solana. Использует Lob.com, некастодиальный кошелек, работает на devnet и mainnet. Полезен разработчикам, внедряющим крипто-почту в агентов.

Github NPM Сайт сервера

README

4 инструмента

Версии

Установить сервер

:mailbox_with_mail: solmail-mcp

Send real physical mail using Solana cryptocurrency from your AI agent. A Model Context Protocol server that enables Claude and other AI agents to send physical letters and postcards to real addresses worldwide, paid with SOL. Built for the Colosseum Agent Hackathon (#47).

Install

npx solmail-mcp@latest

Add to your MCP config:

{
  "mcpServers": {
    "solmail": {
      "command": "npx",
      "args": ["-y", "solmail-mcp"],
      "env": {
        "SOLANA_NETWORK": "devnet",
        "SOLANA_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

Features

Physical Mail -- Letters printed and mailed to 200+ countries via Lob.com
Solana Payments -- Pay with SOL on devnet (testing) or mainnet (production)
Non-Custodial -- Direct wallet control, no intermediaries
AI-Native -- Built specifically for MCP agent integration
Demo Mode -- Test with devnet SOL and Lob test API at zero cost

Tools (4)

Tool	Description
`get_mail_quote`	Get price quote for sending mail (country, color options)
`send_mail`	Send a physical letter with Solana payment
`get_wallet_balance`	Check agent wallet SOL balance
`get_wallet_address`	Get wallet address for funding

Инструменты были проиндексированы: 18.10.2026

get_mail_quote

Получить ценовое предложение для отправки физической почты. Возвращает цену в USD и предполагаемое количество SOL на основе текущих курсов обмена.

Параметры

colorboolean
Печатать ли в цвете. Добавляет $0.50 к цене.
countrystring
Код страны назначения (например, US, GB, CA). По умолчанию: US.

get_wallet_address

Получить публичный адрес настроенного кошелька. Полезно для получения средств.

Параметры

Без параметров.

get_wallet_balance

Получает текущий баланс SOL настроенного кошелька. Требуется настройка кошелька.

Параметры

Без параметров.

send_mail

Отправляет физическую почту с использованием криптовалюты Solana. Составляет письмо, создает платежную транзакцию Solana и отправляет в SolMail для печати и отправки по почте. Требуется настройка кошелька.

Параметры

contentstringобязательный
Содержимое письма (обычный текст, будет отформатировано как письмо)
mailOptionsobject
Настройки форматирования почты
recipientobjectобязательный
Информация об адресе получателя

`1.0.2`основная	03.02.2026
`1.0.1`	03.02.2026
`1.0.0`	03.02.2026

Выберите клиент, чтобы установить ExpertVagabond/solmail-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "expertvagabond-solmail-mcp-a9ndgvjpy6": {
      "command": "npx",
      "args": [
        "-y",
        "solmail-mcp"
      ],
      "env": {
        "SOLANA_NETWORK": "devnet",
        "SOLANA_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "expertvagabond-solmail-mcp-a9ndgvjpy6": {
      "command": "npx",
      "args": [
        "-y",
        "solmail-mcp"
      ],
      "env": {
        "SOLANA_NETWORK": "devnet",
        "SOLANA_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "expertvagabond-solmail-mcp-a9ndgvjpy6": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "solmail-mcp"
      ],
      "env": {
        "SOLANA_NETWORK": "devnet",
        "SOLANA_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"expertvagabond-solmail-mcp-a9ndgvjpy6\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"solmail-mcp\"],\"env\":{\"SOLANA_NETWORK\":\"devnet\",\"SOLANA_PRIVATE_KEY\":\"your_base58_private_key\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "expertvagabond-solmail-mcp-a9ndgvjpy6": {
      "command": "npx",
      "args": [
        "-y",
        "solmail-mcp"
      ],
      "env": {
        "SOLANA_NETWORK": "devnet",
        "SOLANA_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add expertvagabond-solmail-mcp-a9ndgvjpy6 --env SOLANA_NETWORK=devnet --env SOLANA_PRIVATE_KEY=your_base58_private_key -- npx -y solmail-mcp

Либо через JSON-конфиг:

claude mcp add-json expertvagabond-solmail-mcp-a9ndgvjpy6 "{\"command\":\"npx\",\"args\":[\"-y\",\"solmail-mcp\"],\"env\":{\"SOLANA_NETWORK\":\"devnet\",\"SOLANA_PRIVATE_KEY\":\"your_base58_private_key\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add expertvagabond-solmail-mcp-a9ndgvjpy6 --env SOLANA_NETWORK=devnet --env SOLANA_PRIVATE_KEY=your_base58_private_key -- npx -y solmail-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.expertvagabond-solmail-mcp-a9ndgvjpy6]
command = "npx"
args = ["-y", "solmail-mcp"]

[mcp_servers.expertvagabond-solmail-mcp-a9ndgvjpy6.env]
SOLANA_NETWORK = "devnet"
SOLANA_PRIVATE_KEY = "your_base58_private_key"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите ExpertVagabond/solmail-mcp, а в поле команды запуска — строку ниже:

npx -y solmail-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "expertvagabond-solmail-mcp-a9ndgvjpy6": {
      "command": "npx",
      "args": [
        "-y",
        "solmail-mcp"
      ],
      "env": {
        "SOLANA_NETWORK": "devnet",
        "SOLANA_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "expertvagabond-solmail-mcp-a9ndgvjpy6": {
      "command": "npx",
      "args": [
        "-y",
        "solmail-mcp"
      ],
      "env": {
        "SOLANA_NETWORK": "devnet",
        "SOLANA_PRIVATE_KEY": "your_base58_private_key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например expertvagabond-solmail-mcp-a9ndgvjpy6.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: expertvagabond-solmail-mcp-a9ndgvjpy6
    command: npx
    args:
      - "-y"
      - "solmail-mcp"
    env:
      SOLANA_NETWORK: devnet
      SOLANA_PRIVATE_KEY: your_base58_private_key

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "expertvagabond-solmail-mcp-a9ndgvjpy6": {
      "command": "npx",
      "args": [
        "-y",
        "solmail-mcp"
      ],
      "env": {
        "SOLANA_NETWORK": "devnet",
        "SOLANA_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "solmail-mcp"
  ],
  "env": {
    "SOLANA_NETWORK": "devnet",
    "SOLANA_PRIVATE_KEY": "your_base58_private_key"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx