tinyman-mcp

Tinyman MCP provides tools and resources for interacting with the Tinyman AMM protocol on the Algorand blockchain. It includes two main packages: @tinyman-mcp/server, which is the MCP server implementation offering tools for operations like swaps, liquidity provision, pool management, and analytics; and @tinyman-mcp/client, which is a client implementation for wallet connections and transaction signing, currently a work in progress. The server supports both Tinyman v1.1 and v2 protocols, with v2 being the default where applicable.

Features

• {'name': 'Pool Management', 'description': 'Retrieve detailed information about pools, get analytics, and generate quotes for creating new pools.'}
• {'name': 'Trading Operations', 'description': 'Generate quotes for asset swaps, including fixed input/output amount swaps and slippage calculations.'}
• {'name': 'Liquidity Management', 'description': 'Generate quotes for adding and removing liquidity, supporting single and dual asset deposits and withdrawals.'}
• {'name': 'Asset Operations', 'description': 'Generate quotes for opting into or out of assets and validators.'}

Usage with Different Platforms

installation_script

bash
# Check node version
node -v

# Create mcp-servers folder if not exists
mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

# Clone repository and install dependencies
cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor 
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

git clone https://github.com/GoPlausible/tinyman-mcp.git
cd tinyman-mcp
npm install
npm run build

# Edit .env file for configurations



{
  "mcpServers": {
    "tinyman-mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/tinyman-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",
        "ITEMS_PER_PAGE": "10"
      }
    }
  }
}



{
  "mcpServers": {
    "algorand-mcp": {
      "command": "node",
      "args": [
        " /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/tinyman-mcp/packages/server/dist/index.js"
     ]
    }
  }
}