Sugar MCP Server

This is an MCP (Model Context Protocol) server to interact with Sugar Sugar makes Velodrome and Aerodrome devs life sweeter 🍭

Components

Environment Variables

SUGAR_PK: Private key for the SUGAR service (required for all operations).
SUGAR_RPC_URI_8453: RPC URI for Base chain (required for blockchain interactions).
SKIP_CACHE_INIT: Set to "true" to skip cache initialization during development (optional, default: false).

Tools

get_all_tokens: Retrieve all tokens supported by the protocol.
get_prices: Retrieve prices for a list of tokens in terms of the stable token.
get_pools: Retrieve all liquidity pools or swap pools depending on the flag.
get_pool_by_address: Retrieve detailed pool information by contract address.
get_pools_for_swaps: Retrieve all pools suitable for swaps and path finding.
get_latest_pool_epochs: Retrieve the latest epoch data for all pools.
get_pool_epochs: Retrieve historical epoch data for a given liquidity pool.
get_quote: Retrieve the best quote for swapping a given amount from one token to another.
swap: Execute a token swap transaction.
get_pools_by_token: Retrieve liquidity pools that contain a specific token.
get_pools_by_pair: Retrieve liquidity pools that contain a specific token pair.
get_pool_list: Retrieve liquidity pools based on specified criteria.

Usage

{
  "mcpServers": {
    "sugar-mcp": {
      "env": {
        "SUGAR_PK": "your_private_key_here",
        "SUGAR_RPC_URI_8453": "https://your-base-rpc-endpoint"
      },
      "command": "uvx",
      "args": [
        "sugar-mcp"
      ]
    }
  }
}

Building and Publishing to PyPI

To build and publish this package to PyPI:

Install build dependencies:
```
pip install build twine
```
Build the package:
```
python -m build
```
Upload to PyPI:
```
twine upload dist/*
```

Or if using Poetry (as specified in pyproject.toml):

poetry build
poetry publish

Metadata

Release files for sugar-mcp 0.3.22

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sugar-mcp 0.3.22
File	Size	Uploaded
sugar_mcp-0.3.22.tar.gz	13.4 kB	Dec 26, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for sugar-mcp 0.3.22
File	Interpreter	ABI	Platform	Reset
sugar_mcp-0.3.22-py3-none-any.whl 14.6 kB Dec 26, 2025	Python 3	none	any	Details

Total release size: 27.9 kB

Release files / sugar_mcp-0.3.22.tar.gz

Download URL	sugar_mcp-0.3.22.tar.gz
Size	13.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`99716e3fe51f8d6057ad019814cd96a1e9893af6db225bca64f8d463424ab192`
BLAKE2b-256 checksum How to use checksums	`a3859793defe3f80d609fa74986c5d9a8dbc190f5228902a6cf9f6a28b18fe95`
Upload date	Dec 26, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.2 CPython/3.12.9 Darwin/24.6.0`

Release files / sugar_mcp-0.3.22-py3-none-any.whl

Download URL	sugar_mcp-0.3.22-py3-none-any.whl
Size	14.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3d8293701e34abc6b97a8c3f44dadb71058bba6a4b88d5d4faa52d6258e0352f`
BLAKE2b-256 checksum How to use checksums	`cfa414e4dfdb6ee030397127a6e7916b85e0a5eb559a9f4b8adb013daf3c0e92`
Upload date	Dec 26, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.2 CPython/3.12.9 Darwin/24.6.0`