@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
• List accounts and performance stats
• Create, update, and close trade records
• Create and manage price, trendline, and indicator alerts
• Fetch candles, economic calendar events, macro series, and market config
• Compute technical indicators such as RSI, MACD, EMA, Bollinger Bands, ATR, ADX, Supertrend, and more

Aether Wealth is trading analysis and journaling software. This MCP server does not place broker orders or execute trades.

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:

• 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.
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.

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 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_market_config	Fetch supported instruments and timeframes.

Technical Indicators

Tool	Purpose
get_indicators	Compute up to 8 technical indicators for a pair and interval.

Example Prompts

• "List my open trades and group them by pair. Flag anything without a stop loss."
• "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.
• Destructive trade and account deletion tools are intentionally not exposed.
• The MCP does not execute trades or route broker orders.

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
• npm package: https://www.npmjs.com/package/@aetherwealth/mcp