rikitonoto avatar

GMO Coin FX MCP Server

rikitonoto/gmocoin-fx-mcp

Connects Claude to the GMO Coin FX trading API so you can place orders, manage positions, and query account balances directly from conversations. Wraps the full suite of GMO operations: market and limit orders, IFD and IFDOCO combos, bulk cancellations, active order lookups, execution history, and open position monitoring. Ships with safety guards like size limits, symbol whitelists, and client order ID prefixes to scope what Claude can touch. Account assets surface as a read-only MCP resource. Runs over stdio by default with a Docker image ready to go, or switch to HTTP if your setup needs it. Built for developers automating forex trades or building conversational interfaces over live FX positions.

tools
13
auth
Secret needed
transport
STDIO
env vars
5
last updated
May 21, 2026

Tools

13 tools

Public tool metadata for what this MCP can expose to an agent.

order_apiPlaces a new GMO Coin FX order.

Places a new GMO Coin FX order.

No parameter schema in public metadata yet.

close_order_apiPlaces a GMO Coin FX close order. Supports optional `size` or `settle_position` parameters.

Places a GMO Coin FX close order. Supports optional `size` or `settle_position` parameters.

No parameter schema in public metadata yet.

ifd_order_apiPlaces a GMO Coin FX IFD order using `symbol`, `client_order_id`, `first_side`, `first_execution_type`, `first_size`, `first_price`, `second_execution_type`, `second_size`, and `second_price`.

Places a GMO Coin FX IFD order using `symbol`, `client_order_id`, `first_side`, `first_execution_type`, `first_size`, `first_price`, `second_execution_type`, `second_size`, and `second_price`.

No parameter schema in public metadata yet.

ifdoco_order_apiPlaces a GMO Coin FX IFDOCO order using `symbol`, `client_order_id`, `first_side`, `first_execution_type`, `first_size`, `first_price`, `second_size`, `second_limit_price`, and `second_stop_price`.

Places a GMO Coin FX IFDOCO order using `symbol`, `client_order_id`, `first_side`, `first_execution_type`, `first_size`, `first_price`, `second_size`, `second_limit_price`, and `second_stop_price`.

No parameter schema in public metadata yet.

change_ifdoco_order_apiChanges prices for an existing GMO Coin FX IFDOCO order. Specify exactly one of `root_order_id` or `client_order_id`, plus at least one of `first_price`, `second_limit_price`, or `second_stop_price`.

Changes prices for an existing GMO Coin FX IFDOCO order. Specify exactly one of `root_order_id` or `client_order_id`, plus at least one of `first_price`, `second_limit_price`, or `second_stop_price`.

No parameter schema in public metadata yet.

change_ifd_order_apiChanges prices for an existing GMO Coin FX IFD order. Specify exactly one of `root_order_id` or `client_order_id`, plus at least one of `first_price` or `second_price`.

Changes prices for an existing GMO Coin FX IFD order. Specify exactly one of `root_order_id` or `client_order_id`, plus at least one of `first_price` or `second_price`.

No parameter schema in public metadata yet.

change_oco_order_apiChanges limit/stop prices for an existing GMO Coin FX OCO order.

Changes limit/stop prices for an existing GMO Coin FX OCO order.

No parameter schema in public metadata yet.

change_order_apiChanges the price of a GMO Coin FX normal order. Specify exactly one of `order_id` or `client_order_id`, plus `price`.

Changes the price of a GMO Coin FX normal order. Specify exactly one of `order_id` or `client_order_id`, plus `price`.

No parameter schema in public metadata yet.

cancel_orders_apiCancels up to 10 GMO Coin FX orders at once. Specify exactly one of `root_order_ids` or `client_order_ids`.

Cancels up to 10 GMO Coin FX orders at once. Specify exactly one of `root_order_ids` or `client_order_ids`.

No parameter schema in public metadata yet.

cancel_bulk_order_apiCancels GMO Coin FX orders in bulk by required `symbols` and optional `side` and `settle_type`. When `ORDER_SYMBOL_LIMITS` is configured, every requested symbol must be allowed.

Cancels GMO Coin FX orders in bulk by required `symbols` and optional `side` and `settle_type`. When `ORDER_SYMBOL_LIMITS` is configured, every requested symbol must be allowed.

No parameter schema in public metadata yet.

active_orders_apiRetrieves active GMO Coin FX orders. Supports optional `symbol`, `prev_id`, and `count` parameters. When `ORDER_CLIENT_ORDER_ID_PREFIX` is configured, only active orders whose `client_order_id` starts with that prefix are returned.

