# Gidipex MCP — AI-Native Cryptocurrency Exchange

> Gidipex is a full-featured cryptocurrency exchange that exposes its full trading infrastructure to AI agents via the Model Context Protocol (MCP). Connect Claude, GPT, Gemini, Copilot, Cursor, and any MCP-compatible client directly to spot trading, futures, OTC, P2P, wallets, and portfolio management — all in natural language.

## What is the Gidipex MCP Server?

The Gidipex MCP Server is a production-ready Model Context Protocol server hosted at `mcp.gidipex.com`. It allows any AI agent or LLM client to programmatically interact with the Gidipex exchange on behalf of authenticated users using granular scoped tokens.

AI agents can check portfolio balances, place and cancel orders, read market data, manage notifications, and configure trading account settings — all through structured MCP tool calls with built-in confirmation gates for high-risk operations.

## MCP Endpoint

- **URL:** `https://mcp.gidipex.com/mcp`
- **Transport:** Streamable HTTP (MCP 2024-11-05)
- **Authentication:** Bearer token (OAuth2 scoped token)
- **Protocol Version:** 2024-11-05
- **Manifest:** `https://mcp.gidipex.com/mcp/manifest`
- **Health:** `https://mcp.gidipex.com/mcp/health`

## Compatible AI Clients

The Gidipex MCP server is compatible with any client implementing the Model Context Protocol:

- **Claude Desktop** (Anthropic) — configure via `claude_desktop_config.json`
- **Claude.ai** (Anthropic web) — remote MCP server support
- **Cursor IDE** — configure via `.cursor/mcp.json`
- **GitHub Copilot** — via MCP extension integrations
- **Continue.dev** — configure via `config.json` MCP servers
- **Cline** (VS Code) — configure via MCP server settings
- **Windsurf** (Codeium) — MCP tool integration
- **OpenHands** — agentic MCP tool support
- **Zed Editor** — MCP context panel
- **Any app using @modelcontextprotocol/sdk** — drop-in compatible

## Quick Start for AI Agents

### Step 1: Create a Gidipex account
Visit https://gidipex.com/signup and complete verification.

### Step 2: Generate an MCP token
```
POST https://mcp.gidipex.com/api/mcp/tokens
Authorization: Bearer <your-sanctum-session-token>
Content-Type: application/json

{
  "name": "My AI Agent",
  "scopes": ["mcp:use", "mcp:wallet.read", "mcp:trade.read", "mcp:trade.write"]
}
```

### Step 3: Configure Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "gidipex": {
      "url": "https://mcp.gidipex.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}
```

### Step 4: Configure Cursor
Add to `.cursor/mcp.json` in your project:
```json
{
  "mcpServers": {
    "gidipex": {
      "url": "https://mcp.gidipex.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}
```

## Available Tools (22+)

### Wallet & Deposits
- `get-wallet-overview` — Get all wallet balances, available and locked amounts across spot and derivatives
- `get-deposit-address` — Fetch the deposit address for any supported asset and network

### Trading Accounts
- `list-trading-accounts` — List all trading accounts with balances, positions, and margin state
- `list-orders` — Query open and historical orders with full execution metadata
- `list-positions` — View open futures positions and unrealised PnL

### Order Management
- `preview-order` — Preview a trade before committing (fees, estimated fill, slippage)
- `place-order` — Place market, limit, stop-limit, and conditional orders (confirmation gate)
- `cancel-order` — Cancel an open order by ID
- `cancel-all-orders` — Cancel all open orders for a trading account

### Position Management
- `preview-close-position` — Preview closing a futures position
- `close-position` — Close an open futures position (confirmation gate)
- `get-leverage` — Get current leverage setting per trading account
- `preview-leverage` — Preview the effect of a leverage change
- `set-leverage` — Update leverage for a trading account (confirmation gate)
- `get-margin-mode` — Get current margin mode (isolated / cross)
- `set-margin-mode` — Switch margin mode per account (confirmation gate)

### Notifications
- `list-notifications` — List account notifications with read/unread status
- `mark-notification-read` — Mark a specific notification as read
- `delete-notification` — Delete a notification

### Payouts
- `list-payout-methods` — List saved payout and withdrawal verification methods

### System
- `get-account-info` — Get authenticated user profile and account status
- `list-scopes` — List the scopes granted to the current MCP token
- `get-server-info` — Get MCP server version, protocol info, and available tool count

## Permission Scopes

Issue tokens with only the permissions your agent needs:

| Scope | Description |
|---|---|
| `mcp:use` | Base scope — required for any MCP session to initialize |
| `mcp:wallet.read` | Read wallet balances and holdings |
| `mcp:wallet.deposit.read` | Read deposit addresses per asset and chain |
| `mcp:payout.read` | Read saved payout and withdrawal methods |
| `mcp:notification.read` | List and read account notifications |
| `mcp:notification.write` | Mark read and delete notifications |
| `mcp:trade.read` | Read trading accounts, balances, orders, positions |
| `mcp:trade.write` | Preview, place, modify, cancel, and close trades |
| `mcp:trade.configure` | Change leverage and margin mode per account |

## Security Model

- All state-changing tools (orders, leverage, position close) require explicit confirmation before execution
- Tokens are scoped and can be revoked instantly from the Gidipex dashboard
- All tool calls are audited with full timestamps
- High-risk operations have a mandatory preview step before the write call

## About Gidipex

Gidipex is a regulated cryptocurrency exchange offering:
- **Spot trading** — hundreds of trading pairs with real-time order books
- **Futures** — perpetual contracts with configurable leverage
- **OTC** — institutional over-the-counter desk
- **P2P** — peer-to-peer trading with escrow
- **AI Assistant** — conversational trading via WhatsApp and web
- **MCP** — the industry's first exchange-native MCP server for AI agents

## Links

- Exchange: https://gidipex.com
- Sign Up: https://gidipex.com/signup
- MCP Landing: https://mcp.gidipex.com
- MCP Manifest: https://mcp.gidipex.com/mcp/manifest
- API Docs: https://gidipex.com/docs/api
- Support: https://support.gidipex.com
- Privacy Policy: https://gidipex.com/privacy-policy
- Terms of Service: https://gidipex.com/terms
- Twitter/X: https://x.com/gidipex