2.7 KiB
2.7 KiB
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
npm install
cp .env.example .env
npm run dev
API Endpoints
Agents
GET /api/v1/agents- List all agentsGET /api/v1/agents/:agentType- Get agent configGET /api/v1/agents/:agentType/performance- Agent performance metricsGET /api/v1/agents/:agentType/distributions- Profit distribution history
Allocations
POST /api/v1/allocations- Create allocation (debits wallet)GET /api/v1/allocations- List allocationsGET /api/v1/allocations/:id- Get allocationPOST /api/v1/allocations/:id/fund- Add fundsPOST /api/v1/allocations/:id/withdraw- Withdraw fundsPATCH /api/v1/allocations/:id/status- Update statusGET /api/v1/allocations/:id/transactions- Transaction history
User
GET /api/v1/users/:userId/allocations- User allocationsGET /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 activationactive- Active and tradingpaused- Temporarily pausedliquidating- Liquidation in progressclosed- 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