Skip to main content
Glama
Poloniex MCP

Poloniex MCP

by salleh

poloniex-mcp

CI Release License: MIT Node.js TypeScript Model Context Protocol Sponsor Buy Me a Coffee

A local Model Context Protocol (MCP) server that exposes the Poloniex spot exchange to any MCP client (e.g. Claude Desktop). Built in TypeScript on the official @modelcontextprotocol/sdk high-level McpServer API, communicating over stdio.

Tools

All 35 tools are read-only (GET endpoints) — this server never places, modifies, or cancels orders. Paths and parameters are validated against the official Poloniex Python and Java SDKs and the REST docs.

Public tools need no credentials; authenticated tools require a Poloniex API key and secret (see Credentials).

Public — market data

Tool

Endpoint

Description

get_ticker

/markets/{symbol}/ticker24h

24h ticker (last, high, low, volume). Omit symbol for all.

get_orderbook

/markets/{symbol}/orderBook

Order book depth (bids/asks); limit, scale.

get_price

/markets/{symbol}/price

Latest trade price. Omit symbol for all.

get_mark_price

/markets/{symbol}/markPrice

Current mark price. Omit symbol for all.

get_mark_price_components

/markets/{symbol}/markPriceComponents

Components used to derive a symbol's mark price.

get_candles

/markets/{symbol}/candles

OHLC candles; interval (required), limit, time window.

get_market_trades

/markets/{symbol}/trades

Recent public trades; limit.

get_collateral_info

/markets/{currency}/collateralInfo

Margin collateral info. Omit currency for all.

get_borrow_rates_info

/markets/borrowRatesInfo

Borrow rates for all tiers and currencies.

Public — reference data

Tool

Endpoint

Description

get_symbols

/markets/{symbol}

Trading symbols and trade-limit info. Omit symbol for all.

get_currencies

/currencies

Supported currencies and networks; v2, includeMultiChainCurrencies.

get_timestamp

/timestamp

Current Poloniex server time.

Authenticated — account

Tool

Endpoint

Description

get_balances

/accounts/balances

Account balances; accountType.

get_account_info

/accounts

Ids, types, and state for all of the caller's accounts.

get_account_activity

/accounts/activity

Airdrops, rebates, staking, adjustments; rich filters.

get_fee_info

/feeinfo

Trading fee rates and related fee info.

get_interest_history

/accounts/interest/history

Margin/lending interest history.

get_transfer_records

/accounts/transfer

Transfers between the caller's accounts.

Authenticated — wallets

Tool

Endpoint

Description

get_deposit_addresses

/wallets/addresses

Deposit addresses. Omit currency for all.

get_wallet_activity

/wallets/activity

Deposit/withdrawal/adjustment activity; start+end required.

Authenticated — orders

Tool

Endpoint

Description

get_open_orders

/orders

Active (open) orders, with optional filters.

get_order

/orders/{id}

A single order by order id or client order id (cid:).

get_orders_history

/orders/history

Historical (closed/canceled) orders, with filters.

get_order_trades

/orders/{id}/trades

Trades that filled a specific order (order id only).

get_trade_history

/trades

Account trade history across orders; symbols, filters.

get_kill_switch_status

/orders/killSwitchStatus

Current status of the account's order kill switch.

Authenticated — smart orders

Tool

Endpoint

Description

get_smart_open_orders

/smartorders

Active (pending) smart orders (stop / stop-limit).

get_smart_order

/smartorders/{id}

A single smart order by order id or client order id.

get_smart_orders_history

/smartorders/history

Historical (triggered/canceled) smart orders, with filters.

Authenticated — margin

Tool

Endpoint

Description

get_account_margin

/margin/accountMargin

Margin info (equity, margin balance, available margin).

get_borrow_status

/margin/borrowStatus

Borrow status per currency. Omit currency for all.

get_max_size

/margin/maxSize

Max/available buy/sell size for a symbol.

Authenticated — subaccounts

Tool

Endpoint

Description

get_subaccounts

/subaccounts

Accounts within the caller's account group.

get_subaccount_balances

/subaccounts/balances

Balances by currency and account type per account.

get_subaccount_transfer_records

/subaccounts/transfer

Transfer records among accounts in the group, with filters.

Symbols use Poloniex format, e.g. BTC_USDT (input is normalized, so btc_usdt also works). Subaccount and primary-only endpoints require the appropriate account permissions on your API key.

Related MCP server: coinex-mcp-server

Requirements

  • Node.js 24+ (uses global fetch, AbortSignal.timeout, and node:crypto).

Project structure

