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
- Initialize configuration:
- 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
- Test connection:
- Start MCP server for AI tools:
🎯 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)
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"
}
}
}
}
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"
}
}
}
}
Account Management (5)
ig_login - Authenticate with IGig_logout - End sessionig_get_accounts - List all accountsig_switch_account - Change active accountig_get_account_activity - View account history
Position Management (5)
ig_get_positions - View open positionsig_create_position - Open new positionig_update_position - Modify positionig_close_position - Close specific positionig_close_all_positions - Close all positions
Order Management (3)
ig_get_working_orders - View pending ordersig_create_working_order - Place new orderig_delete_working_order - Cancel order
Market Data (4)
ig_search_markets - Search tradeable marketsig_get_market_details - Get market infoig_get_historical_prices - Historical dataig_get_client_sentiment - Market sentiment
Watchlists (4)
ig_get_watchlists - View all watchlistsig_get_watchlist - Get specific watchlistig_create_watchlist - Create watchlistig_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.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - 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