# Aether Wealth Trading MCP Server

Last updated: 2026-06-27

Aether Wealth Trading MCP Server is a local MCP server for AI trading
workflows. It connects any stdio MCP client to Aether Wealth journal, alert,
market-data, macro, and technical-indicator tools.

Aether Wealth is analysis and journaling software. It is not a brokerage and
the MCP server does not execute trades.

## Install

Use `npx` in your MCP client config so the client can launch the server after
restart.

### Direct command

```bash
npx -y @aetherwealth/mcp
```

### MCP client config

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

## Auth

- `login` and `logout` are public auth tools.
- Journal, account, alert, market context, macro, and indicator tools require
  Aether Wealth login through the `login` tool.
- Login uses OAuth in the browser. The MCP stores the resulting token locally
  on the user's machine.
- `logout` clears the local credential.

## Tool groups

- Auth: `login`, `logout`
- Trades/accounts/stats: `list_trades`, `get_trade`, `list_accounts`,
  `trade_stats`, `create_trade`, `update_trade`, `close_trade`
- Alerts: `list_alerts`, `create_price_alert`, `create_trendline_alert`,
  `update_alert`, `delete_alert`, `list_indicator_alerts`,
  `create_indicator_alert`, `update_indicator_alert`,
  `delete_indicator_alert`
- Market context: `get_candles`, `list_economic_calendar`,
  `get_macro_series`, `get_market_config`
- Technical indicators: `get_indicators`

## Useful prompts

- "List my open trades, group them by pair, and flag anything without a stop
  loss."
- "What high-impact USD events are left this week, and which of my open trades
  overlap them?"
- "Fetch EUR/USD 1h RSI and MACD, then create an alert if RSI crosses below
  40."
- "Summarize my last 20 closed trades and tell me which session is leaking R."

## Real workflows

### Post-session review

Prompt: "Log my three EUR/USD trades from this transcript, tag the London-open
entries, then tell me whether I broke my max-loss rule."

Tools used: `create_trade`, `list_accounts`, `trade_stats`, `update_trade`.

### Pre-market prep

Prompt: "What moves XAU/USD this week, where is 1H RSI now, and alert me if
price crosses yesterday high before New York open."

Tools used: `list_economic_calendar`, `get_candles`, `get_indicators`,
`create_price_alert`.

## Limits and versioning

- The backend rate-limits MCP traffic, including Bearer-authenticated requests.
- Technical indicators are capped by request rate, active pairs, Redis cache,
  and Twelve Data credit budget.
- The backend can advertise a minimum MCP version. Clients below that minimum
  show an update-required message.

## References

- Human page: https://aetherwealth.ai/mcp
- Tool reference: https://aetherwealth.ai/mcp-tools.json
- npm package: https://www.npmjs.com/package/@aetherwealth/mcp