# Binance Announcements MCP

An MCP server that streams the latest Binance announcements to your AI agents in real time, enabling instant analysis and action on market-moving updates.

![GitHub License](https://img.shields.io/github/license/kukapay/binance-announcements-mcp) 
![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
![Status](https://img.shields.io/badge/status-active-brightgreen.svg)

## Features

- **Fetch Binance Announcements**: Retrieve up to 20 announcements per request from the Binance endpoint.
- **Pagination Support**: Specify the page number to fetch different sets of announcements.
- **Markdown Output**: Announcements are formatted as `- [title](url) _(time)_` for easy readability.

## Prerequisites

- Python 3.10+
- [uv](https://docs.astral.sh/uv/) (recommended) or pip for dependency management


## Installation

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

2. **Install Dependencies**:
   ```bash
   uv sync
   ```

4. **Installing to Claude Desktop**:

    Install the server as a Claude Desktop application:
    ```bash
    uv run mcp install main.py --name "Binance Announcements"
    ```

    Configuration file as a reference:

    ```json
    {
       "mcpServers": {
           "Binance Announcements": {
               "command": "uv",
               "args": [ "--directory", "/path/to/binance-announcements-mcp", "run", "main.py" ]
           }
       }
    }
    ```
    Replace `/path/to/binance-announcements-mcp` with your actual installation path.

## Usage

The server provides a single MCP tool, `fetch_latest_announcements`, which fetches Binance announcements and returns them in Markdown format.

The `fetch_latest_announcements` tool accepts two parameters:
- `count` (int, default: 20): Number of announcements to fetch (maximum 20).
- `page` (int, default: 1): Page number for pagination.

**Example Prompt** 
```markdown
List the 5 newest Binance announcements.
```

**Example Response**:
```markdown
# Binance Announcements

- [New Listing: Token XYZ](https://www.binance.com/en/support/announcement/123) _07-07 10:30:00_
- [Scheduled Maintenance](https://www.binance.com/en/support/announcement/124) _07-07 09:15:00_
- [Trading Competition Update](https://www.binance.com/en/support/announcement/125) _07-07 08:00:00_
- [Wallet Upgrade Notice](https://www.binance.com/en/support/announcement/126) _07-07 07:45:00_
- [New Staking Options](https://www.binance.com/en/support/announcement/127) _07-07 06:30:00_
```

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.