Every tool here returns a quote, which makes it a safe thing to hand an agent: the worst outcome of a bad question is a wrong number. Actually executing a trade needs the companion client for wallet connection and signing, and that package is described as work in progress. The version note is worth checking against your own setup, since v1.1 and v2 pools price differently and v2 is what you get unless you ask otherwise.
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.
- 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
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.
Build from source — clone the repository and build it, then point your client at the binary