@osmosis-agent-toolkit/mcp

Osmosis Model Context Protocol

Provides an Osmosis implementation of the Model Context Protocol server given an account mnemonic. This enables MCP clients to interact with a given Osmosis account.

Setup

To run the Osmosis MCP server using npx, use the following command:

npx -y @osmosis-agent-toolkit/mcp --mnemonic='$MNEMONIC'
# Start with OSMOSIS_MNEMONIC environment variable
npx -y @osmosis-agent-toolkit/mcp

Usage with Claude Desktop or Cursor

Add the following to your claude_desktop_config.json or .cursor/settings.json. See here for more details.

{
    "mcpServers": {
        "Osmosis": {
            "command": "npx",
            "args": [
                "-y",
                "@osmosis-agent-toolkit/mcp"
            ],
            "env": {
                "OSMOSIS_MNEMONIC": "<your mnemonic here>"
            }
        }
    }
}

Debugging the Server

To debug your server, you can use the MCP Inspector.

First build the server

bun run build

Run the following command in your terminal:

# Start MCP Inspector and server
npx @modelcontextprotocol/inspector bun dist/index.js --mnemonic='$MNEMONIC'
# Start MCP Inspector and server with OSMOSIS_MNEMONIC environment variable
npx @modelcontextprotocol/inspector bun dist/index.js

Instructions

• Replace MNEMONIC with your actual Osmosis mnemonic. Or set the OSMOSIS_MNEMONIC environment variable.
• Run the command to start the MCP Inspector.
• Open the MCP Inspector UI in your browser and click Connect to start the MCP server.
• You can see the list of tools you selected and test each tool individually.