# Aether Wealth Trading MCP Server

Last updated: 2026-07-15

Aether Wealth Trading MCP Server connects AI assistants to Aether Wealth
journal, alert, market-data, macro, and technical-indicator tools. The
recommended path is the hosted connector for Claude and ChatGPT at
https://mcp.aetherwealth.ai (no install, works on mobile). A local stdio
server via npx is also available for Hermes Agent and other MCP clients that
only speak stdio, for running on a machine you control end to end, or to point
it at your own backend.

Aether Wealth is software, not a broker or financial adviser. The MCP server
can propose supported forex and crypto broker orders, with execution governed
by the user's approval settings.

## Connect

### Hosted connector (recommended, no install)

Add the connector URL as a custom connector, then sign in with your Aether
Wealth account in the browser:

```
https://mcp.aetherwealth.ai
```

- Claude: Settings → Connectors (paid plans). Works on the web and in the
  Claude mobile apps because the connector lives on the account.
- ChatGPT: enable developer mode, then add the connector.

### Local server — Hermes Agent

```bash
hermes mcp add aether-wealth --command npx --args -y @aetherwealth/mcp
hermes mcp test aether-wealth
```

Keep `--args` last; Hermes passes the remaining argv (`-y @aetherwealth/mcp`)
through to `npx`.

If the current Hermes session does not show the tools immediately, restart
Hermes or reload MCP servers.

### Local server — direct command

Prefer the hosted connector above unless your client is stdio-only, you want to
run the server yourself, or you need a pinned version. Use `npx` in your MCP
client config so the client can launch the server after restart.

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

### Local server — MCP client config

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

## Auth

- Both paths use per-user OAuth: the assistant only ever holds a scoped token
  for your account. No shared API keys.
- Hosted: sign in with your Aether Wealth account in the browser on first
  connect; a consent screen is shown and access can be revoked at any time.
- Local: `login` and `logout` are public auth tools. Login uses OAuth in the
  browser; the MCP stores the resulting token locally on the user's machine
  and `logout` clears it.
- Journal, account, alert, market context, macro, and indicator tools require
  Aether Wealth login.

## Tool groups

- Auth: `login`, `logout`
- Trades/accounts/stats: `list_trades`, `get_trade`, `list_accounts`,
  `create_account`, `trade_stats`, `create_trade`, `update_trade`,
  `close_trade`, `delete_trade`, `delete_trades`, `import_trades`
- Context: `get_context`
- Broker execution: `get_broker_account`, `list_broker_positions`, `get_broker_quote`,
  `connect_broker`, `broker_connection_status`, `disconnect_broker`,
  `set_broker_approval_mode`, `propose_trade`, `execute_trade`,
  `trade_intent_status`, `cancel_trade_intent`, `close_position`,
  `modify_position`
- 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_macro_indicator`, `get_market_config`
- FX macro context: `get_fx_pair_context`, `get_fx_currency_context`,
  `get_fx_predictions`, `get_fx_risk_sentiment`, `get_fx_documents`,
  `get_fx_sync_state`
- Technical indicators: `get_indicators`
- Charts: `render_chart`

## Useful prompts

- "List my open trades, group them by pair, and flag anything without a stop
  loss."
- "Create a demo account called Paper USD with a 10,000 USD starting balance."
- "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: "Create a demo account for my prop challenge, 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_account`, `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 all MCP traffic, hosted and local, including
  Bearer-authenticated requests.
- Trade deletion is limited to demo accounts; live-account trades are blocked
  by the backend.
- Technical indicators are capped by request rate, active pairs, Redis cache,
  and upstream 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