Cursor

Cursor is an AI-powered code editor. Use it if you want to integrate trading into development workflows.

Prerequisites

• Cursor IDE installed
• Your FIX credentials (see Before You Start

OAuth Method

Step 1: Open Cursor Configuration

1. Open Cursor
2. Go to Settings > Features > MCP
3. Click Add MCP Server

Step 2: Add the Server

1. Name: axiory-ai (or Axiory.ai)
2. Type: streamable-http
3. URL: https://mcp.axiory.ai/mcp
4. Click Save

Step 3: OAuth Login

Cursor opens a browser with the FIX credentials form:

1. Select your broker server
2. Enter your SenderCompID (from cTrader Settings > FIX API)
3. Enter your FIX API Password (NOT your cTrader login password)
4. Set trading mode (readonly/paper/live)
5. Click Connect

You’ll see “Connected Successfully”.

Step 4: Test Connection

In Cursor, open a chat and ask:

“Are you connected to cTrader? Show me my positions.”

Cursor should respond with your account status.

Portal Token Method (Fallback)

If OAuth doesn’t work:

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
4. Click Generate Token
5. Copy the token

Step 2: Store Token

Set the token in your environment:

export AXIORY_TOKEN="your-token-here"

Add to ~/.zshrc or ~/.bashrc to persist:

echo 'export AXIORY_TOKEN="your-token-here"' >> ~/.zshrc
source ~/.zshrc

Step 3: Configure Cursor

In Cursor MCP settings, add:

{
  "name": "axiory-ai",
  "type": "streamable-http",
  "url": "https://mcp.axiory.ai/mcp",
  "headers": {
    "Authorization": "Bearer ${env:AXIORY_TOKEN}"
  }
}

The ${env:AXIORY_TOKEN} syntax tells Cursor to use the environment variable.

Step 4: Restart Cursor

Close and reopen Cursor to load the new environment variable.

Using in Cursor

Once connected, you can:

1. Ask Cursor to fetch real-time market data
2. Ask it to place orders
3. Build trading bots or scripts that integrate with Axiory.ai
4. Backtest strategies

Examples:

@axiory-ai Show me the current EURUSD price

@axiory-ai I want to build a simple moving average crossover bot. Here's my idea:
- Buy when the 20-period MA crosses above the 50-period MA
- Sell when it crosses below
- Position size: 100,000 units

Can you implement this?

Cursor will use the Axiory.ai tools to fetch quotes, manage positions, etc.

Making Your First Trade

In Cursor chat:

“Buy 50,000 units of EURUSD at the current market price”

Cursor will:

1. Fetch the current price
2. Place the order
3. Show you the confirmation

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
2. Generate a new token
3. Update your environment variable: export AXIORY_TOKEN="new-token"
4. Restart Cursor

If your token expires, you’ll see “401 Unauthorized”. Generate a new one.

Troubleshooting

”MCP server not found” or “Connection refused”

Check:

1. Cursor MCP settings have the correct URL: https://mcp.axiory.ai/mcp
2. The config was saved (not in edit mode)
3. Restart Cursor after saving

”Invalid credentials” in the OAuth form

Your FIX credentials are wrong:

1. Go to cTrader Settings > FIX API
2. Copy SenderCompID exactly (with all dots and numbers)
3. Copy FIX API Password exactly (NOT your login password)
4. Retry OAuth or regenerate a Portal Token

”401 Unauthorized” (Portal Token)

Your token has expired or is invalid:

1. Check: 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 env var and restart Cursor

Cursor can’t find the environment variable

Make sure you’ve:

1. Set the variable: export AXIORY_TOKEN="..."
2. Restarted Cursor (not just reloaded settings)
3. Verified the env var exists: echo $AXIORY_TOKEN

If it still doesn’t work, hardcode the token temporarily (not recommended for production):

{
  "headers": {
    "Authorization": "Bearer actual-token-here"
  }
}

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

Cursor is great for building custom trading scripts. Start with paper mode to test.