Skip to content

Skills Hub

The XBTFX Skills Hub gives AI agents the ability to trade forex, crypto, metals, indices, stocks, and energies on your XBTFX MetaTrader 5 account. Each skill is a structured SKILL.md file containing endpoint documentation, parameter schemas, example requests, and behavioral guidelines.

GitHub: XBTFX/xbtfx-skills-hub

Create an XBTFX account and a Pro trading account at portal.xbtfx.com, then manage API keys in the portal’s API Console.

SkillTypeDescription
TradingRead/WriteOpen, close, modify, reverse, and close-by positions; place, modify, and cancel pending orders
AccountRead-onlyBalance, equity, margin, leverage, positions, orders, history
Market DataRead-onlySymbol specs, swap rates, margin requirements, live bid/ask
WebSocketRead-onlyReal-time streaming quotes via wss://ws.xbtfx.com/v1/ws
Terminal window
git clone https://github.com/XBTFX/xbtfx-skills-hub.git
cd xbtfx-skills-hub
# Install the trading skill in your personal Claude Code skills folder
mkdir -p ~/.claude/skills
cp -r skills/xbtfx/xbtfx-trading ~/.claude/skills/
# Start Claude Code with your key in the environment
export XBTFX_API_KEY="xbtfx_live_your_key_here"
claude

Claude Code reads skills from ~/.claude/skills/, or from .claude/skills/ inside a project if you want a skill available in that project only. Start a new session after copying a skill in. Claude uses the skill when a request matches its description, and you can call it directly with /xbtfx-trading. Install the other skills the same way.

Or use the MCP Server for automatic tool discovery:

Terminal window
claude mcp add --transport stdio --env XBTFX_API_KEY=your_key xbtfx-trading -- npx -y @xbtfx/mcp-trading
PlatformHow to use
Claude CodeSkill folder in ~/.claude/skills/ or MCP server
Claude DesktopMCP server via claude_desktop_config.json
CursorMCP server via .cursor/mcp.json
OpenAI CodexMCP server via codex mcp add
WindsurfMCP server via settings
LangChain / CrewAIIngest SKILL.md as tool description
Custom agentsParse structured markdown or use MCP

A skill is a structured markdown file with YAML frontmatter and human-readable instructions. It provides everything an AI agent needs to use a specific set of API endpoints:

  • Frontmatter: name, description, required environment variables
  • When to use / When not to use: helps agents select the right skill
  • Endpoint reference: methods, paths, parameters, response schemas
  • Code examples: ready-to-use request/response pairs
  • Agent guidelines: behavioral rules for safe and correct operation
skills/xbtfx/
xbtfx-trading/ # Positions and pending orders
xbtfx-account/ # Balance, equity, margin, trade history
xbtfx-market-data/ # Symbols, contract specs, live quotes
xbtfx-websocket/ # Real-time price feeds and position updates

Each directory contains a SKILL.md file that can be loaded independently by any agent framework.

Skills HubMCP Server
FormatMarkdown filesnpm package
IntegrationAny agent frameworkMCP-compatible clients
Tool discoveryManual (point agent at file)Automatic
Best forLangChain, CrewAI, custom agentsClaude Code, Cursor, Codex

Both provide access to the same XBTFX Trading API. Use whichever fits your agent framework.