aorumbayev/arcontextify

3.4

If you are the rightful owner of arcontextify and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

ARC-56 to MCP server conversion tool for AI agent integration.

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

pipx install arcontextify 
# or
uv tool install arcontextify

Usage

# 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

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

{
  "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