mcp-server

fere-ai/mcp-server

3.1

If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

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

0xMONK MCP Server

A Model Conntext Protocol (MCP) server for interacting with the 0xMONK Trading Agent API.

Overview

This project provides a suite of tools for AI assistants to interact with the 0xMONK API, allowing them to manage trading agents, execute trades, and monitor portfolios.

Features

  • Agent Management

    • Create, update, and delete trading agents
    • View agent details and get all available agents
    • Add or remove parent agents (for inheritance)
    • Get agents by user ID or Telegram user ID
  • Trading Operations

    • Execute buy and sell orders for tokens
    • Get buy recommendations for agents
    • Synchronize agent state with blockchain
    • Monitor task status
  • Portfolio Management

    • Monitor agent portfolios, holdings, and trade history
    • Access trading decisions and calls made by agents
    • Get wallet details for agents and Telegram users
  • ProAgent Interaction

    • Query the 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 with your configuration

Usage

Run the MCP server:

uv run main.py

Project Structure

FereAI-MCP/
ā”œā”€ā”€ .env                  # Environment variables
ā”œā”€ā”€ .env.example          # Example environment variables
ā”œā”€ā”€ .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 file or visit the official documentation.

License

MIT