# MEXC Announcements MCP

An MCP server that streams real-time, structured MEXC exchange announcements to AI agents.

[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)](https://nodejs.org/)
![Status](https://img.shields.io/badge/status-active-brightgreen.svg)

## Features

- Three focused, high-signal tools
- Returns clean structured data with full links and ISO timestamps

## Installation

Prerequisites:
- Node.js ≥ 18
- Internet access

1. **Clone the Repository**:
   ```bash
   git clone https://github.com/kukapay/mexc-announcements-mcp.git
   cd mexc-announcements-mcp
   ```

2. **Install Dependencies**:
   ```bash
   npm install
   ```
3. **Configure MCP Client**:
   To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):
    ```json
    {
      "mcpServers": {
        "MEXC Announcements": {
          "command": "node",
          "args": ["/path/to/mexc-announcements-mcp/index.js"]
        }
      }
    }   
    ```
   Replace `/path/to/mexc-announcements-mcp` with your actual installation path.
   
## Available Tools

### `get_latest`
Returns **all recent MEXC announcements** from every category, sorted newest first.

**Example prompt:**
> “Show me the 10 most recent MEXC announcements”

**Output:**
```json
[
  {
    "title": "MEXC Will List XYZ (XYZ) in Innovation Zone",
    "link": "https://www.mexc.com/announcements/123456",
    "published_at": "2025-12-09T10:30:00.000Z"
  },
  {
    "title": "Delisting of ABC/USDT Trading Pair",
    "link": "https://www.mexc.com/announcements/123457",
    "published_at": "2025-12-08T14:15:00.000Z"
  }
]
```

### `get_new_listings`
Returns **every new token/coin listing announcement** ever published on MEXC, newest first.

**Example prompt:**
> “What are the newest tokens listed on MEXC this week?”

**Output:**
```json
[
  {
    "title": "MEXC Will List SuperToken (STK) – Trading Starts Dec 10",
    "link": "https://www.mexc.com/announcements/new-listings/98765",
    "published_at": "2025-12-09T08:00:00.000Z"
  },
  {
    "title": "New Listing: QuantumPad (QPAD) in Assessment Zone",
    "link": "https://www.mexc.com/announcements/new-listings/98764",
    "published_at": "2025-12-08T12:00:00.000Z"
  }
]
```

### `get_delistings`
Returns **every delisting announcement**, newest first.

**Example prompt:**
> “Has MEXC delisted anything in the last 7 days?”

**Output:**
```json
[
  {
    "title": "Delisting of OLDCOIN (OLD) – Trading Ends Dec 15",
    "link": "https://www.mexc.com/announcements/delistings/54321",
    "published_at": "2025-12-09T06:00:00.000Z"
  }
]
```
   
   
## License

MIT © 2025 – Feel free to use, modify, and redistribute.