ig-trading-mcp

A modern Node.js client for IG Trading API with built-in MCP (Model Context Protocol) server for AI integration. Trade forex, indices, commodities and more through IG's REST API, now with AI assistant support.

Features

• MCP Server - 21 tools for AI assistants (Claude, Cursor, etc.)
• Complete IG REST API - Trading, positions, orders, market data
• Enterprise Security - RSA encryption, rate limiting, audit logging
• Modern JavaScript - ES modules, async/await, full TypeScript support
• Battle-tested - Production-ready with comprehensive error handling

Quick Start

Install & Run with npx (no installation needed)

# Run directly with npx
npx ig-trading-mcp serve --api-key YOUR_KEY --identifier YOUR_ID --password YOUR_PWD

# Or install globally
npm install -g ig-trading-mcp
ig-trading-mcp serve

Basic Setup

1. Initialize configuration:

npx ig-trading-mcp init

1. Edit .env with your IG credentials:

IG_API_KEY=your_api_key_here
IG_IDENTIFIER=your_username_here
IG_PASSWORD=your_password_here
IG_DEMO=true

1. Test connection:

npx ig-trading-mcp test

1. Start MCP server for AI tools:

npx ig-trading-mcp serve

Usage Examples

Command Line Interface

# Start MCP server with credentials
npx ig-trading-mcp serve \
  --api-key YOUR_API_KEY \
  --identifier YOUR_USERNAME \
  --password YOUR_PASSWORD \
  --demo true

# Test account connection
npx ig-trading-mcp test

# List available tools
npx ig-trading-mcp tools

# Initialize config files
npx ig-trading-mcp init

As a Node.js Library

import { IGService } from 'ig-trading-mcp';

const ig = new IGService({
  apiKey: 'YOUR_API_KEY',
  identifier: 'YOUR_USERNAME',
  password: 'YOUR_PASSWORD',
  isDemo: true
});

// Login
await ig.login();

// Get accounts
const accounts = await ig.getAccounts();
console.log('Balance:', accounts.accounts[0].balance);

// Search markets
const markets = await ig.searchMarkets('EUR/USD');

// Create position
const position = await ig.createPosition({
  epic: 'CS.D.EURUSD.CFD.IP',
  direction: 'BUY',
  size: 1,
  orderType: 'MARKET',
  guaranteedStop: false,
  forceOpen: true
});

// Get positions
const positions = await ig.getPositions();

// Close position
await ig.closePosition(position.dealId);

// Logout
await ig.logout();

AI Integration (MCP)

Configure with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ig-trading": {
      "command": "npx",
      "args": ["ig-trading-mcp", "serve"],
      "env": {
        "IG_API_KEY": "your_api_key",
        "IG_IDENTIFIER": "your_username",
        "IG_PASSWORD": "your_password",
        "IG_DEMO": "true"
      }
    }
  }
}

Configure with Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "ig-trading": {
      "command": "npx",
      "args": ["ig-trading-mcp", "serve"],
      "env": {
        "IG_API_KEY": "${IG_API_KEY}",
        "IG_IDENTIFIER": "${IG_IDENTIFIER}",
        "IG_PASSWORD": "${IG_PASSWORD}",
        "IG_DEMO": "true"
      }
    }
  }
}

Available MCP Tools (21)

Account Management (5)

• ig_login - Authenticate with IG
• ig_logout - End session
• ig_get_accounts - List all accounts
• ig_switch_account - Change active account
• ig_get_account_activity - View account history

Position Management (5)

• ig_get_positions - View open positions
• ig_create_position - Open new position
• ig_update_position - Modify position
• ig_close_position - Close specific position
• ig_close_all_positions - Close all positions

Order Management (3)

• ig_get_working_orders - View pending orders
• ig_create_working_order - Place new order
• ig_delete_working_order - Cancel order

Market Data (4)

• ig_search_markets - Search tradeable markets
• ig_get_market_details - Get market info
• ig_get_historical_prices - Historical data
• ig_get_client_sentiment - Market sentiment

Watchlists (4)

• ig_get_watchlists - View all watchlists
• ig_get_watchlist - Get specific watchlist
• ig_create_watchlist - Create watchlist
• ig_add_to_watchlist - Add market to list

Security Features

• RSA Encryption - Password encryption using pidCrypt (IG-compatible)
• Secure Storage - Credentials encrypted with AES-256-GCM
• Rate Limiting - Automatic throttling (60 req/min)
• Audit Logging - Track all operations
• Session Management - JWT tokens with auto-refresh
• Input Validation - Joi schemas for all inputs

Project Structure

ig-trading-mcp/
 bin/
    cli.js              # CLI entry point
 src/
    core/               # Core modules
       api-client.js   # HTTP client
       config.js       # Configuration
       encryption.cjs  # RSA encryption
    services/           # Business logic
       ig-service.js   # Main IG API
       mcp-service.js  # MCP server
    security/           # Security layer
    indicators/         # Trading indicators
 examples/               # Usage examples
 scripts/                # Utility scripts
 package.json

API Reference

Account Methods

await ig.login(useEncryption = true)
await ig.logout()
await ig.getAccounts()
await ig.switchAccount(accountId)
await ig.getAccountActivity(options)

##…