https://github.com/aorumbayev/arcontextify
Algorand ARC-56 to MCP server converter
https://github.com/aorumbayev/arcontextify
ai algokit algorand fastmcp mcp python smart-contracts
Last synced: 3 months ago
JSON representation
Algorand ARC-56 to MCP server converter
- Host: GitHub
- URL: https://github.com/aorumbayev/arcontextify
- Owner: aorumbayev
- License: mit
- Created: 2025-06-18T23:27:12.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2025-06-18T23:39:06.000Z (4 months ago)
- Last Synced: 2025-06-19T00:27:13.430Z (4 months ago)
- Topics: ai, algokit, algorand, fastmcp, mcp, python, smart-contracts
- Language: Python
- Homepage:
- Size: 0 Bytes
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
Convert ARC-56 smart contracts to MCP servers for AI agent integration.
> Disclaimer: this is an experimental proof of concept tool. It is not intended for production use and may contain bugs or incomplete features.
## Features
- 🔄 Converts ARC-56 specs to MCP servers
- 🛡️ Secure environment-based configuration
- 🎯 Call type filtering (readonly/write-only/both)
- 🧪 Simulation mode for safe testing
- ⚡ AlgoKit Utils integration
- 📦 UV-based project generation
## Installation
```bash
pipx install arcontextify
# or
uv tool install arcontextify
```
## Usage
```bash
# Generate MCP server
arcontextify contract.arc56.json
# Readonly calls only (no private key needed)
arcontextify contract.arc56.json --call-types readonly
# Write calls only
arcontextify contract.arc56.json --call-types write-only
# Custom output directory
arcontextify contract.arc56.json --output-dir ./servers
```
## Generated Server
Each server includes:
### Environment Variables
```bash
export ALGORAND_ALGOD_TOKEN="your-token"
export ALGORAND_ALGOD_SERVER="https://testnet-api.algonode.cloud"
export ALGORAND_APP_ID="123456"
export ALGORAND_DELEGATED_PRIVATE_KEY="your-key" # Not needed for readonly
```
### Claude Desktop Config
```json
{
"mcpServers": {
"contract_mcp": {
"command": "uv",
"args": ["run", "python", "-m", "src.contract_mcp"],
"cwd": "/path/to/contract_mcp",
"env": {
"ALGORAND_ALGOD_TOKEN": "your-token",
"ALGORAND_ALGOD_SERVER": "https://testnet-api.algonode.cloud",
"ALGORAND_APP_ID": "123456"
}
}
}
}
```
### Available Tools
- `verify_environment_setup()` - Check configuration
- `get_connection_info()` - Connection status
- `get_application_state()` - Global state
- `get_account_local_state(address)` - Local state
- Contract methods with simulation support
## Security
- Environment-based secrets (no hardcoded keys)
- Dummy accounts for readonly operations
- Transaction simulation for safe testing
- Address validation and input sanitization
## Requirements
- Python 3.10+
- UV package manager
- AlgoKit Utils 2.0+
## License
MIT