Which integrations are available for this server?

Allows interaction with the Algorand blockchain and the Tinyman AMM protocol to discover liquidity pools, look up asset information, get swap quotes, and build transactions for swaps or liquidity management. Allows reporting bugs and filing feature requests directly to GitHub issues.

How do I use Tinyman MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Tinyman MCP Server What is the current swap quote for 100 ALGO to USDC?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

tinyman-mcp

MCP (Model Context Protocol) server for the Tinyman AMM DEX on Algorand.

Built on the EmptyMCP template for UluOS, following the same patterns as HumbleSwapMCP.

Features

Pool discovery — List top pools, get on-chain reserves, analytics
Token lookup — Browse traded assets, resolve symbols to ASA IDs
Swap quotes — Get expected output, rate, fee, price impact via Tinyman v2
Transaction building — Unsigned swap, add-liquidity, remove-liquidity txns (base64-encoded for wallet signing)
Issue reporting — File bugs or feature requests to GitHub Issues

Tools

Tool	Description
`get_pools`	List top Tinyman v2 liquidity pools
`get_pool`	Get on-chain pool info by asset pair
`get_pool_analytics`	Get analytics for a pool by address
`get_tokens`	List traded tokens with volume data
`get_asset_info`	Get on-chain ASA metadata
`get_asset_analytics`	Get Tinyman analytics for an asset
`get_asset_pools`	Get all pools containing an asset
`get_protocol_stats`	Get Tinyman protocol-wide statistics
`get_quote`	Get a swap quote (no txn built)
`swap_txn`	Build unsigned swap transactions
`add_liquidity_txn`	Build unsigned add-liquidity transactions
`remove_liquidity_txn`	Build unsigned remove-liquidity transactions
`report_issue`	Report a bug or feature request

Setup

npm install

Usage

node index.js

Adding to a Client

Add the following to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "tinyman-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/tinyman-mcp/index.js"]
    }
  }
}

Architecture

index.js              Entry point — registers tools, starts stdio transport
data/
  contracts.json      Algorand mainnet/testnet node endpoints and app IDs
lib/
  client.js           Algod/Indexer client setup
  pools.js            Pool fetching via Tinyman SDK (poolUtils.v2)
  tokens.js           Token resolution and ASA lookup
  quote.js            Swap quotes via Tinyman SDK (Swap.v2)
  builders.js         Transaction builders (swap, add/remove liquidity)
  api.js              Tinyman analytics REST API calls
  utils.js            Unit conversion, JSON helpers, txn encoding
  reporting.js        GitHub issue submission
tools/
  pools.js            MCP pool tools
  tokens.js           MCP token tools
  trading.js          MCP trading tools (quotes, swaps, liquidity)
  reporting.js        MCP issue reporting tool

Dependencies

@tinymanorg/tinyman-js-sdk — Tinyman v2 AMM SDK
algosdk — Algorand JavaScript SDK
@modelcontextprotocol/sdk — MCP server framework

License

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tinyman MCP Server