Zebpay MCP Server

Production-ready TypeScript MCP (Model Context Protocol) server for Zebpay spot and futures APIs, using stdio transport only. Model Context Protocol (MCP) is a standard way for AI assistants to securely call tools and data sources. It is designed for MCP clients like Cursor, Claude Desktop, and MCP Inspector that connect through local process execution. The server provides both market-data and trading workflows with strict validation, safe error handling, and developer-friendly observability.

What This Server Provides

• Public market data tools (spot + futures)
• Private trading/account tools (requires API credentials)
• MCP resources and prompts for agent workflows
• Request validation via Zod
• Structured error handling and optional file logging

Features

• Stdio-only MCP server for secure local integration with MCP clients
• Spot and futures API coverage for both public and authenticated operations
• HMAC-based authenticated request flow for private endpoints
• Input validation and normalized MCP error responses
• Outbound request retries and timeout controls
• Optional structured file logging for debugging and auditability

Supported Tools

Spot (Public + Private)

• Market data: tickers, order book, trades, klines, exchange info, currencies
• Trading: place market/limit orders, cancel orders, cancel by symbol, cancel all
• Account: balances, open orders, order history, trade history, exchange fee
• Example tool names:
  • zebpay_public_getTicker
  • zebpay_public_getOrderBook
  • zebpay_spot_placeMarketOrder
  • zebpay_spot_placeLimitOrder
  • zebpay_spot_getBalance

Futures (Public + Private)

• Market data: health status, markets, market info, order book, 24h ticker, aggregate trades
• Trading/account: wallet balance, place order, add/reduce margin, open orders, positions
• History: order history, linked orders, trade history, transaction history
• Example tool names:
  • zebpay_futures_public_getMarkets
  • zebpay_futures_public_getOrderBook
  • zebpay_futures_placeOrder
  • zebpay_futures_getWalletBalance
  • zebpay_futures_getPositions

Tech Stack

• Node.js (ESM)
• TypeScript
• @modelcontextprotocol/sdk
• undici
• zod

Project Structure

src/
├── index.ts                  # Stdio MCP server entrypoint
├── mcp/                      # Tools, resources, prompts, MCP errors/logging
├── private/                  # Authenticated Zebpay clients
├── public/                   # Public market-data clients
├── security/                 # Credentials + signing helpers
├── http/                     # Shared outbound HTTP client to Zebpay APIs
├── validation/               # Schemas and validation helpers
├── utils/                    # Caching, metrics, formatting, file logging
└── types/                    # Shared response types

Prerequisites

• Node.js 20+
• npm 9+
• Zebpay API credentials (for private tools)
• Create your API key/secret from the official ZebPay API portal: https://api.zebpay.com/

Creating a ZebPay API Key

Use the steps below to generate API credentials for this MCP server:

1. Open the ZebPay API portal: https://api.zebpay.com/
2. Sign in to your ZebPay account.
3. Go to API Trading and click Create New API Key.
4. Enter key details:
   • key name (for example: zebpay-mcp-local)
   • required permissions (read-only for market/account checks, trading permissions only if needed)
   • optional IP whitelist (recommended for better security)
5. Complete OTP verification.
6. Copy and save:
   • API Key
   • Secret Key (shown once)

Then add them to your local .env file:

ZEBPAY_API_KEY=your_api_key
ZEBPAY_API_SECRET=your_api_secret

Security notes:

• Never commit API keys/secrets to git.
• Prefer least-privilege API permissions.
• Rotate keys immediately if exposed.

Setup

git clone <your-repo-url>
cd zebpay-mcp

... [View full README on GitHub](https://github.com/zebpay/zebpay-mcp-server#readme)