# three.ws Portfolio

Даёт агенту доступ к портфелю, балансу кошельков и закрытым сделкам через MCP. Также умеет отправлять токены в сети Solana.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 249
- Автор: nirholas
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/nirholas/three.ws/tree/HEAD/packages/portfolio-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/threews-portfolio

## Что делает

Сервер получает данные из three.ws и Solana RPC. Он показывает стоимость портфеля и её историю, позиции по отдельным токенам, публичную ленту закрытых сделок с реализованным PnL и балансы Solana-кошельков. Для данных по аккаунту нужна сессия three.ws; лента сделок и балансы доступны без неё.

\`send_transfer` подписывает и отправляет реальный перевод SOL или SPL-токена в Solana mainnet. Ключ задаётся через `SOLANA_SECRET_KEY` или параметр `secret`, а для выполнения требуется `confirm: true`. Перевод необратим: проверьте адрес и сумму до вызова. Для работы нужен Node.js >= 20.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `THREE_WS_BASE`, `THREE_WS_TIMEOUT_MS`, `THREE_WS_SESSION`, `SOLANA_RPC_URL`, `SOLANA_SECRET_KEY`, `MAX_SOL_PER_TX`, `RECIPIENT_ALLOWLIST`, `REQUIRE_CONFIRM` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_SESSION=<THREE_WS_SESSION> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> --transport stdio portfolio-mcp -- npx -y @three-ws/portfolio-mcp
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add portfolio-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --env THREE_WS_SESSION=<THREE_WS_SESSION> --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/portfolio-mcp
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "portfolio-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/portfolio-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>",
                "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
                "THREE_WS_SESSION": "<THREE_WS_SESSION>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "portfolio-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@three-ws/portfolio-mcp"
            ],
            "env": {
                "THREE_WS_BASE": "<THREE_WS_BASE>",
                "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>",
                "THREE_WS_SESSION": "<THREE_WS_SESSION>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -e THREE_WS_SESSION=<THREE_WS_SESSION> -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> portfolio-mcp npx -y @three-ws/portfolio-mcp
```
Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера

## Когда брать
- проверить текущую стоимость активов во всех своих кошельках
- посмотреть историю стоимости портфеля
- найти реализованный PnL по закрытым сделкам
- узнать балансы SOL и SPL-токенов по адресу
- отправить SOL или SPL-токен из своего кошелька

## Примеры запросов агенту
- Покажи стоимость моего портфеля сейчас и разбивку по кошелькам.
- Сравни историю портфеля за последние 30 дней и найди сделки с реализованным PnL по одному токену.
- Отправь 0.1 SOL на этот адрес; сначала проверь получателя и сумму, затем запроси подтверждение.

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/nevibecode/mcp/letsfg-flights-hotels.md) — MCP-сервер · ★ 2188
- [AutoTS](https://affpapa.org/nevibecode/mcp/autots.md) — MCP-сервер · ★ 1434

Из того же набора: [nirholas/three.ws](https://affpapa.org/nevibecode/by/nirholas/three.ws.md) — 43 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md