Skip to main content
Glama
IG Trading MCP
by kea0811

ig-trading-mcp

npm version Downloads License: MIT Node.js Version GitHub

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

Related MCP server: IBKR MCP Server

๐Ÿš€ 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)

Trading Methods

await ig.getPositions()
await ig.createPosition(ticket)
await ig.updatePosition(dealId, updates)
await ig.closePosition(dealId)
await ig.closeAllPositions()

Order Methods

await ig.getWorkingOrders()
await ig.createWorkingOrder(ticket)
await ig.deleteWorkingOrder(dealId)

Market Data Methods

await ig.searchMarkets(searchTerm)
await ig.getMarketDetails(epics)
await ig.getHistoricalPrices(epic, resolution, options)
await ig.getClientSentiment(marketIds)

๐Ÿ“‹ Requirements

  • Node.js 18.0.0 or higher

  • IG Trading Account (demo or live)

  • API Key from IG (get from My IG > Settings > API keys)

๐Ÿงช Testing

# Test connection
npm test

# Test with credentials
npm run test:account

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository

  2. Create your feature branch (git checkout -b feature/AmazingFeature)

  3. Commit your changes (git commit -m 'Add some AmazingFeature')

  4. Push to the branch (git push origin feature/AmazingFeature)

  5. Open a Pull Request

๐Ÿ—๏ธ Built On

This project is built on top of gfiocco/node-ig-api, enhancing it with:

  • Modern ES modules and async/await patterns

  • MCP (Model Context Protocol) server for AI integration

  • Enhanced security with RSA encryption

  • CLI interface for easy usage with npx

  • Comprehensive error handling and rate limiting

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

โš ๏ธ Disclaimer

This software is for educational purposes only. Trading CFDs carries risk and you could lose more than your initial deposit. Use at your own risk. The authors are not responsible for any financial losses incurred through use of this software.

๐Ÿ”— Resources

๐Ÿ“ž Support


Made with โค๏ธ for the trading community

Available Tools

21 tools
ig_add_to_watchlistC

Add an epic to a watchlist

Inputs: epic (required), watchlistId (required).

ig_close_all_positionsB

Close all open positions

Inputs: no named parameters.

ig_close_positionC

Close an open position

Inputs: dealId (required).

ig_create_positionC

Create a new trading position

Inputs: currencyCode (required), direction (required), epic (required), expiry (required), +8 more.

ig_create_watchlistC

Create a new watchlist

Inputs: name (required), epics.

ig_create_working_orderD

Create a working order

Inputs: currencyCode (required), direction (required), epic (required), expiry (required), +9 more.

ig_delete_working_orderC

Delete a working order

Inputs: dealId (required).

ig_get_account_activityC

Get account activity history

Inputs: detailed, from, pageSize, to.

ig_get_accountsB

Get list of all trading accounts

Inputs: no named parameters.

ig_get_client_sentimentC

Get client sentiment for markets

Inputs: marketIds (required).

ig_get_historical_pricesC

Get historical price data

Inputs: epic (required), resolution (required), from, max, +1 more.

ig_get_market_detailsC

Get detailed information about a market

Inputs: epics (required).

ig_get_positionsB

Get all open positions

Inputs: no named parameters.

ig_get_watchlistC

Get details of a specific watchlist

Inputs: watchlistId (required).

ig_get_watchlistsC

Get all watchlists

Inputs: no named parameters.

ig_get_working_ordersC

Get all working orders

Inputs: no named parameters.

ig_loginC

Login to IG Trading account

Inputs: apiKey, identifier, isDemo, password, +1 more.

ig_logoutB

Logout from IG Trading account

Inputs: no named parameters.

ig_search_marketsC

Search for tradeable markets

Inputs: searchTerm (required).

ig_switch_accountC

Switch to a different trading account

Inputs: accountId (required).

ig_update_positionC

Update stop/limit levels for an open position

Inputs: dealId (required), limitLevel, stopLevel, trailingStop, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    B3.1/5.0

    Scored across 21 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific resources and actions in the IG Trading domain. For example, create_position vs. update_position vs. close_position handle different stages of position lifecycle, while get_watchlist vs. get_watchlists differentiate singular vs. plural operations. No tools appear to overlap or cause confusion.

    Naming Consistency5/5

    All tools follow a consistent 'ig_verb_noun' pattern with snake_case throughout. The naming convention is highly predictable, making it easy to understand each tool's function at a glance. This uniformity supports clear agent selection and reduces cognitive load.

    Tool Count4/5

    With 21 tools, the count is slightly high but reasonable for a comprehensive trading platform covering accounts, positions, watchlists, orders, markets, and authentication. It provides full coverage without being excessively bloated, though it borders on the upper limit of typical well-scoped servers.

    Completeness5/5

    The toolset offers complete CRUD/lifecycle coverage for all core trading domain entities: positions (create, update, close, get), watchlists (create, add to, get, list), working orders (create, delete, get), accounts (get, switch, activity), and markets (search, details, prices, sentiment). Authentication (login/logout) is also included, leaving no obvious gaps for agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to interact with Interactive Brokers trading accounts to retrieve market data, check positions, and place trades. Includes pre-configured IB Gateway and handles OAuth authentication automatically.
      14
      161 npm
      228
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI models with secure access to Interactive Brokers trading data and functionality, enabling account management, market data retrieval, and trading operations through natural language interactions.
      18
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with Trading 212 investment accounts for portfolio tracking, account management, and real-time order execution. It supports managing investment pies, analyzing historical data, and monitoring market performance across multiple instrument types.
      23
      2
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Provides tools for interacting with Interactive Brokers Gateway to access market data, account summaries, and portfolio positions. It enables users to perform contract lookups, retrieve historical OHLCV bars, and view real-time quotes through natural language interfaces.
      6
      49 PyPI
      3
      PolyForm Noncommercial 1.0.0