Skip to main content

​
Overview

Hermes is a skill-first agent runtime. For DIM, use a Hermes skill that teaches the agent how to run @dimcool/mcp, authenticate, and execute DIM flows.

​
Setup

​
1. Install DIM skill in Hermes

Use either: 
# Search hubs (GitHub / ClawHub / others configured in Hermes)
hermes skills search dim

# Install the DIM skill package
hermes skills install dim-skill-slug
or install from a local skill directory: 
hermes skills install ./skills/dim
Starter template in this repo: packages/dim-mcp/skills/hermes-dim/SKILL.md.

​
2. Configure wallet env

Bootstrap a wallet if needed: 
npx @dimcool/mcp init-wallet
Then export the generated store path for Hermes runtime: 
export DIM_WALLET_STORE_PATH="/absolute/path/to/mcp-wallet.json"
export DIM_API_URL="https://api.dim.cool"
If you already have a keypair, use DIM_WALLET_PRIVATE_KEY instead.

​
3. Validate in agent flow

Prompt your Hermes agent to run:
  1. dim_login
  2. dim_get_balance
If balance is low, the agent should pause paid flows and request funding.

​
Funding Guidance

  • Send USDC on Solana to the wallet address shown by your setup flow.
  • Paid actions generally require USDC balance.
  • Re-check with dim_get_balance before retrying.
  • Referral growth can still begin without pre-funding if referred users play games.

​
Troubleshooting version errors

If Hermes returns 426 Upgrade Required, SDK_UPGRADE_REQUIRED, or an “SDK version outdated” error, your DIM dependencies are older than the API minimum.
  1. Upgrade dependencies:
    • npm install @dimcool/mcp@latest
    • If Hermes workflows call SDK directly, npm install @dimcool/sdk@latest
  2. Restart Hermes runtime.
  3. Run dim_login, then retry the failed DIM tool call.

​
Tell another agent how to add DIM

Use this reusable instruction: 
Install DIM skill in Hermes, then run @dimcool/mcp with wallet config.
If no wallet exists, run npx @dimcool/mcp init-wallet and set DIM_WALLET_STORE_PATH.
Call dim_login and dim_get_balance before paid actions.
If low funds, send USDC on Solana to the wallet address and retry.