CosmWasm Blockchain
About
Bridges with CosmWasm-based blockchains using cw-orchestrator, enabling querying contract state, executing transactions, checking balances, and retrieving blockchain information without direct access to underlying infrastructure.
Details
- Author
- adairrr
- Repository
- adairrr/cosmwasm-mcp
- GitHub stars
- 1
- Downloads
- 267
- Categories
- AI, Design, Developer Tools, Search, Knowledge Base, Infrastructure, Other
- Tags
- #integration
Jump to
- Built in Rust using the cw-orchestrator SDK
- Enables AI agents to query CosmWasm smart contracts
- Supports contract state queries (e.g., get_count)
- Supports contract execution (e.g., increment)
- Supports address balance queries
- Uses standard input/output MCP transport (stdio)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
CosmWasm BlockchainCommand (node, npx, python, etc.)PATH-TO/rust-sdk/target/release/examples/cw-orch-mcpEnvironment-
RUST_LOG
info -
TEST_MNEMONIC
<24 word mnemonic>
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
RUST_LOG
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Build the server binary with cargo build --release, then configure it in your MCP client (e.g., Claude Desktop) by adding the binary path, empty args, and environment variables TEST_MNEMONIC and RUST_LOG to the client's configuration file. Restart the client to see the MCP UI elements, then send natural‑language prompts to query contracts, execute transactions, or check balances.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"cosmwasm blockchain": {
"env": {
"RUST_LOG": "info",
"TEST_MNEMONIC": "<24 word mnemonic>"
},
"args": [],
"command": "PATH-TO/rust-sdk/target/release/examples/cw-orch-mcp"
}
}
}Linux
{
"env": {
"RUST_LOG": "info",
"TEST_MNEMONIC": "<24 word mnemonic>"
},
"args": [],
"command": "PATH-TO/rust-sdk/target/release/examples/cw-orch-mcp"
}Macos
{
"env": {
"RUST_LOG": "info",
"TEST_MNEMONIC": "<24 word mnemonic>"
},
"args": [],
"command": "PATH-TO/rust-sdk/target/release/examples/cw-orch-mcp"
}Windows
{
"env": {
"RUST_LOG": "info",
"TEST_MNEMONIC": "<24 word mnemonic>"
},
"args": [],
"command": "PATH-TO/rust-sdk/target/release/examples/cw-orch-mcp.exe"
}CosmWasm MCP Server
A Model Context Protocol (MCP) server that provides tools for interacting with CosmWasm smart contracts, enabling AI agents to manage and interact with blockchain-based contracts programmatically. Learn more at Model Context Protocol.This MCP server is written in Rust and uses cw-orchestrator to interact with CosmWasm smart contracts.
Get started
1. Build the Server (Counter Example)
cargo build --release
This builds a standard input/output MCP server binary.
2. Add or update this section in your PATH-TO/claude_desktop_config.json
Windows
{
"mcpServers": {
"cosmwasm-mcp": {
"command": "PATH-TO/rust-sdk/target/release/examples/cw-orch-mcp.exe",
"args": [],
"env": {
"TEST_MNEMONIC": "<24 word mnemonic>",
"RUST_LOG": "info"
}
}
}
}
MacOS/Linux (~/Library/Application\ Support/Claude/claude_desktop_config.json)
{
"mcpServers": {
"cosmwasm-mcp": {
"command": "PATH-TO/rust-sdk/target/release/examples/cw-orch-mcp",
"args": [],
"env": {
"TEST_MNEMONIC": "<24 word mnemonic>",
"RUST_LOG": "info"
}
}
}
}
3. Ensure that the MCP UI elements appear in Claude Desktop
The MCP UI elements will only show up in Claude for Desktop if at least one server is properly configured. It may require to restart Claude for Desktop.
4. Once Claude Desktop is running, try chatting:
Please query neutron14kjnjnmeyz2pzaa9ga50dnsu5dwr39q0jhnz50nwr6yyqdkg6ayqwfsur2 for get_count.
Please increment neutron14kjnjnmeyz2pzaa9ga50dnsu5dwr39q0jhnz50nwr6yyqdkg6ayqwfsur2
Please get the balance of neutron14kjnjnmeyz2pzaa9ga50dnsu5dwr39q0jhnz50nwr6yyqdkg6ayqwfsur2
TODO
- [ ] Don't hardcode chain, allow to be passed in by env or into any command
- [ ] Instantiate a contract
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
