@aetherwealth/mcp 0.1.29 → 0.1.35

package/README.md

@@ -39,15 +39,21 @@ Restart your MCP client after adding the server. Then ask it to run the
 Aether Wealth MCP gives AI assistants a safe tool layer over Aether Wealth:
 
 - Read and summarize your trading journal
-- List accounts and performance stats
+- Create/list accounts and performance stats
 - Create, update, and close trade records
+- Delete trade records only from demo accounts
 - Create and manage price, trendline, and indicator alerts
-- Fetch candles, economic calendar events, macro series, and market config
+- Fetch candles, economic calendar events, macro series, FX macro context, and
+  market config
+- Render chart images and drive an open browser chart
 - Compute technical indicators such as RSI, MACD, EMA, Bollinger Bands, ATR,
   ADX, Supertrend, and more
+- Propose broker trade intents and execute only user-confirmed email/app/auto
+  intents; push-mode intents execute only after the user taps Approve in the app
 
-Aether Wealth is trading analysis and journaling software. This MCP server does
-not place broker orders or execute trades.
+Aether Wealth broker execution is intent-based: the assistant can propose, but
+the backend enforces the selected user confirmation channel before any order is
+placed.
 
 ## Authentication
 
@@ -65,6 +71,8 @@ Operators can deploy this server as a shared remote MCP endpoint instead of a
 local process. Set `MCP_TRANSPORT=http`, `MCP_HTTP_AUTH=oauth`, and
 `MCP_PUBLIC_ORIGIN=https://<your-host>`. In this mode:
 
+- The Aether-hosted endpoint is `https://mcp.aetherwealth.ai`; `/mcp` remains
+  available as a legacy connector alias.
 - Each request must carry the caller's own OAuth access token
   (`Authorization: Bearer ...`); MCP clients obtain it via the standard MCP
   auth flow, discovered from `/.well-known/oauth-protected-resource`.
@@ -92,10 +100,20 @@ local process. Set `MCP_TRANSPORT=http`, `MCP_HTTP_AUTH=oauth`, and
 | `list_trades` | List trades by account, status, pair, or date range. |
 | `get_trade` | Fetch one trade by ID. |
 | `list_accounts` | List your trading accounts. |
+| `create_account` | Create a trading account in the journal. |
 | `trade_stats` | Summarize performance, win rate, PnL, and related stats. |
 | `create_trade` | Record a new trade. |
 | `update_trade` | Update fields on an existing trade. |
 | `close_trade` | Close an open trade with exit price and time. |
+| `delete_trade` | Delete one trade from a demo account. |
+| `delete_trades` | Delete matching trades from a demo account. |
+| `import_trades` | Bulk-import up to 500 trades into one account. |
+
+### Context
+
+| Tool | Purpose |
+| --- | --- |
+| `get_context` | Snapshot accounts, open trades, recent stats, and active alerts. |
 
 ### Alerts
 
@@ -118,18 +136,57 @@ local process. Set `MCP_TRANSPORT=http`, `MCP_HTTP_AUTH=oauth`, and
 | `get_candles` | Fetch recent OHLC candles for a pair and timeframe. Returns up to 200 per request (newest 200 by default); use `offset` to page back through the full stored history. |
 | `list_economic_calendar` | List economic calendar events by currency, release, date, or impact. |
 | `get_macro_series` | Fetch macro indicator time series such as CPI or interest-rate data. |
+| `get_macro_indicator` | Fetch curated FXMacroData indicator series with unit and target metadata. |
 | `get_market_config` | Fetch supported instruments and timeframes. |
 
+### FX Macro Context
+
+| Tool | Purpose |
+| --- | --- |
+| `get_fx_pair_context` | Macro context for both currencies in a pair. |
+| `get_fx_currency_context` | Recent releases, surprises, and derived state for one currency. |
+| `get_fx_predictions` | Model forecasts for upcoming macro releases. |
+| `get_fx_risk_sentiment` | Cross-market risk-on/risk-off sentiment series. |
+| `get_fx_documents` | Source documents behind FX macro data. |
+| `get_fx_sync_state` | Freshness and sync status for FX macro datasets. |
+
 ### Technical Indicators
 
 | Tool | Purpose |
 | --- | --- |
 | `get_indicators` | Compute up to 8 technical indicators for a pair and interval. |
 
+### Broker Execution
+
+| Tool | Purpose |
+| --- | --- |
+| `get_broker_account` | Read live broker account balance, equity, currency, and connection status. |
+| `list_broker_positions` | List open broker positions with P&L. |
+| `connect_broker` | Attach the user's already-deployed MetaApi account to a journal account. |
+| `broker_connection_status` | Read the current live broker connection status. |
+| `set_broker_approval_mode` | Switch confirmation between `app_otp`, `email_otp`, and `push`; `push` requires an active app push subscription. |
+| `propose_trade` | Size and propose a trade intent. Push-mode proposals notify the user's device. |
+| `execute_trade` | Execute email_otp/app_otp/auto intents after the required confirmation; push intents are blocked here. |
+| `trade_intent_status` | Check whether a proposed intent was approved, executed, expired, cancelled, or failed. |
+| `cancel_trade_intent` | Cancel a pending proposed broker trade. |
+| `close_position` | Close an open broker position fully or partially. |
+| `modify_position` | Adjust stop-loss or take-profit without increasing risk. |
+
+### Charts
+
+| Tool | Purpose |
+| --- | --- |
+| `render_chart` | Render a candlestick chart image for a pair and timeframe. |
+| `chart_select_pair` | Switch the user's open browser chart to a trading pair. |
+| `chart_change_timeframe` | Change the timeframe of the user's open browser chart. |
+| `chart_draw_shapes` | Draw levels, zones, and position overlays on the open chart. |
+| `chart_remove_drawings` | Remove AI-drawn shapes from the open chart. |
+
 ## Example Prompts
 
 - "List my open trades and group them by pair. Flag anything without a stop
   loss."
+- "Create a demo account called Paper USD with a 10,000 USD starting balance."
 - "Summarize my last 20 closed trades. What setup is leaking the most R?"
 - "What high-impact USD events are left this week, and which open trades overlap
   them?"
@@ -145,8 +202,11 @@ local process. Set `MCP_TRANSPORT=http`, `MCP_HTTP_AUTH=oauth`, and
   cost-sensitive indicator calls.
 - Technical indicators include request, active-pair, cache, and upstream credit
   gates.
-- Destructive trade and account deletion tools are intentionally not exposed.
-- The MCP does not execute trades or route broker orders.
+- Trade deletion is limited to demo accounts. Live-account trades cannot be
+  deleted through this MCP.
+- Broker orders require backend-enforced confirmation. Push-mode intents cannot
+  be executed by the assistant; use `trade_intent_status` to observe the user's
+  app approval outcome.
 
 ## Updating