A Model Context Protocol (MCP) implementation for Tinyman on Algorand, built by GoPlausible.
This project provides MCP tools and resources for interacting with Tinyman AMM protocol on Algorand blockchain. It consists of two main packages:
@tinyman-mcp/server: MCP server implementation providing tools for Tinyman operations like swaps, liquidity provision, pool management and analytics@tinyman-mcp/client: Client implementation for wallet connections and transaction signing (Work in Progress)
The MCP server provides the following tools:
tinyman_get_pool: Retrieve detailed information about a specific pooltinyman_get_pool_analytics: Get analytics and statistics for a pooltinyman_get_pool_creation_quote: Generate quote for creating a new pool
tinyman_get_swap_quote: Generate quotes for asset swaps with support for:- Fixed input amount swaps
- Fixed output amount swaps
- Slippage calculations
tinyman_get_liquidity_quote: Generate quotes for adding liquidity- Supports single and dual asset deposits
- Calculates expected pool tokens
tinyman_get_remove_liquidity_quote: Generate quotes for removing liquidity- Supports proportional and single-asset withdrawals
- Calculates expected asset returns
tinyman_get_asset_optin_quote: Generate quote for opting into an assettinyman_get_validator_optin_quote: Generate quote for opting into a validatortinyman_get_validator_optout_quote: Generate quote for opting out of a validator
All tools support both Tinyman v1.1 and v2 protocols, with v2 being the default version where applicable.
To install or update the Tinyman MCP implementation, clone the repository, install the dependencies and build the project":
First check node version to be 23.6.1 or later:
node -vUpgrade to 23.6.1 or later if needed!
Then check the Claude or Cursor container folders to have mcp-servers folder (if not create one):
mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-serversThen clone this repository under mcp-servers folder and install dependencies:
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 configurationsAnd you are done! Now you can open you MCP config and add the server as :
{
"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"
}
}
}
}Make sure yopu change the paths to match your local system's paths.
For example on MACOS and Claud, the path would be something like this:
{
"mcpServers": {
"algorand-mcp": {
"command": "node",
"args": [
" /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/tinyman-mcp/packages/server/dist/index.js"
]
}
}
}packages/
├── client/ # Client implementation (WIP)
└── server/ # MCP server implementation
# Install dependencies
npm install
# Build all packages
npm run build
# Clean build artifacts
npm run cleanMIT