@aetherwealth/mcp

Aether Wealth MCP Server

Official Model Context Protocol (MCP) server for Aether Wealth. Connect any stdio-compatible MCP client to your Aether Wealth trading journal, accounts, alerts, market context, macro calendar, and technical indicators.

The package runs locally with npx, authenticates with browser-based OAuth, and uses your Aether Wealth account permissions for every data tool. It is built for traders who want an AI assistant to inspect their journal, summarize performance, create alerts, and fetch market context without copying API keys into their MCP client.

Install

Use the package in any MCP client that can launch a local stdio server.

npx -y @aetherwealth/mcp

Most MCP clients use a JSON config like this:

{
  "mcpServers": {
    "aether-wealth": {
      "command": "npx",
      "args": ["-y", "@aetherwealth/mcp"]
    }
  }
}

Restart your MCP client after adding the server. Then ask it to run the login tool once.

What It Does

Aether Wealth MCP gives AI assistants a safe tool layer over Aether Wealth:

• Read and summarize your trading journal
• 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, FX macro context, and market config
• Render chart images
• Compute technical indicators such as RSI, MACD, EMA, Bollinger Bands, ATR, ADX, Supertrend, and more
• Propose broker trade intents; email/app modes require a user-provided code, automatic mode does not require a per-trade code, and push mode requires the user to tap Approve in the app

Aether Wealth broker execution is intent-based: the assistant can propose, but the backend enforces the connection's approval mode before any order is placed.

Authentication

The login tool opens the Aether Wealth OAuth flow in your browser. After you approve access, the MCP stores a local token in the operating-system keychain where available, with a protected file fallback.

No shared API key is configured in your MCP client. All data tools require OAuth sign-in, including market-data tools. logout clears the local credential for this device.

Hosted (Remote) Mode

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.
• The login/logout tools are not registered — the MCP client owns the OAuth flow, and nothing is stored server-side (no keychain, no sessions).
• Requests are rate limited per caller (per token, else per client IP; MCP_RATE_LIMIT_MAX requests/minute, default 120) — over-limit calls get 429 with a Retry-After header. Health/discovery routes are exempt.
• /healthz reports liveness for load balancers.

Tools

Auth

Tool	Purpose
login	Sign in with Aether Wealth OAuth.
logout	Clear the local OAuth credential on this device.

Trades, Accounts, And Stats

Tool	Purpose
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

Tool	Purpose
list_alerts	List price and trendline alerts.
create_price_alert	Create a price-level alert.
create_trendline_alert	Create a trendline alert from two chart points.
update_alert	Update or archive a price or trendline alert.
delete_alert	Delete a price or trendline alert.
list_indicator_alerts	List indicator-based alerts.
create_indicator_alert	Create an alert on an indicator output condition.
update_indicator_alert	Update an indicator alert.
delete_indicator_alert	Delete an indicator alert.

Market Context

Tool	Purpose
get_candles	Fetch OHLC candles for a pair, timeframe, and optional sourceId. Omission uses Twelve Data; broker sources expose native candles only. Returns up to 200 plus nextCursor.
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, timeframes, and per-source capabilities.

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.
disconnect_broker	Disarm broker trading immediately and cancel pending intents.
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/app intents with a code or automatic-mode intents without one; 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	Propose closing an open broker position fully or partially.
modify_position	Propose stop-loss or take-profit changes without increasing risk.

Charts

Tool	Purpose
render_chart	Render a candlestick chart image for a pair, timeframe, and optional sourceId.

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?"
• "Fetch EUR/USD 1h RSI and MACD, then create an alert if RSI crosses below 40."
• "Create a price alert if XAU/USD crosses yesterday's high before New York open."

Safety And Limits

• OAuth is per user. Your MCP client does not store a shared service secret.
• Tokens are stored locally and can be cleared with logout.
• Backend rate limits protect market-data reads, MCP Bearer traffic, and cost-sensitive indicator calls.
• Technical indicators include request, active-pair, cache, and upstream credit gates.
• Trade deletion is limited to demo accounts. Live-account trades cannot be deleted through this MCP.
• Broker orders follow the user's backend-enforced approval mode. Push-mode intents cannot be executed by the assistant; automatic mode requires no separate approval for each trade.

Updating

If your MCP client launches the server with npx -y @aetherwealth/mcp, restart the client to pick up the current published package.

The backend can also advertise a minimum supported MCP version. If your local server is too old, tool calls return an update-required message instead of failing silently.

Links

• Aether Wealth: https://aetherwealth.ai
• Trading app: https://app.aetherwealth.ai
• MCP page: https://aetherwealth.ai/mcp
• Tool reference: https://aetherwealth.ai/mcp-tools.json
• Terms: https://aetherwealth.ai/terms
• Privacy: https://aetherwealth.ai/privacy
• npm package: https://www.npmjs.com/package/@aetherwealth/mcp

License

Proprietary. See the LICENSE file included with this package.