Vestige MCP

🚀 Vestige Chain MCP

Developed by GoPlausible, and refined from Algorand MCP.

This is a Model Context Protocol (MCP) server implementation for interacting with the Vestige API, providing comprehensive DeFi analysis and data access tools for the Algorand ecosystem.

🚀 Quick Start

Vestige Chain MCP serves as a bridge between MCP-enabled applications and the Vestige API, offering the following features:

• Network information and statistics
• Protocol analysis (Tinyman, Pact, Algofi, etc.)
• Asset data and price information
• Pool analysis and liquidity information
• Wallet statistics
• Balance tracking
• Transaction monitoring
• Market notes and annotations

📦 Installation

To install or update Vestige Chain MCP, follow these steps:

First, check if your Node.js version is 23.6.1 or higher:

node -v

If you need to upgrade to version 23.6.1 or higher!

Then, check if there is an mcp-servers folder in the Claude or Cursor container folder (create one if it doesn't exist):

mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# Or for Cursor 
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

Next, clone this repository under the mcp-servers folder and install the dependencies:

cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# Or for Cursor 
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
# Clone the repository
git clone https://github.com/GoPlausible/vestige-mcp.git
cd vestige-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Edit the .env file to set the configuration

Done! Now you can add the server to your MCP configuration:

{
  "mcpServers": {
    "vestige-mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/vestige-mcp/packages/server/dist/index.js"
     ],
      "env": {
        "ALGORAND_NETWORK": "mainnet",
        "ALGORAND_ALGOD_API": "https://mainnet-api.algonode.cloud/v2",
        "ALGORAND_ALGOD": "https://mainnet-api.algonode.cloud",
        "ALGORAND_ALGOD_PORT": "",
        "ALGORAND_TOKEN": "",
        "ALGORAND_AGENT_WALLET": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
        "VESTIGE_API_URL": "https://api.vestigelabs.org",
        "VESTIGE_API_KEY": "",
        "NODE_ENV": "development"
      }
    }
  }
}

✨ Features

Network Information

• Provides the overall status and statistics of the Algorand network.

Protocol Analysis

• Monitors and analyzes the usage of DeFi protocols, including TVL and activity data.

Asset Data

• Comprehensive asset information, including prices, history, and market statistics.

Transaction Data

• Real-time exchange monitoring and historical transaction records.

Pool Analysis

• Detailed information on liquidity pools, including composition and performance indicators.

💻 Usage Examples

Basic Usage

To start the server, run the following commands:

cd packages/server
npm run dev

📚 Contribution

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a Pull Request.

📄 License

This project is licensed under the MIT License. For details, please refer to the LICENSE file.