Tinyman

You can run Tinyman MCP on your machine to expose server-side tools for interacting with the Tinyman AMM on Algorand. This MCP server lets you query pool data, get quotes for swaps and liquidity actions, and manage asset-related operations. It runs locally as a stdio server you start with Node and then connect via your MCP client to perform actions securely and efficiently.

How to use

Start the Tinyman MCP server locally using Node. Once running, configure your MCP client to connect to the local stdio server so you can request pool information, generate quotes for swaps and liquidity changes, and handle asset opt-ins and validator opt-ins/out.

How to install

Prerequisites you need before installation:

• Node.js 18+ or compatible runtime
• npm (comes with Node.js)

Step-by-step installation and setup:

# Check Node.js version
node -v
# Ensure you are using a compatible Node version (>= 18 recommended)

# Create the MCP servers directory if it doesn't exist
mkdir -p PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
mkdir -p PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

# Navigate to the MCP servers directory
cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
# cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers

# Clone the Tinyman MCP repository
git clone https://github.com/GoPlausible/tinyman-mcp.git
cd tinyman-mcp

# Install dependencies and build
npm install
npm run build

# Create and edit your environment configuration as needed

Additional configuration and runtime

After building, you will run a local stdio MCP server using a Node command and a path to the built bundle. You also configure environment variables that control network access and wallet details.

{
  "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"
      }
    }
  }
}

Notes on path references and environment

Paths shown here are placeholders. Replace PATH_ON_YOUR_MACHINE with your actual base path. You can place the Tinyman MCP server under any preferred directory and update the command path accordingly.

Additional sections

Security and access: Keep your environment variables secure. Do not expose tokens or wallet seeds in publicly accessible configurations. Use environment-specific overrides for development, staging, and production.

Testing and validation: After starting the server, verify that you can query pool data, obtain pool analytics, and request swap/liquidity quotes through your MCP client. Validate both v1.1 and v2 protocol flows where applicable.

Project and tools overview

The Tinyman MCP server exposes a set of tools to work with Tinyman on Algorand. Key endpoints include pool management, trading operations, liquidity management, and asset/validator opt-ins. These endpoints support Tinyman v1.1 and v2, with v2 being the default where applicable.

Troubleshooting

If the server fails to start, check that Node.js is correctly installed and that the build completed without errors. Ensure the dist/index.js path exists after the build. Confirm that environment variables are correctly set and that network access to Algorand nodes is available if you are hitting remote API endpoints.

Available tools

tinyman_get_pool

Retrieve detailed information about a specific pool in Tinyman. Useful for analytics and pool verification.

tinyman_get_pool_analytics

Fetch analytics and statistics for a given Tinyman pool to monitor performance and usage.

tinyman_get_pool_creation_quote

Generate a quote for creating a new Tinyman pool, including required liquidity and fees.

tinyman_get_swap_quote

Generate quotes for asset swaps with support for fixed input/output amounts and slippage calculations.

tinyman_get_liquidity_quote

Generate quotes for adding liquidity, including single or dual asset deposits and expected pool tokens.

tinyman_get_remove_liquidity_quote

Generate quotes for removing liquidity, including proportional or single-asset withdrawals and expected outputs.

tinyman_get_asset_optin_quote

Generate quote for opting into a Tinyman-supported asset.

tinyman_get_validator_optin_quote

Generate quote for opting into a Tinyman validator.

tinyman_get_validator_optout_quote

Generate quote for opting out of a Tinyman validator.