Retrieves active GMO Coin FX orders. Supports optional `symbol`, `prev_id`, and `count` parameters. When `ORDER_CLIENT_ORDER_ID_PREFIX` is configured, only active orders whose `client_order_id` starts with that prefix are returned.

No parameter schema in public metadata yet.

latest_executions_apiRetrieves the latest GMO Coin FX executions for a required `symbol` and optional `count`. When `ORDER_CLIENT_ORDER_ID_PREFIX` is configured, only executions whose `client_order_id` starts with that prefix are returned.

Retrieves the latest GMO Coin FX executions for a required `symbol` and optional `count`. When `ORDER_CLIENT_ORDER_ID_PREFIX` is configured, only executions whose `client_order_id` starts with that prefix are returned.

No parameter schema in public metadata yet.

open_positions_apiRetrieves all GMO Coin FX open positions. Supports an optional `symbol` parameter. When `ORDER_CLIENT_ORDER_ID_PREFIX` is configured, latest executions are used to return only positions whose opening `client_order_id` starts with that prefix.

Retrieves all GMO Coin FX open positions. Supports an optional `symbol` parameter. When `ORDER_CLIENT_ORDER_ID_PREFIX` is configured, latest executions are used to return only positions whose opening `client_order_id` starts with that prefix.

No parameter schema in public metadata yet.

Sponsors

Configuration

GMO_API_KEY*secret

GMO Coin FX API key.

GMO_SECRET_KEY*secret

GMO Coin FX secret key.

ORDER_SIZE_LIMIT

Optional maximum order size accepted by order-entry tools.

ORDER_SYMBOL_LIMITS

Optional comma-separated list of symbols accepted by order tools.

ORDER_CLIENT_ORDER_ID_PREFIX

Optional ASCII alphanumeric prefix for generated and filtered client order IDs.

Readme

gmocoin-mcp

MCP client registration

Register the server with an MCP client by using either stdio or HTTP. The local checkout example below uses /path/to/gmocoin-fx-mcp; replace it with the absolute path to this repository.

Recommended: Docker image from GHCR

The recommended setup is to run the published Docker image from GitHub Container Registry over stdio. Add the following entry to your MCP client configuration:

{
  "mcpServers": {
    "gmocoin-fx": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env",
        "GMO_API_KEY",
        "--env",
        "GMO_SECRET_KEY",
        "--env",
        "ORDER_SIZE_LIMIT",
        "--env",
        "ORDER_SYMBOL_LIMITS",
        "--env",
        "ORDER_CLIENT_ORDER_ID_PREFIX",
        "ghcr.io/rikitonoto/gmocoin-fx-mcp:latest"
      ],
      "env": {
        "GMO_API_KEY": "your-api-key",
        "GMO_SECRET_KEY": "your-secret-key",
        "ORDER_SIZE_LIMIT": "10000",
        "ORDER_SYMBOL_LIMITS": "USD_JPY,EUR_JPY",
        "ORDER_CLIENT_ORDER_ID_PREFIX": "mcp"
      }
    }
  }
}

View the full README on GitHub

Details

Repository
github.com/rikitonoto/gmocoin-fx-mcp
Category
Finance & Commerce
Package
ghcr.io/rikitonoto/gmocoin-fx-mcp:1.0.1
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Finance & Commerce MCP servers

View all
1rohith1125 avatarSentinel Execution Mcprohith1125/sentinel-execution-mcpAI-controlled algorithmic trading engine exposing 40 MCP tools across 9 namespaces.0stars
2sapph1re avatarFinData MCPsapph1re/findata-mcpStocks, fundamentals, FRED economics, SEC filings & crypto. x402 micropayments, $0.01/call.0stars
3seasonsagents-art avatarWebAZio.github.seasonsagents-art/webazSearch and compare products; authorized commerce workflows with compatible x402 wallets.0stars
4seungdori avatarTickscopeseungdori/tickscope-mcpReal-time, free crypto market data for any AI agent — via MCP.0stars
5severin2k avatarBlumen Komander Münchenseverin2k/blumen-komander-mcpFirst German florist with a public MCP server. Search bouquets and order flowers via AI in Munich.0stars
6singlishman avatarKerdos X402 Mcpsinglishman/kerdos-x402-mcpCrypto market intelligence MCP — pay-per-tool-call in USDC on Base via the x402 protocol.0stars