Tinyman MCP
About
An MCP server for the Tinyman protocol on the Algorand blockchain, offering tools for swaps, liquidity provision, and pool management.
Details
- Author
- goplausible
- GitHub stars
- 1
- Downloads
- 172
- Categories
- Developer Tools, Other
- Tags
- #defi, #crypto, #evm, #trading, #smart-contracts
Jump to
- 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).
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.
A Model Context Protocol (MCP) implementation forTinymanon Algorand, built byGoPlausible.
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 pool
- tinyman_get_pool_analytics: Get analytics and statistics for a pool
- tinyman_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
- Supports proportional and single-asset withdrawals
- Calculates expected asset returns
- tinyman_get_asset_optin_quote: Generate quote for opting into an asset
- tinyman_get_validator_optin_quote: Generate quote for opting into a validator
- tinyman_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:
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-servers
Then 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 configurations
And 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 clean
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
On-chain automated trading strategies (DEX) for AI agents. Create limit orders, range orders, recurring buy-low-sell-high strategies, and concentrated liquidity positions across Ethereum, Sei, Celo, TAC, and COTI. Unlike traditional AMMs and liquidity pools, Carbon lets you set asymmetric price ranges - your buy and sell orders are independent, not mirrored. Backtest any strategy against historical prices before going on-chain, explore market liquidity, find discount entry points, and swap tokens against Carbon DeFi's maker liquidity. 25 tools. Returns unsigned transactions — agents never hold funds or private keys. Zero gas on fills.
Trade on prediction markets from Claude Code. Browse markets, check odds, build and execute trades on-chain.
OTC crypto trading with HTLC atomic settlement on Ethereum and Bitcoin — create trades, lock assets, and settle trustlessly via AI agents
Interact with the Solana blockchain using the Solana Agent Kit.
MCP server for Uniswap — swap routing, pool data, and liquidity queries across all supported chains.
Automate token swaps on the Uniswap DEX across multiple blockchains.
Server-side EVM wallet for Ai agents. Send transactions, manage tokens, and interact with smart contracts across multiple chains.
Interact with the Borrow Automated Market Maker (BAMM) protocol on the Fraxtal blockchain.
An MCP server providing onchain tools for AI applications to interact with the Base Network and Coinbase API.
Provides tools for interacting with the EDUCHAIN blockchain, including wallet, swap, and arbitrage operations on SailFish DEX.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
