Osmosis

Overview

This repository contains a collection of packages that are used to build the Osmosis Agent Toolkit. Large Language Models (LLMs) can use these tools to interact with the Osmosis protocol.

Packages

@osmosis-agent-toolkit/core

The core package contains the core functionality that is used by the other packages. This is where registry data, query clients, and sign and broadcast logic is defined.

@osmosis-agent-toolkit/ai-sdk

An implementation of Vercel's AI SDK for the Osmosis Agent Toolkit.

@osmosis-agent-toolkit/mcp

Model Context Protocol (MCP) server implementation of the Osmosis Agent Toolkit.

Usage with Claude Desktop or Cursor

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

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

Development

Install dependencies using yarn or bun:

bun i

Start watch mode for local development:

bun run dev

To build:

bun run build