Tinyman MCP

What is Tinyman MCP?

Tinyman MCP is a Model Context Protocol (MCP) implementation for interacting with the Tinyman AMM protocol on the Algorand blockchain. It provides tools for swaps, liquidity provision, pool management, and analytics. It is built by GoPlausible and consists of two packages: a server and a client (client is work in progress).

How to use Tinyman MCP?

Clone the repository, install dependencies with npm install, build with npm run build, and edit the .env file. Then add the server to your MCP configuration (Claude or Cursor) using the node command pointing to packages/server/dist/index.js and set environment variables such as ALGORAND_NETWORK, ALGORAND_ALGOD_API, and others.

Key features of Tinyman MCP

• Pool management tools: get pool info, analytics, and creation quotes.
• Swap quote generation with fixed input/output and slippage support.
• Liquidity quote generation for adding and removing liquidity.
• Single and dual asset deposit calculations.
• Asset opt-in, validator opt-in, and opt-out quotes.
• Supports both Tinyman v1.1 and v2 protocols (v2 default).

Use cases of Tinyman MCP

• Retrieve detailed pool information and analytics for market analysis.
• Generate swap quotes for trading assets on Tinyman.
• Calculate quotes for adding liquidity to a pool.
• Generate quotes for removing liquidity proportionally or as single asset.
• Obtain quotes for opting into an asset or Tinyman validator.

FAQ from Tinyman MCP

What is Tinyman MCP?

It is an MCP server that provides tools for interacting with the Tinyman AMM protocol on Algorand, enabling operations like swaps, liquidity management, and pool analytics.

Which protocol versions does Tinyman MCP support?

Tinyman MCP supports both Tinyman v1.1 and v2 protocols, with v2 being the default version where applicable.

How do I install and configure Tinyman MCP?

You need Node.js version 23.6.1 or later. Clone the repository, run npm install and npm run build, then add the server configuration to your MCP config file with the correct path and environment variables.

What environment variables are required?

Required variables include ALGORAND_NETWORK, ALGORAND_ALGOD_API, ALGORAND_ALGOD, ALGORAND_ALGOD_PORT, ALGORAND_TOKEN, and ALGORAND_AGENT_WALLET (a mnemonic). ITEMS_PER_PAGE is optional with a default of 10.

Where does the data live?

The server connects to an Algorand node via the provided API endpoints (e.g., https://mainnet-api.algonode.cloud). No local data storage is mentioned; all operations are performed on-chain or requested from the node.