About SparkMango
SparkMango generates Python server implementations from Solidity contracts for developers who need API-based contract interaction. It also supports contract state management and event handling.
Key features
- 01Generate Python implementations from Solidity
- 02Automate server generation
- 03Manage contract variable state
- 04Provide RESTful API endpoints
- 05Handle contract events
- 06Include a testing framework
Use cases
- 01Convert contracts into Python servers
- 02Call contracts through a RESTful API
- 03Manage contract variables and events
- 04Test generated server implementations
MCP support
SparkMango is an MCP server that generates server implementations from Solidity bytecode.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMESparkMango

A Model Context Protocol (MCP) server that converts Solidity bytecode into a functional server implementation.
Overview
SparkMango provides a bridge between Solidity smart contracts and Python-based server applications. It automatically generates server implementations from Solidity contracts, making it easier to interact with blockchain contracts through a RESTful API.
Features
- Convert Solidity contracts to Python implementations
- Automatic server generation
- State management for contract variables
- RESTful API endpoints
- Event handling
- Comprehensive testing framework
Installation
pip install mcp-server
Usage
- Generate a server from a Solidity contract:
mcp-server generate --contract path/to/contract.json --output output_directory
- Start the server:
mcp-server start --port 8000
Development
Setup
- Clone the repository:
git clone https://github.com/ArjunBhuptani/sparkmango.git
cd sparkmango
- Install dependencies:
pip install -r requirements.txt
pip install -r requirements-test.txt
Testing
Run the test suite:
python -m pytest
Documentation
For detailed documentation, please refer to the docs directory.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Project Status
For current project status and upcoming features, see PROJECT_STATUS.md.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.