humble-legacy-mcp

MCP server for the legacy Humble Swap (duoswap) DEX on Algorand. Supports the original ASA-based pools with both net_tok (ALGO/ASA) and tok_tok (ASA/ASA) contract types.

Architecture

• Pool discovery from the on-chain Protocol contract (771884869) via ARC-28 Register events
• ASA-native — all tokens are Algorand Standard Assets (no ARC-200 wrapping)
• Constant-product AMM quotes computed locally from pool reserves
• Transaction building produces unsigned atomic groups (payment/axfer + app call)

Setup

npm install

Usage

node index.js

Adding to a Client

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

Tools

Pools

Tool	Description
get_pools	List legacy Humble Swap pools with token pairs and pool type
get_pool	Get on-chain pool details (reserves, tokens, LP asset)

Tokens

Tool	Description
get_tokens	List ASA tokens traded on legacy Humble Swap
get_token_info	Get ASA metadata by asset ID

Trading

Tool	Description
get_quote	Swap quote with rate, fee, price impact, min received
swap_txn	Build unsigned swap transactions
add_liquidity_txn	Build unsigned add-liquidity transactions
remove_liquidity_txn	Build unsigned remove-liquidity transactions

Pool Types

net_tok — ALGO + ASA pools

Token A is always ALGO (native). Swaps use a payment transaction for ALGO and an ASA transfer for the other token.

tok_tok — ASA + ASA pools

Both tokens are ASAs. Swaps use ASA transfers for both tokens.

References

• Humble SDK LP ABI
• duoswap-core
• HumbleSwapMCP (Voi reference)