Built by GoPlausible and distilled from Algorand MCP.
A Model Context Protocol (MCP) server implementation for interacting with the Vestige API, providing comprehensive DeFi analytics and data access for the Algorand ecosystem.
Vestige MCP serves as a bridge between MCP-enabled applications and the Vestige API, offering tools to access:
- Network information and statistics
- Protocol analytics (Tinyman, Pact, Algofi, etc.)
- Asset data and price information
- Pool analytics and liquidity information
- Vault statistics
- Balance tracking
- Transaction monitoring
- Market notes and annotations
To install or update the Algorand MCP implementation, clone the repository, install the dependencies and build the project":
First check node version to be 23.6.1 or later:
node -v
Upgrade to 23.6.1 or later if needed!
Then check the Claude or Cursor container folders to have mcp-servers folder (if not create one):
mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
Then clone this repository under mcp-servers folder and install 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 your configurations
And you are done! Now you can open you MCP config and add the server as :
{
"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": "",
"ITEMS_PER_PAGE": "10"
}
}
}
}
Make sure yopu change the paths to match your local system's paths.
For example on MACOS and Claud, the path would be something like this:
{
"mcpServers": {
"vestige-mcp": {
"command": "node",
"args": [
" /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/vestige-mcp/packages/server/dist/index.js"
]
}
}
}
vestige-mcp/
├── packages/
│ ├── client/ # Client library for Vestige MCP (Work in Progress)
│ │ ├── src/
│ │ │ ├── env.ts # Client environment configuration
│ │ │ ├── index.ts # Client entry point
│ │ │ └── LocalWallet.ts
│ │ └── package.json
│ │
│ └── server/ # MCP server implementation
│ ├── src/
│ │ ├── tools/ # API tool implementations
│ │ │ └── apiManager/
│ │ │ └── vestige/ # Vestige API endpoints
│ │ ├── utils/ # Utility functions
│ │ ├── resources/ # Resource definitions
│ │ ├── env.ts # Server environment configuration
│ │ └── index.ts # Server entry point
│ └── package.json
- View network status and statistics
- Track blockchain synchronization
- Monitor network performance
- Access data for major DeFi protocols
- Track Total Value Locked (TVL)
- Monitor protocol activity and usage
- Comprehensive asset information
- Price tracking and history
- Volume and liquidity metrics
- Market capitalization data
- Asset composition analysis
- Real-time swap monitoring
- Historical trade data
- Price charts and candles
- Order book depth
- Liquidity pool information
- Pool composition
- Volume and TVL tracking
- Historical pool data
cd packages/server
npm run dev
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.