GMO Coin FX MCP Server

io.github.RikitoNotoPublished by GitHub account RikitoNotov1.0.1Updated Nov 3, 2026

MCP server for GMO Coin FX trading, positions, executions, klines, and account balances.

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant place, change and cancel GMO Coin FX orders and read positions, executions and account balances through the GMO Coin API.

What you can do
  • Place new, close, IFD and IFDOCO orders on GMO Coin FX
  • Change prices on normal, IFD, IFDOCO and OCO orders
  • Cancel individual orders (up to 10 at once) or cancel in bulk by symbol
  • List active orders, latest executions and open positions, optionally filtered by client order ID prefix
  • Read account asset balances as a JSON resource
When to use it
Use it when you want an assistant to work with a GMO Coin FX account: checking balances, positions and executions, or drafting and submitting orders and price changes from a chat session. Optional size, symbol and client-order-ID limits make it easier to keep automated order entry within bounds.
Requirements
Runs locally over stdio, typically as the published Docker image (or from a local source checkout with uv); HTTP transport is also available. Requires a GMO Coin FX API key and secret key, passed as GMO_API_KEY and GMO_SECRET_KEY. Optional ORDER_SIZE_LIMIT, ORDER_SYMBOL_LIMITS and ORDER_CLIENT_ORDER_ID_PREFIX restrict order entry and filtering. Network access to the GMO Coin API is needed.
Before you install
The server holds trading credentials (GMO_API_KEY, GMO_SECRET_KEY) that can place, change and cancel real orders, so a mistake or a misread instruction can move money. Order tools write to a live account; consider setting ORDER_SIZE_LIMIT and ORDER_SYMBOL_LIMITS to cap exposure. The optional client-order-ID prefix also filters which orders, executions and positions are visible. Running over HTTP exposes the server on a network interface, so keep it local or protect it.

Installation

In SourceWeft

  1. Open GMO Coin FX MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

json
{  "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"      }    }  }}

Only GMO_API_KEY and GMO_SECRET_KEY are required. Remove optional environment variables when you do not need order-size, symbol, or client-order-id limits. The --env options pass those values from the MCP client process into the Docker container. Do not set MCP_TRANSPORT for stdio; the server uses stdio by default. The -i option is required because the MCP client communicates with the container over standard input/output.

Local source checkout

Use this setup when you want to run the server from a local checkout instead of the published image:

json
{  "mcpServers": {    "gmocoin-fx": {      "command": "uv",      "args": [        "--directory",        "/path/to/gmocoin-fx-mcp",        "run",        "src/main.py"      ],      "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"      }    }  }}

HTTP

Use HTTP when your MCP client supports remote or URL-based servers. Start the server:

bash
docker run --rm \  --env MCP_TRANSPORT=http \  --env MCP_HTTP_HOST=0.0.0.0 \  --env MCP_HTTP_PORT=8000 \  --env MCP_HTTP_PATH=/mcp \  --env GMO_API_KEY=your-api-key \  --env GMO_SECRET_KEY=your-secret-key \  -p 8000:8000 \  ghcr.io/rikitonoto/gmocoin-fx-mcp:latest

Then register the server URL in your MCP client:

text
http://localhost:8000/mcp

Environment variables

NameRequiredDescription
GMO_API_KEYYesGMO Coin FX API key.
GMO_SECRET_KEYYesGMO Coin FX secret key.
ORDER_SIZE_LIMITNoMaximum order size accepted by the order_api, close_order_api, ifd_order_api, and ifdoco_order_api tools.
ORDER_SYMBOL_LIMITSNoComma-separated list of symbols accepted by the order_api, close_order_api, ifd_order_api, ifdoco_order_api, and cancel_bulk_order_api tools.
ORDER_CLIENT_ORDER_ID_PREFIXNoASCII alphanumeric prefix used to auto-generate client_order_id for order_api, close_order_api, ifd_order_api, and ifdoco_order_api calls and to filter active_orders_api, latest_executions_api, and open_positions_api results. Must be 22 characters or fewer. The server appends a 14-digit timestamp suffix (yyyyMMddHHmmss) so the resulting ID stays within GMO Coin FX's 36-character limit.
MCP_TRANSPORTNoMCP transport to use. Defaults to stdio; set to http to listen over HTTP. sse and streamable-http are also accepted.
MCP_HTTP_HOSTNoHost/interface for HTTP transports. Defaults to 0.0.0.0.
MCP_HTTP_PORTNoPort for HTTP transports. Defaults to 8000.
MCP_HTTP_PATHNoOptional endpoint path for HTTP transports, such as /mcp.

Running over HTTP

The server still starts with the standard stdio MCP transport by default:

bash
uv run src/main.py

To expose the MCP server over HTTP, set MCP_TRANSPORT=http before starting it:

bash
MCP_TRANSPORT=http MCP_HTTP_HOST=0.0.0.0 MCP_HTTP_PORT=8000 uv run src/main.py

When running with Docker Compose, the compose file loads .env but does not force a transport. Leave MCP_TRANSPORT unset to use stdio, or set MCP_TRANSPORT=http in .env to use the published port 8000.

Tools

NameDescription
order_apiPlaces a new GMO Coin FX order.
close_order_apiPlaces a GMO Coin FX close order. Supports optional size or settle_position parameters.
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.
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.
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.
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.
change_oco_order_apiChanges limit/stop prices for an existing GMO Coin FX OCO order.
change_order_apiChanges the price of a GMO Coin FX normal order. Specify exactly one of order_id or client_order_id, plus price.
cancel_orders_apiCancels up to 10 GMO Coin FX orders at once. Specify exactly one of root_order_ids or client_order_ids.
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.
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.
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.
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.

Resources

URIDescription
gmocoin-fx://account/assetsRetrieves GMO Coin FX account asset balances as JSON. Asset balances are exposed as an MCP resource because they are read-only account state with a stable URI and no invocation parameters.

Source: README.md at commit 362c0ad

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts