FXapis/fxapis-claude-plugins

Website · Docs · MCP guide · Status · Support
This is the plugin marketplace for fxapis, the hosted MetaTrader 5 API. Its one plugin, fxapis, connects Claude Code to the fxapis MCP server, teaches Claude how to trade MT5 carefully, and adds a hook that makes you confirm every trade and refuses live accounts until you allow them.
text
/plugin marketplace add FXapis/fxapis-claude-plugins
/plugin install fxapis@fxapis
> [!WARNING]
> Orders placed through fxapis are real orders at your broker. On a live account they are real money. Start with a broker demo account, sign in read-only first, and read the safety model before you let Claude trade.
## Table of contents
Quick start
What's inside
How sign-in works
Safety model
Configuration
Example prompts
Use it outside Claude Code
Troubleshooting
Development
Related fxapis repositories
Contributing
Support
License
## Quick start
You need Claude Code and an fxapis account with at least one MT5 account connected in the console. Connecting an MT5 account takes its broker password, so it is done in the console and never through Claude.
1. Add the marketplace and install the plugin. Inside Claude Code:
text
/plugin marketplace add FXapis/fxapis-claude-plugins
/plugin install fxapis@fxapis
Or from your shell:
bash
claude plugin marketplace add FXapis/fxapis-claude-plugins
claude plugin install fxapis@fxapis
2. Sign in. Ask for something that needs fxapis, such as /fxapis:status. The first tool call opens fxapis's sign-in page in your browser. Approve read access, and turn on trading only for the accounts you want.
3. Check your accounts.
text
/fxapis:status
/fxapis:positions
To update later, run /plugin marketplace update fxapis.
## What's inside
| Component | Name | What it does |
| MCP server | fxapis → https://api.fxapis.com/mcp | Accounts, positions, orders, deals, quotes, market hours, margin and profit calculations, and trading tools. Streamable HTTP, with OAuth sign-in or an optional API key. Tool reference. |
| Skill | trading-mt5-safely | Demo before live; one explicit yes per trade; a fresh idempotency key per action; never resending an unresolved order; checking the market is open; sizing against free margin; reducing risk first in a drawdown. References cover the order lifecycle, multi-account orders and every error code. |
| Command | /fxapis:status | Your accounts in one table (label, login, server, environment, state), and what to fix for any account that needs you. Calls no tool that trades. |
| Command | /fxapis:positions | Open positions across every ready account, with balance, equity and P/L per account and in total per currency. Calls no tool that trades. |
| Command | /fxapis:connect-help | Signing in, live trading, API keys and revoking access, explained without calling any tool. |
| Hook | PreToolUse → confirm-trade.mjs | Asks you before every fxapis trade, even in auto-accept mode, and refuses trades on live accounts while allowLiveTrading is off. See Safety model. |
text
├── .claude-plugin/marketplace.json # the "fxapis" marketplace
└── plugins/fxapis/
├── .claude-plugin/plugin.json # manifest and userConfig
├── .mcp.json # the fxapis MCP server
├── commands/ # status, positions, connect-help