
Arcontextify
โ 8from aorumbayev
Convert ARC-56 smart contract specifications to MCP servers.
๐ฅ๐ฅโ VerifiedAccount requiredNeeds API keys
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
Generated Server
Each server includes:
Environment Variables
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 readonlyClaude Desktop Config
{
"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 configurationget_connection_info()- Connection statusget_application_state()- Global stateget_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
Copy & paste โ that's it
pipx install arcontextify
# or
uv tool install arcontextifyBefore it works, you'll need: ALGORAND_ALGOD_TOKENALGORAND_ALGOD_SERVERALGORAND_APP_ID
Installation
pipx install arcontextify
# or
uv tool install arcontextifyUsage
# 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 ./serversRequirements
- Python 3.10+
- UV package manager
- AlgoKit Utils 2.0+
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
License
MIT
