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.
Available Skills
Section titled “Available Skills”| Skill | Type | Description |
|---|---|---|
| Trading | Read/Write | Open, close, modify, reverse, and close-by positions; place, modify, and cancel pending orders |
| Account | Read-only | Balance, equity, margin, leverage, positions, orders, history |
| Market Data | Read-only | Symbol specs, swap rates, margin requirements, live bid/ask |
| WebSocket | Read-only | Real-time streaming quotes via wss://ws.xbtfx.com/v1/ws |
Quick Start
Section titled “Quick Start”git clone https://github.com/XBTFX/xbtfx-skills-hub.gitcd xbtfx-skills-hub
# Install the trading skill in your personal Claude Code skills foldermkdir -p ~/.claude/skillscp -r skills/xbtfx/xbtfx-trading ~/.claude/skills/
# Start Claude Code with your key in the environmentexport XBTFX_API_KEY="xbtfx_live_your_key_here"claudeClaude 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:
claude mcp add --transport stdio --env XBTFX_API_KEY=your_key xbtfx-trading -- npx -y @xbtfx/mcp-tradingWorks With
Section titled “Works With”| Platform | How to use |
|---|---|
| Claude Code | Skill folder in ~/.claude/skills/ or MCP server |
| Claude Desktop | MCP server via claude_desktop_config.json |
| Cursor | MCP server via .cursor/mcp.json |
| OpenAI Codex | MCP server via codex mcp add |
| Windsurf | MCP server via settings |
| LangChain / CrewAI | Ingest SKILL.md as tool description |
| Custom agents | Parse structured markdown or use MCP |
What Is a Skill?
Section titled “What Is a Skill?”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
Repository Structure
Section titled “Repository Structure”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 updatesEach directory contains a SKILL.md file that can be loaded independently by any agent framework.
Skills vs MCP Server
Section titled “Skills vs MCP Server”| Skills Hub | MCP Server | |
|---|---|---|
| Format | Markdown files | npm package |
| Integration | Any agent framework | MCP-compatible clients |
| Tool discovery | Manual (point agent at file) | Automatic |
| Best for | LangChain, CrewAI, custom agents | Claude Code, Cursor, Codex |
Both provide access to the same XBTFX Trading API. Use whichever fits your agent framework.