{"id":28918316,"url":"https://github.com/aorumbayev/arcontextify","last_synced_at":"2025-06-25T05:03:12.175Z","repository":{"id":299914725,"uuid":"1004622086","full_name":"aorumbayev/arcontextify","owner":"aorumbayev","description":"Algorand ARC-56 to MCP server converter","archived":false,"fork":false,"pushed_at":"2025-06-18T23:39:06.000Z","size":0,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-19T00:27:13.430Z","etag":null,"topics":["ai","algokit","algorand","fastmcp","mcp","python","smart-contracts"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aorumbayev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-18T23:27:12.000Z","updated_at":"2025-06-19T00:11:22.000Z","dependencies_parsed_at":"2025-06-19T00:37:23.348Z","dependency_job_id":null,"html_url":"https://github.com/aorumbayev/arcontextify","commit_stats":null,"previous_names":["aorumbayev/arcontextify"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aorumbayev/arcontextify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aorumbayev%2Farcontextify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aorumbayev%2Farcontextify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aorumbayev%2Farcontextify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aorumbayev%2Farcontextify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aorumbayev","download_url":"https://codeload.github.com/aorumbayev/arcontextify/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aorumbayev%2Farcontextify/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261224290,"owners_count":23126930,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","algokit","algorand","fastmcp","mcp","python","smart-contracts"],"created_at":"2025-06-22T02:02:38.785Z","updated_at":"2025-06-24T04:02:19.293Z","avatar_url":"https://github.com/aorumbayev.png","language":"Python","funding_links":[],"categories":["AI and Machine Learning"],"sub_categories":["Metrics and Analytics Services"],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://ibb.co/39mShM2H\"\u003e\u003cimg src=\"https://i.ibb.co/VcYMBQR8/Qm-Zqt55w-HXr-Zzh-Bih-SVz-XDvwp9rguv-LAv-Fh-Um1q-JR6-GYe-Q.png\" alt=\"Qm-Zqt55w-HXr-Zzh-Bih-SVz-XDvwp9rguv-LAv-Fh-Um1q-JR6-GYe-Q\" border=\"0\" width=\"60%\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n---\n\nConvert ARC-56 smart contracts to MCP servers for AI agent integration.\n\n\u003e Disclaimer: this is an experimental proof of concept tool. It is not intended for production use and may contain bugs or incomplete features.\n\n## Features\n\n- 🔄 Converts ARC-56 specs to MCP servers\n- 🛡️ Secure environment-based configuration  \n- 🎯 Call type filtering (readonly/write-only/both)\n- 🧪 Simulation mode for safe testing\n- ⚡ AlgoKit Utils integration\n- 📦 UV-based project generation\n\n## Installation\n\n```bash\npipx install arcontextify \n# or\nuv tool install arcontextify\n```\n\n## Usage\n\n```bash\n# Generate MCP server\narcontextify contract.arc56.json\n\n# Readonly calls only (no private key needed)\narcontextify contract.arc56.json --call-types readonly\n\n# Write calls only \narcontextify contract.arc56.json --call-types write-only\n\n# Custom output directory\narcontextify contract.arc56.json --output-dir ./servers\n```\n\n## Generated Server\n\nEach server includes:\n\n### Environment Variables\n```bash\nexport ALGORAND_ALGOD_TOKEN=\"your-token\"\nexport ALGORAND_ALGOD_SERVER=\"https://testnet-api.algonode.cloud\"  \nexport ALGORAND_APP_ID=\"123456\"\nexport ALGORAND_DELEGATED_PRIVATE_KEY=\"your-key\"  # Not needed for readonly\n```\n\n### Claude Desktop Config\n```json\n{\n  \"mcpServers\": {\n    \"contract_mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"python\", \"-m\", \"src.contract_mcp\"],\n      \"cwd\": \"/path/to/contract_mcp\",\n      \"env\": {\n        \"ALGORAND_ALGOD_TOKEN\": \"your-token\",\n        \"ALGORAND_ALGOD_SERVER\": \"https://testnet-api.algonode.cloud\",\n        \"ALGORAND_APP_ID\": \"123456\"\n      }\n    }\n  }\n}\n```\n\n### Available Tools\n- `verify_environment_setup()` - Check configuration\n- `get_connection_info()` - Connection status  \n- `get_application_state()` - Global state\n- `get_account_local_state(address)` - Local state\n- Contract methods with simulation support\n\n## Security\n\n- Environment-based secrets (no hardcoded keys)\n- Dummy accounts for readonly operations\n- Transaction simulation for safe testing\n- Address validation and input sanitization\n\n## Requirements\n\n- Python 3.10+\n- UV package manager\n- AlgoKit Utils 2.0+\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faorumbayev%2Farcontextify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faorumbayev%2Farcontextify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faorumbayev%2Farcontextify/lists"}