LABSCO SUMMARY

Narrowed from a general Algorand server to the analytics half.

That focus is what makes it useful: instead of a broad chain toolkit, you get the numbers people actually ask about — where liquidity sits, what a pool is composed of, how an asset has traded. The setup is the rough edge. It wants a Node version newer than most machines have, it is a clone-and-build rather than a package install, and the example config carries a mnemonic that must not survive into your own. Fix that field first and the rest is straightforward.

What it is

An MCP server over the Vestige API, giving an assistant access to DeFi analytics across the Algorand ecosystem. It was distilled from the broader Algorand MCP project and narrowed to the analytics side: protocols, assets, pools, trading and network state.

What you get

Network status, statistics and synchronisation state
Protocol analytics across the major Algorand DeFi protocols, including total value locked and activity
Asset data: prices and history, volume and liquidity metrics, market capitalisation and composition
Trading data: real-time swap monitoring, historical trades, price candles and order book depth
Pool analytics: composition, volume, TVL and historical pool data
Vault statistics, balance tracking, transaction monitoring and market notes

Requirements

Node.js 23.6.1 or later — check with node -v and upgrade first, since this is newer than most systems ship. Clone the repository into your client's server folder, npm install, npm run build, then point the client's command at node and the built server entry point. Configuration is environment values in the client entry: the Algorand network and node endpoints, the Vestige API URL and key, an items-per-page setting, and an agent wallet. One thing to change before you run anything: the sample configuration in the README ships a wallet mnemonic in plain text — replace it with your own value, and treat that field as the secret it is. MIT licensed.

Setup effort

Follow the published steps — mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers

See installation options

USE CASES

01

Seeing where liquidity actually is

Read protocol TVL and pool composition across the major Algorand DeFi protocols in one conversation.

02

Researching an asset before you touch it

Pull price history, volume, liquidity and market capitalisation rather than reading a single spot price.

03

Watching trading as it happens

Monitor swaps in real time alongside historical trades and candles for the same asset.

04

Tracking a position over time

Follow balances, vault statistics and transactions from the assistant instead of an explorer.

BEFORE YOU INSTALL

What to know first

Requires

Node.js 23.6.1 or later

Where it runs

The documented client runs the server on your machine.

INSTALLATION

Connect your client

Server setup

<YOUR_MACHINE> in these commands is the folder your client keeps its files in — for Claude Desktop on macOS, /Users/<YOUR_USERNAME>/Library/Application Support (use its Cursor folder instead of Claude/ for Cursor). That path contains a space, so put it in quotes in the terminal.

TERMINAL

mkdir <YOUR_MACHINE>/Claude/mcp-servers
cd <YOUR_MACHINE>/Claude/mcp-servers
git clone https://github.com/GoPlausible/vestige-mcp.git
cd vestige-mcp
npm install
npm run build

MCP Clients

Claude Desktop

Give the full path to packages/server/dist/index.js inside the vestige-mcp folder you cloned — on macOS, /Users/<YOUR_USERNAME>/Library/Application Support/Claude/mcp-servers/vestige-mcp/packages/server/dist/index.js. Inside the JSON the space needs no escaping.

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "vestige-mcp": {
      "command": "node",
      "args": [
        "<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": "<YOUR_ALGORAND_AGENT_WALLET>",
        "VESTIGE_API_URL": "https://api.vestigelabs.org",
        "VESTIGE_API_KEY": "",
        "ITEMS_PER_PAGE": "10"
      }
    }
  }
}

Vestige MCP