src/
  index.ts            # entry point: loads config, starts stdio transport
  server.ts           # builds the McpServer and registers tools
  config.ts           # env configuration, validated with Zod
  tools/
    index.ts          # registerTools(): wires per-domain tool groups
    shared.ts         # shared helpers (result wrapping, normalization, query builders)
    market.ts         # public market-data tools
    reference.ts      # public reference-data tools (symbols, currencies, timestamp)
    account.ts        # authenticated account tools
    wallets.ts        # authenticated wallet read tools
    orders.ts         # authenticated order read tools
    smartorders.ts    # authenticated smart-order read tools
    margin.ts         # authenticated margin read tools
    subaccounts.ts    # authenticated subaccount read tools
  poloniex/
    client.ts         # typed HTTP client (timeout + error handling)
    auth.ts           # HMAC-SHA256 request signing
test/
  unit.test.ts        # auth signing + HTTP client unit tests
  server.test.ts      # in-memory MCP integration tests
  market.test.ts      # public market/reference tool tests
  account.test.ts     # account & wallet tool tests
  orders.test.ts      # order & smart-order tool tests
  margin.test.ts      # margin & subaccount tool tests

Install & build

npm install
npm run build

Scripts

Script

Purpose

npm run build

Compile TypeScript to dist/.

npm start

Run the compiled server (dist/index.js).

npm run dev

Run the server from source via tsx.

npm test

Run the Vitest suite.

npm run test:coverage

Run tests with a coverage report.

npm run typecheck

Type-check without emitting.

npm run format

Format the codebase with Prettier.

Credentials

The public market- and reference-data tools need no credentials. For the authenticated tools (account, wallets, orders, smart orders, margin, and subaccounts), set your Poloniex API key and secret:

  • POLONIEX_API_KEY

  • POLONIEX_API_SECRET

Optional overrides: POLONIEX_BASE_URL (default https://api.poloniex.com), POLONIEX_TIMEOUT_MS (default 10000). Copy .env.example to .env for local development.

Requests are signed with HMAC-SHA256 (base64), per the Poloniex api.poloniex.com REST specification, using the key / signature / signTimestamp headers.

Security: never commit your API key/secret. Keep them in the MCP client's env block (below) or a git-ignored .env. A read-only API key is recommended since this server never places trades.

Use with Claude Desktop

Build first (npm run build), then add the following to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) and restart Claude Desktop:

{
  "mcpServers": {
    "poloniex": {
      "command": "node",
      "args": ["/absolute/path/to/poloniex-mcp/dist/index.js"],
      "env": {
        "POLONIEX_API_KEY": "your-api-key-here",
        "POLONIEX_API_SECRET": "your-api-secret-here"
      }
    }
  }
}

Omit the env block if you only want the public tools.

Versioning

This project follows Semantic Versioning (MAJOR.MINOR.PATCH), starting at 0.1.0. While on 0.x, the API is considered unstable and minor versions may include breaking changes.

  • PATCH — backwards-compatible bug fixes.

  • MINOR — backwards-compatible functionality (e.g. a new tool).

  • MAJOR — incompatible changes (reserved for 1.0.0 and beyond).

Record every change in CHANGELOG.md under [Unreleased], then on release bump the version with npm version <patch|minor|major> (which updates package.json and creates a vX.Y.Z git tag) and move the notes under the new version heading.

License

MIT © Sallehuddin Abdul Latif

Available Tools

35 tools
get_account_activityGet Account ActivityB

Fetch account activity such as airdrops, rebates, staking, and adjustments, with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: from, limit, endTime, currency, +3 more.

get_account_infoGet Account InfoA

Fetch account information (ids, types, and state) for all of the caller's accounts. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: no named parameters.

get_account_marginGet Account MarginA

Fetch the account's margin information (equity, margin balance, and available margin). Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: accountType.

get_balancesGet BalancesA

Fetch authenticated account balances from Poloniex. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: accountType.

get_borrow_rates_infoGet Borrow Rates InfoA

Fetch borrow rates for all tiers and currencies. Public — no credentials required.

Inputs: no named parameters.

get_borrow_statusGet Borrow StatusA

Fetch the borrow status (borrowed amounts, rates, and available amounts) for margin currencies. Omit currency for all. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: currency.

get_candlesGet CandlesA

Fetch OHLC candlestick data for a symbol at a given interval. Public — no credentials required.

Inputs: symbol (required), interval (required), limit, endTime, +1 more.

get_collateral_infoGet Collateral InfoA

Fetch margin collateral information. Omit currency for all currencies, or pass one for a single currency. Public — no credentials required.

Inputs: currency.

get_currenciesGet CurrenciesA

Fetch supported currencies and their chain/network details. Omit currency for all currencies. Set v2 for the v2 response format. Public — no credentials required.

Inputs: v2, currency, includeMultiChainCurrencies.

get_deposit_addressesGet Deposit AddressesA

Fetch deposit addresses for the account. Omit currency for all currencies, or pass one for a single currency. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: currency.

get_fee_infoGet Fee InfoA

Fetch the caller's trading fee rates and related fee information. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: no named parameters.

