Tinyman MCP

🚀 Tinyland MCP

This is an implementation of the Model Context Protocol (MCP) on the Algorand network on Tinyman, developed by GoPlausible.

🚀 Quick Start

This project provides MCP tools and resources for interacting with the Tinyman AMM protocol on the Algorand blockchain. It mainly consists of two main packages:

• @tinyman-mcp/server: Provides an MCP server implementation for Tinyman operations such as swaps, liquidity provision, pool management, and analysis.
• @tinyman-mcp/client: A client implementation for wallet connection and transaction signing (under development).

✨ Features

The MCP server offers the following tools:

Pool Management

• tinyman_get_pool: Retrieve detailed information about a specific pool.
• tinyman_get_pool_analytics: Obtain pool analytics and statistical information.
• tinyman_get_pool_creation_quote: Generate a quote for creating a new pool.

Transaction Operations

• tinyman_get_swap_quote: Support quote generation for the following swaps:
  • Fixed input amount swaps.
  • Fixed output amount swaps.
  • Slippage calculation.

Liquidity Management

• tinyman_get_liquidity_quote: Support liquidity provision quote generation for single - asset and dual - asset deposits, and calculate expected pool tokens.
• tinyman_get_remove_liquidity_quote: Support liquidity removal quote generation for proportional and single - asset withdrawals, and calculate expected asset returns.

Asset Operations

• tinyman_get_asset_optin_quote: Generate a quote for an asset to opt - in to the gateway.
• tinyman_get_validator_optin_quote: Generate a quote for a validator to opt - in to the gateway.
• tinyman_get_validator_optout_quote: Generate a quote for a validator to opt - out of the gateway.

All tools support both the Tinyman v1.1 and v2 protocols, with v2 being the default version (if applicable).

📦 Installation

To install or update the Tinyman MCP implementation, 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 your 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

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

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/tinyman - mcp.git
cd tinyman - mcp
# Install dependencies
npm install
# Build the project
npm run build
# Edit the.env file to set your configuration

Done! Now you can open the MCP configuration and add the server:

{
  "mcpServers": {
    "tinyman - mcp": {
      "command": "node",
      "args": [
        "--max - old - space - size=4096"
      ],
      "env": {},
      "volumeMounts": [],
      "dependencies": []
    }
  }
}

🔧 Technical Details

• Supports the Tinyman v1.1 and v2 protocols.
• Provides pool management, transaction operations, and liquidity management functions.
• Is compatible with the AMM ecosystem of the Algorand network.

📚 Documentation

tinyman - mcp/
├── server.js        # Main file for the MCP server
├── package.json    # Dependencies and build configuration
└──.env.example    # Example environment variables

This project offers a powerful toolset for interacting with the Tinyman AMM protocol on Algorand, supporting various operations and providing flexible configuration options.