Claude Code CLI

Claude Code is Anthropic’s command-line interface for Claude. Use it if you prefer terminal-based workflows.

Prerequisites

• Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
• Your FIX credentials (see Before You Start

OAuth Method (Recommended)

Step 1: Add the Server

claude mcp add axiory-ai --transport http \
  https://mcp.axiory.ai/mcp

Step 2: OAuth Login

The CLI opens a browser automatically. Complete the OAuth flow:

1. Select your broker server (if available)
2. Enter your SenderCompID and FIX API Password
3. Set trading mode (readonly/paper/live)
4. Click Connect

Step 3: Use in Claude Code

Now you can interact with the trading tools:

claude

# In the Claude Code prompt:
> Show me my open positions
> What's the current price of EURUSD?
> Buy 100,000 units of EURUSD at market

Portal Token Method (Fallback)

If OAuth doesn’t open a browser (headless environments):

Step 1: Generate a Token

Visit in your browser:

https://mcp.axiory.ai/token-portal

1. Select your broker server
2. Enter your FIX credentials
3. Choose trading mode (readonly/paper/live)
4. Click Generate Token
5. Copy the token (shown once, never again)

Step 2: Configure Claude Code

Set the token in your shell environment:

export AXIORY_TOKEN="your-token-here"

Add the server with the token:

claude mcp add axiory-ai --transport http \
  --header "Authorization: Bearer $AXIORY_TOKEN" \
  https://mcp.axiory.ai/mcp

Step 3: Use It

claude

# In the Claude Code prompt:
> What's my current account balance?
> Place a buy order for EURUSD, 50,000 units

Making Your First Trade

Once connected:

claude

# Ask Claude:
> Can you check that you're connected to cTrader and show me my current positions?

# If connected, place a trade:
> I want to buy 100,000 units of EURUSD at the market price. Can you do that?

# In paper mode, it simulates. In live mode, it executes.

Token Rotation

Portal tokens expire after 30 days. Before expiry:

1. Visit the Token Portal again
2. Generate a new token
3. Update your environment variable:

   export AXIORY_TOKEN="new-token-here"

If your token expires, you’ll see “401 Unauthorized” errors. Generate a new one at the Token Portal.

Troubleshooting

”Server not found” or “Connection refused”

Check that the server was added correctly:

claude mcp list

You should see axiory-ai in the list. If not, re-run the add command.

”401 Unauthorized” (Portal Token)

Your token has expired or is invalid.

1. Check the token is set: echo $AXIORY_TOKEN
2. If empty, set it: export AXIORY_TOKEN="your-token"
3. If invalid, generate a new one at the Token Portal
4. Update the environment variable and try again

”Invalid credentials”

Your FIX credentials are wrong:

1. Go to cTrader Settings > FIX API
2. Verify your SenderCompID and FIX API Password (NOT your login password)
3. Re-generate the token or re-authenticate via OAuth
4. Try again

OAuth flow doesn’t open a browser

If you’re on a headless server (no GUI):

1. Use the Portal Token method instead
2. Or, run DISPLAY=:0 claude mcp add ... to force X11 display
3. Or, manually navigate to the OAuth authorize endpoint (advanced)

Next Steps

• Operating Modes — Understand readonly, paper, and live
• Risk Limits — Position size and daily loss limits
• Choosing an Agent — Compare with other MCP clients

Start with paper mode to test, then switch to live when confident.