0xmonk MCP Server

🚀 0xMONK MCP Server

A Model Context Protocol (MCP) server for interacting with the 0xMONK trading bot API.

🚀 Quick Start

This project provides a set of tools that allow AI assistants to interact with the 0xMONK API, enabling the management of trading agents, execution of trades, and monitoring of portfolios.

✨ Features

• Agent Management

  • Create, update, and delete trading agents.
  • View agent details and retrieve all available agents.
  • Add or remove parent agents (for inheritance).
  • Retrieve agents by user ID or Telegram user ID.

• Trading Operations

  • Execute buy and sell orders for tokens.
  • Get buy suggestions for agents.
  • Synchronize agent status with the blockchain.
  • Monitor task status.

• Portfolio Management

  • Monitor agent portfolios, holdings, and trading history.
  • Access trading decisions and calls made by agents.
  • Retrieve wallet details for agents and Telegram users.

• ProAgent Interaction

  • Query ProAgent for market information and trading insights.
  • Get real-time cryptocurrency prices and market data.

📦 Installation

1. Clone the repository:

git clone https://github.com/your-username/FereAI-MCP.git
cd FereAI-MCP

2. Install uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

3. Create a virtual environment and install dependencies:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt

4. Configure environment variables: Get your FereAI Key from https://docs.fereai.xyz/docs/api/api_access and set it in the .env file.

cp .env.example .env
# Edit .env to configure your settings

💻 Usage Examples

Basic Usage

Run the MCP server:

uv run main.py

📚 Documentation

Project Structure

FereAI-MCP/
├── .env                  # Environment variable file
├── .env.example          # Example environment variable file
├── .gitignore            # Git ignore file
├── main.py               # Server entry point
├── monk.json             # API specification
├── pyproject.toml        # Python project configuration
├── README.md             # This file
├── requirements.txt      # Python dependencies
└── src/                  # Source code
    ├── agent.py          # Agent-related API functions
    ├── config.py         # Configuration module
    ├── main.py           # MCP server implementation
    ├── pro_agent.py      # Pro Agent implementation
    └── utils.py          # Utility functions

API Documentation

For more information about the 0xMONK API, refer to the monk.json file or visit the official documentation.

📄 License

This project is licensed under the MIT license.