XTBApiServer

What is XTBApiServer?

XTBApiServer is an MCP server that exposes the XTB API using the @sharplygroup/xtb-api-js library. It enables interaction with an XTB trading account through the Model Context Protocol, providing programmatic access to account data, market information, and trading operations.

How to use XTBApiServer?

Clone the repository, install dependencies with npm install, and create a .env file with your XTB credentials (DEMO_ACCOUNT, USER_ID, PASSWORD). Build the TypeScript code with npm run build, start the server with node build/index.js, and connect via an MCP client (e.g., MCP Inspector) using stdio transport.

Key features of XTBApiServer

• Account information and margin level retrieval
• Commission and margin calculation tools
• Market data, charts, and tick prices
• News and server time/version queries
• Symbol details and all available symbols
• Trade history, records, and status checks
• Trade transaction execution and status monitoring

Use cases of XTBApiServer

• Automate retrieval of account balance and leverage
• Calculate expected margin and profit for trades
• Fetch real-time and historical market data
• Manage trade transactions programmatically
• Integrate XTB data into AI assistants or automation tools

FAQ from XTBApiServer

What are the prerequisites?

You need Node.js version 16 or higher, npm, and an XTB trading account.

How do I configure credentials?

Create a .env file in the project directory with DEMO_ACCOUNT, USER_ID, and PASSWORD. Set DEMO_ACCOUNT to true for demo accounts or false for live accounts.

How do I connect an MCP client?

Use the MCP Inspector with stdio transport. Install it globally (npm install -g @modelcontextprotocol/inspector), then run npx @modelcontextprotocol/inspector node build/index.js.

Is this server safe for live trading?

The server is provided as an example. Use it at your own risk; ensure you understand the XTB API and associated risks before using with a live account.