A Model Conntext Protocol (MCP) server for interacting with the 0xMONK Trading Agent API.
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.
-
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
-
Clone the repository:
git clone https://github.com/your-username/FereAI-MCP.git cd FereAI-MCP -
Install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh -
Create a virtual environment and install dependencies:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -r requirements.txt
-
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 configurationRun the MCP server:
uv run main.pyFereAI-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
For more information about the 0xMONK API, refer to the monk.json file or visit the official documentation.
MIT