Poloniex MCP
The Poloniex MCP server lets you query market data and account information from the Poloniex spot exchange. It is read-only and never places or cancels trades.
get_ticker— Fetch 24-hour ticker data (last price, high, low, volume) for any spot trading pair (e.g.,BTC_USDT). No credentials required.get_orderbook— Retrieve order book depth (bids and asks) with optional limit on price levels (up to 150 per side) and price aggregation scale. No credentials required.get_balances— Access authenticated account balances, optionally filtered by account type (e.g.,SPOTorFUTURES). Requires API key and secret.(not in schema but noted in README)
get_open_orders— View active/open orders with optional filters. Requires API key and secret.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Poloniex MCPwhat's the current BTC_USDT ticker?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
poloniex-mcp
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 |
|
| 24h ticker (last, high, low, volume). Omit symbol for all. |
|
| Order book depth (bids/asks); |
|
| Latest trade price. Omit symbol for all. |
|
| Current mark price. Omit symbol for all. |
|
| Components used to derive a symbol's mark price. |
|
| OHLC candles; |
|
| Recent public trades; |
|
| Margin collateral info. Omit currency for all. |
|
| Borrow rates for all tiers and currencies. |
Public — reference data
Tool | Endpoint | Description |
|
| Trading symbols and trade-limit info. Omit symbol for all. |
|
| Supported currencies and networks; |
|
| Current Poloniex server time. |
Authenticated — account
Tool | Endpoint | Description |
|
| Account balances; |
|
| Ids, types, and state for all of the caller's accounts. |
|
| Airdrops, rebates, staking, adjustments; rich filters. |
|
| Trading fee rates and related fee info. |
|
| Margin/lending interest history. |
|
| Transfers between the caller's accounts. |
Authenticated — wallets
Tool | Endpoint | Description |
|
| Deposit addresses. Omit currency for all. |
|
| Deposit/withdrawal/adjustment activity; |
Authenticated — orders
Tool | Endpoint | Description |
|
| Active (open) orders, with optional filters. |
|
| A single order by order id or client order id ( |
|
| Historical (closed/canceled) orders, with filters. |
|
| Trades that filled a specific order (order id only). |
|
| Account trade history across orders; |
|
| Current status of the account's order kill switch. |
Authenticated — smart orders
Tool | Endpoint | Description |
|
| Active (pending) smart orders (stop / stop-limit). |
|
| A single smart order by order id or client order id. |
|
| Historical (triggered/canceled) smart orders, with filters. |
Authenticated — margin
Tool | Endpoint | Description |
|
| Margin info (equity, margin balance, available margin). |
|
| Borrow status per currency. Omit currency for all. |
|
| Max/available buy/sell size for a |
Authenticated — subaccounts
Tool | Endpoint | Description |
|
| Accounts within the caller's account group. |
|
| Balances by currency and account type per account. |
|
| 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, andnode: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 testsInstall & build
npm install
npm run buildScripts
Script | Purpose |
| Compile TypeScript to |
| Run the compiled server ( |
| Run the server from source via |
| Run the Vitest suite. |
| Run tests with a coverage report. |
| Type-check without emitting. |
| 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_KEYPOLONIEX_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
envblock (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.0and 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
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for Binance USDT-M Futures trading — exposes tools for market data, account state, order management, and position/margin control.Last updated236Apache 2.0

coinex-mcp-serverofficial
Alicense-qualityFmaintenanceAn MCP server for interacting with the CoinEx cryptocurrency exchange, enabling market data queries and authenticated trading operations via AI agents.Last updatedApache 2.0- Flicense-qualityDmaintenancePython-based MCP server that provides real-time and historical cryptocurrency data from 100+ exchanges via CCXT, with tools for tickers, OHLCV, markets, and order books.Last updated1
- Alicense-qualityDmaintenanceBrowser-automated MCP server for Coinbase crypto exchange, enabling live prices, portfolio management, transaction history, and trading.Last updated14MIT
Related MCP Connectors
Open-source MCP server for Zerodha Kite Connect. Portfolio, market data, backtesting, alerts.
Crypto Feeds MCP.
A basic MCP server to operate on the Postman API.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/salleh/poloniex-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server