tinyman-mcp

Name: Tinyman MCP Server
Availability: InStock

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

Tinyman MCP Server