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.23

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.23
File	Size	Uploaded	Provenance
sugar_mcp-0.3.23.tar.gz	13.9 kB	Oct 22, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for sugar-mcp 0.3.23
File	Interpreter	ABI	Platform	Reset
sugar_mcp-0.3.23-py3-none-any.whl 15.0 kB Oct 22, 2026 Without provenance	Python 3	none	any	Details

Total release size: 28.8 kB

Release files / sugar_mcp-0.3.23.tar.gz

Download URL	sugar_mcp-0.3.23.tar.gz
Size	13.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`7a42cf9373d87e147f341ed9f3fc6883e54f05427ce72341ebc9b7039befacd8`
BLAKE2b-256 checksum How to use checksums	`f0b08966a94c8ec9ab7c7bc431cd0a6aa3e09325e343e6796b1715492f5aa3b7`
Upload date	Oct 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.16`

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

Download URL	sugar_mcp-0.3.23-py3-none-any.whl
Size	15.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a8ca13ad9597baecbefbd4a425e9164217fd6004cd582341d5b8a2f0cb798251`
BLAKE2b-256 checksum How to use checksums	`3882e1544cb2f4b6cb825a0efb452ce5f8f6e8a1762eb7ea8139c4dbbb0a0ee4`
Upload date	Oct 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.10.16`

Security for sugar-mcp 0.3.23

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.