Tinyman MCP

What it is

An MCP server for the Tinyman AMM on Algorand. It reads pool state and generates quotes — for swaps, liquidity in and out, and the various opt-ins — so a model can work out what a trade would cost. Signing lives in a separate client package that is still in progress.

What you get

• Pool reads — tinyman_get_pool for a pool's details and tinyman_get_pool_analytics for its statistics
• tinyman_get_swap_quote prices a swap, supporting a fixed input amount, a fixed output amount, and slippage
• tinyman_get_liquidity_quote covers adding liquidity as a single asset or both, and returns the pool tokens you would expect
• tinyman_get_remove_liquidity_quote covers the way out, proportional or single-asset, with the assets you would get back
• tinyman_get_pool_creation_quote prices creating a new pool
• The Algorand housekeeping too — tinyman_get_asset_optin_quote, tinyman_get_validator_optin_quote and tinyman_get_validator_optout_quote
• Both protocol versions are supported, with v2 as the default where the choice applies

Requirements

Node.js 23.6.1 or later, then clone the repository, npm install and npm run build; the client launches the built server entry point with node. Network settings arrive as environment variables — ALGORAND_NETWORK, ALGORAND_ALGOD_API, ALGORAND_ALGOD, ALGORAND_ALGOD_PORT, ALGORAND_TOKEN and ALGORAND_AGENT_WALLET, plus ITEMS_PER_PAGE for pagination. The wallet variable takes an account mnemonic, so treat it as a secret and never reuse the placeholder printed in the setup snippet.

Setup effort

Follow the published steps — mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers

Tools you get

9 tools named in the project's documentation.

Requires

• Node.js 23.6.1 or later
• ALGORAND_AGENT_WALLET in your environment

Where it runs

The documented client runs the server on your machine.