FastMCP FastMCP
Sign In
O

Osmosis

Provides a bridge to the Osmosis blockchain protocol for executing decentralized finance operations ...

3 views
0 installs
Updated Dec 25, 2025
Not audited
Finance Developer Tools
Provides a bridge to the Osmosis blockchain protocol for executing decentralized finance operations like token swaps, balance queries, and account management

  1. Choose how you’ll obtain a mnemonic (recommended: Keplr browser extension)

    • Install Keplr (browser extension) and create a new wallet or open an existing mnemonic-based wallet. When you create a new wallet Keplr will show a recovery (seed) phrase — write it down exactly (12/24 words). If you already have a Keplr wallet you can view/export the mnemonic from the account menu (you’ll be asked for your Keplr password). (help.keplr.app)

  2. (Alternative) Create or export a mnemonic with another Cosmos-compatible wallet

    • You may instead use Osmosis-compatible wallets (Keplr, Leap, Cosmostation, etc.) to create or export a seed phrase. Always follow the wallet’s official export instructions and store the phrase securely. (keplr.crunch.help)

  3. Secure the mnemonic before using it

    • Store the phrase offline (paper/hardware wallet) and do NOT paste it into untrusted sites or share it. For testing, consider creating a new account with minimal funds to avoid risking mainnet assets. (Security best practice; do not share your mnemonic.)

  4. Open the FastMCP connection interface and click “Install Now”

    • In the FastMCP connection UI use the provided “Install Now” button to add the Osmosis MCP server.

  5. Fill the ENV field named OSMOSIS_MNEMONIC in the FastMCP connection form

    • In the form field labeled OSMOSIS_MNEMONIC paste your full mnemonic exactly as shown (all words in order, separated by single spaces). Do not add extra surrounding quotes unless the UI explicitly requires them.
    • Example value (do NOT use this example; replace with your real phrase):
      OSMOSIS_MNEMONIC: word1 word2 word3 … word12/24.
    • The Osmosis MCP server reads the mnemonic from this environment variable. (playbooks.com)

  6. Save the connection and start the MCP server

    • After saving the env value in FastMCP, start the server via the UI’s start/launch action (or use the equivalent npx command locally: npx -y @osmosis-agent-toolkit/mcp --mnemonic='your mnemonic here' or export OSMOSIS_MNEMONIC and run the package). (playbooks.com)

  7. (Optional) Debug with the MCP Inspector

    • If you need to debug the MCP server, run the MCP Inspector and start the server there; follow the MCP Inspector workflow to Connect and test tools. (modelcontextprotocol.io)

  8. Verify and test

    • Once running, verify the server responds in FastMCP/your MCP client (e.g., Claude Desktop) and test only safe operations first. If anything looks wrong, remove the mnemonic from the UI, rotate the account (create/import a new mnemonic), and investigate logs.

  9. If you prefer CLI setup instead of FastMCP

    • You can set the environment variable locally and run:
      • Unix/macOS: export OSMOSIS_MNEMONIC='your mnemonic here' then npx -y @osmosis-agent-toolkit/mcp
      • Windows (PowerShell): $env:OSMOSIS_MNEMONIC='your mnemonic here'; npx -y @osmosis-agent-toolkit/mcp
        (This mirrors the package’s documented usage.) (playbooks.com)

Quick Start

View on GitHub

More for Finance

View All →

More for Developer Tools

View All →

Report Issue

Thank you! Your issue report has been submitted successfully.