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 at my.xbtfx.com and manage API keys at console.xbtfx.com.

Available Skills

Skill	Type	Description
Trading	Read/Write	Open, close, modify, reverse, and close-by positions
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

git clone https://github.com/XBTFX/xbtfx-skills-hub.git
export XBTFX_API_KEY="xbtfx_live_your_key_here"

# Give Claude Code the trading skill
claude --skill ./skills/xbtfx/xbtfx-trading/SKILL.md

Or use the MCP Server for automatic tool discovery:

claude mcp add xbtfx-trading -e XBTFX_API_KEY=your_key -- npx @xbtfx/mcp-trading

Works With

Platform	How to use
Claude Code	`--skill SKILL.md` 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?

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

skills/xbtfx/
  xbtfx-trading/      # Open, close, modify, reverse positions
  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 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.