# MCP Investment Server

Investment/Agent Allocation MCP Server for the Trading Platform. Manages Money Manager agents (Atlas, Orion, Nova) allocations and profit distributions.

## Agents

| Agent | Risk Level | Target Return | Max Drawdown | Mgmt Fee | Perf Fee |
|-------|------------|---------------|--------------|----------|----------|
| **Atlas** | Conservative | 8%/yr | 5% | 1.5% | 15% |
| **Orion** | Moderate | 15%/yr | 12% | 2.0% | 20% |
| **Nova** | Aggressive | 25%/yr | 25% | 2.5% | 25% |

## Quick Start

```bash
npm install
cp .env.example .env
npm run dev
```

## API Endpoints

### Agents
- `GET /api/v1/agents` - List all agents
- `GET /api/v1/agents/:agentType` - Get agent config
- `GET /api/v1/agents/:agentType/performance` - Agent performance metrics
- `GET /api/v1/agents/:agentType/distributions` - Profit distribution history

### Allocations
- `POST /api/v1/allocations` - Create allocation (debits wallet)
- `GET /api/v1/allocations` - List allocations
- `GET /api/v1/allocations/:id` - Get allocation
- `POST /api/v1/allocations/:id/fund` - Add funds
- `POST /api/v1/allocations/:id/withdraw` - Withdraw funds
- `PATCH /api/v1/allocations/:id/status` - Update status
- `GET /api/v1/allocations/:id/transactions` - Transaction history

### User
- `GET /api/v1/users/:userId/allocations` - User allocations
- `GET /api/v1/users/:userId/investment-summary` - Portfolio summary

### Admin
- `POST /api/v1/admin/distribute-profits` - Distribute profits

## MCP Tools (14)

| Tool | Description |
|------|-------------|
| `investment_list_agents` | List agents |
| `investment_get_agent` | Get agent config |
| `investment_create_allocation` | Create allocation |
| `investment_get_allocation` | Get allocation |
| `investment_list_allocations` | List allocations |
| `investment_get_user_allocations` | User allocations |
| `investment_fund_allocation` | Add funds |
| `investment_withdraw` | Withdraw funds |
| `investment_update_status` | Update status |
| `investment_get_transactions` | Get transactions |
| `investment_distribute_profits` | Distribute profits |
| `investment_get_distributions` | Distribution history |
| `investment_get_user_summary` | User summary |
| `investment_get_agent_performance` | Agent metrics |

## Allocation Status

- `pending` - Awaiting activation
- `active` - Active and trading
- `paused` - Temporarily paused
- `liquidating` - Liquidation in progress
- `closed` - Closed/fully withdrawn

## Features

- 7-day lock period for new allocations
- 5% early withdrawal penalty
- Automatic profit distribution to allocations
- Management and performance fee deduction
- Integration with Wallet service for funding/withdrawals

## License

UNLICENSED - Private