# tinkoff-wealth-mcp

> **Суть проекта:** это MCP-сервер, заточенный под мои личные нужды для **Тинькофф
> Инвестиций** — мой портфель, мои цели, моя стратегия. Подключается к Claude/ChatGPT,
> чтобы управлять инвестициями голосом/текстом в чате.

# 📈 Персональный AI‑аналитик вашего портфеля. Прямо в чате.

**Подключите свой брокерский счёт — и общайтесь с инвестициями на обычном языке.**
Никаких таблиц и дашбордов: спрашиваете в чате, получаете анализ уровня личного
финансового советника. На компьютере и телефоне.

---

## Весь капитал — как одно целое
Несколько брокерских счетов сводятся в единый портфель. Оценка **совпадает с
приложением брокера до копейки**: валютные бумаги пересчитаны по курсу, по облигациям
учтён накопленный купонный доход. Разрезы по классам активов, валютам, секторам и
эмитентам — за секунду.

## Риски, которые видно до того, как они выстрелят
Концентрация по позициям, **эмитентам и секторам** считается против ваших лимитов. Все
выпуски одного эмитента объединяются автоматически — никаких «спрятанных» перекосов.
Система честно подсвечивает, где вы зависите от одного имени слишком сильно.

## Облигации под контролем
Календарь купонов, погашений и оферт — с суммами под ваш объём. Лестница сроков. Прогноз
купонного дохода на год вперёд. Вы всегда знаете, **когда и сколько денег придёт**.

## Ваши цели — в центре всего
Задайте цель: капитал, пассивный доход, горизонт, принципы. Трекер покажет **прогресс к
финансовой независимости** в процентах и спрогнозирует, **когда вы её достигнете** при
текущем темпе пополнений.

## Рекомендации, а не просто цифры
На любую сумму пополнения — куда вложить, чтобы приближаться к целям и **не усиливать
перекосы**. Объяснимо: с обоснованием, рисками и альтернативами. Никаких категоричных
«купи это».

## Умнее, чем калькулятор: контекст рынка внутри совета
Ассистент **сам понимает, что важно именно для вашего портфеля** — ключевая ставка,
кредитные спреды, сырьевой цикл, валюта, геополитика, регуляторика секторов — и **изучает
актуальную картину в реальном времени**, вплетая её в рекомендации. Без отдельных просьб.

## Новости — только те, что про вас
Не лента «обо всём», а адресный разбор: что нового по **вашим** эмитентам, секторам и
рискам, и как это влияет на портфель.

## «Что если» без риска
Смоделируйте покупку, продажу или ребаланс и увидьте эффект на доли, концентрацию и
риски — **без единой реальной сделки**.

## Быстро. Надёжно. Безопасно.
- ⚡ Мгновенные ответы — данные кэшируются, брокер не перегружается.
- 🛡 Работает даже при недоступном API — отдаёт последние данные и честно помечает их актуальность.
- 🔒 **Только чтение.** Никогда не торгует и не двигает ваши деньги.
- 📱 В чате, на любом устройстве, по защищённому каналу.

---

## 🤖 Работает в Claude и ChatGPT
Один и тот же сервер подключается как **custom-коннектор** сразу к обоим ассистентам —
ответы MCP можно использовать и там, и там:

- **Claude** — добавляется в Connectors на claude.ai (веб/десктоп) и работает в том числе
  в **мобильных приложениях** Claude.
- **ChatGPT** — подключается через **Developer mode** (custom MCP-коннектор) в веб-версии.

Подключаете один раз по защищённой ссылке — и спрашиваете про свой портфель в привычном
чате, на любом устройстве.

---

### Инвестиционный терминал нового поколения — на естественном языке.
**Знает ваш портфель и цели. Считает риски и доход. Видит путь к финансовой
независимости. Советует с учётом рынка — здесь и сейчас.**

> _Аналитический инструмент. Не является индивидуальной инвестиционной рекомендацией;
> доходность не гарантируется._

---

📘 **Техническая документация:** [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) (архитектура,
схемы, запуск, env, тесты) · **Деплой и CI:** [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)