get_interest_historyGet Interest HistoryB

Fetch the account's interest history (margin/lending). Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: from, limit, endTime, direction, +1 more.

get_kill_switch_statusGet Kill Switch StatusA

Fetch the current status of the account's order kill switch. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: no named parameters.

get_market_tradesGet Market TradesA

Fetch recent public trades for a symbol. Public — no credentials required.

Inputs: symbol (required), limit.

get_mark_priceGet Mark PriceA

Fetch the current mark price. Omit symbol for every symbol, or pass one for a single market. Public — no credentials required.

Inputs: symbol.

get_mark_price_componentsGet Mark Price ComponentsA

Fetch the components used to derive a symbol's mark price. Public — no credentials required.

Inputs: symbol (required).

get_max_sizeGet Max Buy/Sell SizeA

Fetch the maximum and available buy/sell amounts for a symbol on margin. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: symbol (required).

get_open_ordersGet Open OrdersA

Fetch active (open) orders for the account. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: from, side, limit, symbol, +2 more.

get_orderGet OrderA

Fetch a single order by its order id or client order id (provide exactly one). Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: id, clientOrderId.

get_orderbookGet Order BookA

Fetch order book depth (bids and asks) for a Poloniex spot symbol. Public — no credentials required.

Inputs: symbol (required), limit, scale.

get_orders_historyGet Orders HistoryA

Fetch historical (closed/canceled) orders with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: from, side, type, limit, +7 more.

get_order_tradesGet Order TradesA

Fetch the trades that filled a specific order, by order id. Client order id is not supported by this endpoint. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: id (required).

get_priceGet PriceA

Fetch the latest trade price. Omit symbol for every symbol, or pass one for a single market. Public — no credentials required.

Inputs: symbol.

get_smart_open_ordersGet Open Smart OrdersA

Fetch active (pending) smart orders (stop / stop-limit) for the account. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: from, side, limit, symbol, +1 more.

get_smart_orderGet Smart OrderA

Fetch a single smart order by its order id or client order id (provide exactly one). Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: id, clientOrderId.

get_smart_orders_historyGet Smart Orders HistoryA

Fetch historical (triggered/canceled) smart orders with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: from, side, type, limit, +7 more.

get_subaccount_balancesGet Subaccount BalancesA

Fetch balances by currency and account type (SPOT and FUTURES) for each account in the account group. Only functional for a primary account. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: no named parameters.

get_subaccountsGet SubaccountsA

Fetch all accounts within the caller's account group (primary and subaccounts). Only functional for a primary account. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: no named parameters.

get_subaccount_transfer_recordsGet Subaccount Transfer RecordsA

Fetch transfer records among accounts in the account group, with optional filters. Max interval between startTime and endTime is 6 months; without them, the last 7 days are returned. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: from, limit, endTime, currency, +6 more.

get_symbolsGet SymbolsA

Fetch trading symbols and their trade-limit information. Omit symbol for all symbols, or pass one for a single market. Public — no credentials required.

Inputs: symbol.

get_tickerGet TickerA

Fetch 24h ticker data (last price, high, low, volume). Omit symbol for every symbol, or pass one for a single market. Public — no credentials required.

Inputs: symbol.

get_timestampGet Server TimestampA

Fetch the current Poloniex server time. Public — no credentials required.

Inputs: no named parameters.

get_trade_historyGet Trade HistoryA

Fetch the account's trade history across orders, with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: from, limit, endTime, symbols, +2 more.

get_transfer_recordsGet Transfer RecordsA

Fetch records of transfers between the caller's accounts (e.g. spot <-> futures), with optional filters. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: from, limit, endTime, currency, +2 more.

get_wallet_activityGet Wallet ActivityA

Fetch deposit and withdrawal activity within a time window. Both start and end are required. Requires POLONIEX_API_KEY and POLONIEX_API_SECRET in the environment.

Inputs: end (required), start (required), activityType.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 35 tools

    Disambiguation4/5

    Each getter targets a distinct resource, and the descriptions clarify public vs. authenticated data. The main overlap is get_price vs. get_ticker, both of which return a latest price, though ticker adds 24h stats. A few account-related getters could require careful reading but are conceptually separate.

    Naming Consistency5/5

    All tools use a consistent get_<resource> snake_case pattern, which makes the family easy to recognize. The only minor variation is pluralization, but it follows the natural noun being accessed.

    Tool Count2/5

    35 tools is excessive for a single MCP server and beyond the 25-tool threshold where agent tool selection suffers. Even though each getter maps to a distinct endpoint, grouping them into market-data, account, orders, and margin servers would be cleaner.

    Completeness2/5

    The set is entirely read-only: there are no create/cancel order, place trade, transfer, or withdrawal operations. This leaves major dead ends for a general Poloniex exchange workflow, even though market data and account-read coverage is broad.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers