Overview
What is coinone-mcp-server?
This is a Model Context Protocol (MCP) server that wraps the Coinone cryptocurrency exchange OpenAPI. It provides tools for retrieving market data, checking account balances, placing orders, and canceling orders, enabling AI assistants to interact with the Coinone exchange.
How to use coinone-mcp-server?
Set up a Python virtual environment with uv venv, activate it, and install the package with uv pip install -e .. Create a .env file with COINONE_ACCESS_TOKEN and COINONE_SECRET_KEY. Then configure the MCP client with the JSON snippet provided, pointing to the virtual environment's Python binary and the main.py script.
Key features of coinone-mcp-server
- Place orders on Coinone (
place_order) - Retrieve the current orderbook for a market (
get_orderbook) - Retrieve all Coinone balances (
get_balance) - List open (active) orders (
get_active_orders) - Cancel an existing order (
cancel_order)
Use cases of coinone-mcp-server
- An AI assistant fetching real-time orderbook data before suggesting trades.
- Automating portfolio balance checks through natural language.
- Placing limit or market orders directly from a chat interface.
- Cancelling open orders without manually logging into the exchange.
- Monitoring active orders and their statuses via conversational queries.
FAQ from coinone-mcp-server
What dependencies does coinone-mcp-server require?
It requires Python and the uv package manager. The exact Python version is not specified in the README.
How are API keys handled?
Coinone API credentials are supplied via environment variables COINONE_ACCESS_TOKEN and COINONE_SECRET_KEY in a .env file. The README warns never to expose them in public repositories.
Can coinone-mcp-server execute live trades?
Yes, the server is capable of executing live trades. The README explicitly cautions users to exercise care when using it.
How is the server connected to an MCP client?
It uses standard input/output (stdio) transport. The client configuration points to the Python interpreter and the main.py script.
What data does coinone-mcp-server access?
It accesses market data (orderbook), account balances, and order status information from the Coinone exchange. All data lives on Coinone’s servers; the MCP server acts as a proxy.
