Skip to main content
Glama

IG Trading MCP

by kea0811
npmGitHub
JavaScript
7
1
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

🚀 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

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

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Enables AI assistants to interact with IG Trading API for forex, indices, and commodities trading. Provides 21 tools for account management, position trading, order placement, market data analysis, and watchlist management.

  1. ✨ Features
    1. 🚀 Quick Start
      1. Install & Run with npx (no installation needed)
      2. Basic Setup
    2. 🎯 Usage Examples
      1. Command Line Interface
      2. As a Node.js Library
    3. 🤖 AI Integration (MCP)
      1. Configure with Claude Desktop
      2. Configure with Cursor
      3. Available MCP Tools (21)
    4. 🔒 Security Features
      1. 📁 Project Structure
        1. 🛠️ API Reference
          1. Account Methods
          2. Trading Methods
          3. Order Methods
          4. Market Data Methods
        2. 📋 Requirements
          1. 🧪 Testing
            1. 🤝 Contributing
              1. 🏗️ Built On
                1. 📄 License
                  1. ⚠️ Disclaimer
                    1. 🔗 Resources
                      1. 📞 Support

                        Related MCP Servers

                        • DeFi Trading Agent MCP Server

                          edkdev
                          A
                          security
                          F
                          license
                          A
                          quality
                          Transforms AI assistants into autonomous crypto trading agents with real-time market analysis, portfolio management, and trade execution across 17+ blockchains.
                          Last updated -
                          32
                          6
                          17

                        • Tiger MCP

                          luxiaolei
                          -
                          security
                          F
                          license
                          -
                          quality
                          Enables trading and market analysis through Tiger Brokers API integration. Provides real-time market data, portfolio management, order execution, and technical analysis tools with a comprehensive web dashboard for monitoring.
                          Last updated -
                          1

                        • QuantConnect MCP Server

                          i-dream-of-ai
                          -
                          security
                          A
                          license
                          -
                          quality
                          Enables AI assistants to interact with the QuantConnect cloud platform for algorithmic trading. Supports creating and managing trading strategies, running backtests, deploying live algorithms, and performing comprehensive trading operations through the QuantConnect API.
                          Last updated -
                          Apache 2.0
                          • Linux

                        • Interactive Brokers MCP Server

                          code-rabi
                          A
                          security
                          A
                          license
                          A
                          quality
                          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.
                          Last updated -
                          6
                          21
                          6
                          MIT License
                          • Linux
                          • Apple

                        View all related MCP servers

                        New MCP Servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/kea0811/ig-trading-mcp'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server