# Required
Node.js >= 18.0.0
npm >= 9.0.0

# Clone the repository
git clone https://github.com/Tairon-ai/scrt-network-mcp.git
cd scrt-network-mcp/mcp-server

# Install dependencies
npm install

# Configure environment (optional for transactions)
cp .env.example .env
# Edit .env only if you want transaction capabilities

# Start the server
npm start

# Development mode
npm run dev

# MCP stdio server for Claude Desktop
npm run mcp

{
  "mcpServers": {
    "scrt-network": {
      "command": "node",
      "args": ["/path/to/scrt-network-mcp/mcp-server/mcp/index.js"],
      "env": {
        "SCRT_LCD_ENDPOINT": "https://lcd.mainnet.secretsaturn.net",
        "SCRT_RPC_ENDPOINT": "https://rpc.mainnet.secretsaturn.net",
        "SCRT_WALLET_ADDRESS": "",  // Optional: Your Secret address
        "SCRT_WALLET_MNEMONIC": ""  // Optional: Your mnemonic phrase
      }
    }
  }
}

// Request
{
  "tool": "get_blockchain_info",
  "params": {}
}

// Response includes
{
  "chainId": "secret-4",
  "height": "12345678",
  "latestBlock": {
    "hash": "0x...",
    "time": "2024-01-01T00:00:00Z"
  }
}

{
  "tool": "generate_wallet",
  "params": {}
}

// Response includes
{
  "address": "secret1abc...",
  "mnemonic": "word1 word2 ... word24",
  "privateKey": "hex_private_key",
  "publicKey": "hex_public_key",
  "warning": "IMPORTANT: Save these credentials securely!"
}

{
  "tool": "get_account_balance",
  "params": {
    "address": "secret1..." // Optional if wallet configured
  }
}

{
  "tool": "send_tokens",
  "params": {
    "to_address": "secret1abc...",
    "amount": "1000000",  // 1 SCRT in uscrt
    "denom": "uscrt",
    "memo": "Payment"
  }
}

{
  "tool": "ibc_transfer",
  "params": {
    "to_address": "cosmos1...",
    "amount": "1000000",
    "source_channel": "channel-0",
    "denom": "uscrt"
  }
}

{
  "tool": "query_smart_contract",
  "params": {
    "address": "secret1contract...",
    "query": {
      "balance": {
        "address": "secret1user..."
      }
    }
  }
}

{
  "tool": "get_governance_proposals",
  "params": {
    "status": "PROPOSAL_STATUS_VOTING_PERIOD"
  }
}

{
  "tool": "execute_contract",
  "params": {
    "contract_address": "secret1contract...",
    "msg": {
      "transfer": {
        "recipient": "secret1...",
        "amount": "1000000"
      }
    }
  }
}

{
  "tool": "grant_fee_allowance",
  "params": {
    "grantee_address": "secret1...",
    "spend_limit": "1000000"  // 1 SCRT limit
  }
}

"What's the current height of Secret Network?"
"Show me the latest block information"
"Get Secret Network node sync status"
"What are the network staking parameters?"
"Show me the slashing parameters"
"Get governance voting parameters"
"What's the current inflation rate?"
"Show network mint parameters"
"Get distribution parameters"
"What chain ID is Secret Network using?"

"Show me all active validators on Secret Network"
"Get unbonding validators"
"Find unbonded validators"
"Show validator details for secret1valoper..."
"Get top validators by voting power"
"Show validator commission rates"
"Find validators with low commission"
"Get validator uptime information"
"Show jailed validators"
"Find validators accepting delegations"

"Check my SCRT balance"
"Get balance for secret1abc..."
"Show all balances for my wallet"
"Check account balance in SCRT"
"Get token balances for address"
"Show my available balance"
"Check staking rewards"
"Get unbonding amounts"
"Show total portfolio value"
"Check vesting account balance"

"Send 10 SCRT to secret1abc..."
"Transfer 100 SCRT to this address"
"Send tokens with memo 'Payment'"
"Transfer 0.5 SCRT to my friend"
"Send maximum amount to secret1..."
"Transfer tokens from my wallet"
"Send SCRT with custom fee"
"Transfer tokens with high priority"
"Send all my SCRT to..."
"Make a payment of 50 SCRT"

"Transfer SCRT to Cosmos Hub via IBC"
"Send tokens to Osmosis through channel-1"
"IBC transfer to Juno Network"
"Bridge SCRT to Terra"
"Send tokens cross-chain to Akash"
"Transfer to cosmos1... via IBC"
"Bridge 100 SCRT to Osmosis"
"Send tokens to another blockchain"
"IBC transfer with timeout"
"Cross-chain transfer to Stride"

"Get my recent transactions"
"Show transaction hash ABC123..."
"Find transactions for my wallet"
"Get last 50 transactions"
"Show transactions from today"
"Find failed transactions"
"Get successful transfers"
"Show IBC transactions"
"Find transactions with memo"
"Get transaction details for..."

"Show my staking delegations"
"Get unbonding delegations"
"Check staking rewards"
"Show delegation to validator X"
"Get total staked amount"
"Check rewards from all validators"
"Show pending rewards"
"Get staking APR"
"Find best validators to stake with"
"Show my staking portfolio"

"Show active governance proposals"
"Get proposals in voting period"
"Show passed proposals"
"Get rejected proposals"
"Find proposals in deposit period"
"Show proposal #123 details"
"Get governance proposal history"
"Find proposals about staking"
"Show community pool proposals"
"Get software upgrade proposals"

"Query secret contract at address..."
"Get contract info for secret1..."
"Search contracts with code ID 123"
"Execute transfer on contract"
"Query token balance on contract"
"Get contract code hash"
"Find all contracts by code ID"
"Execute swap on DEX contract"
"Query liquidity pool info"
"Migrate contract to new code"

"Grant fee allowance to secret1..."
"Allow address X to pay my fees"
"Revoke fee grant for address"
"Set 10 SCRT fee allowance"
"Create fee grant with expiry"
"Show my fee grants"
"Check who can pay my fees"
"Remove fee allowance"
"Grant unlimited fee allowance"
"Set daily fee limit"

"Create vesting account for employee"
"Set up 1 year vesting schedule"
"Create delayed vesting account"
"Lock 1000 SCRT until next year"
"Create vesting with cliff period"
"Set up token vesting plan"
"Create continuous vesting"
"Lock tokens for 6 months"
"Create vesting for team member"
"Set up investor vesting"

"Generate new Secret Network wallet"
"Create new wallet with mnemonic"
"Generate wallet for testing"
"Create fresh wallet address"
"Get new wallet credentials"
"Generate wallet for user"
"Create wallet with private key"
"Make new Secret account"
"Generate secure wallet"
"Create wallet for staking"

"Create multisig transaction"
"Set up 2-of-3 multisig"
"Create transaction for signing"
"Generate multisig address"
"Create unsigned transaction"
"Set threshold for multisig"
"Add signers to multisig"
"Create complex multisig tx"
"Set up corporate multisig"
"Create multisig with 5 signers"

"Show wallet configuration status"
"Get default wallet address"
"Check if wallet is configured"
"Show available signing capabilities"
"Get chain configuration"
"Check LCD endpoint status"
"Show RPC connection info"
"Get network chain ID"
"Check wallet signing ability"
"Show environment configuration"

"Execute private computation"
"Query encrypted contract state"
"Send private transaction"
"Execute secret contract function"
"Query private data"
"Interact with privacy token"
"Execute confidential swap"
"Query encrypted balance"
"Send private message"
"Execute sealed bid auction"

"Calculate total value locked"
"Show network statistics"
"Get transaction volume today"
"Show active addresses count"
"Calculate staking ratio"
"Get network participation rate"
"Show IBC volume statistics"
"Calculate average block time"
"Get validator performance metrics"
"Show network growth metrics"

"Deploy smart contract"
"Query contract admin"
"Update contract code"
"Set contract metadata"
"Get contract source code"
"Verify contract code"
"Instantiate contract"
"Query contract schema"
"Get contract permissions"
"Check contract migration history"

"Check mainnet status"
"Get testnet information"
"Show network peers"
"Get consensus state"
"Check network latency"
"Show connected nodes"
"Get network topology"
"Check sync progress"
"Show mempool status"
"Get pending transactions"

# Start production server
NODE_ENV=production npm start

# With PM2
pm2 start mcp/index.js --name scrt-network-mcp

# With Docker
docker build -t scrt-network-mcp .
docker run -d -p 8080:8080 --env-file .env scrt-network-mcp

# Server Configuration
PORT=8080

# Secret Network endpoints
SCRT_LCD_ENDPOINT=https://lcd.mainnet.secretsaturn.net
SCRT_RPC_ENDPOINT=https://rpc.mainnet.secretsaturn.net
SCRT_NETWORK=mainnet
SCRT_CHAIN_ID=secret-4

# Wallet Configuration (optional for transactions)
SCRT_WALLET_ADDRESS=secret1...
SCRT_WALLET_MNEMONIC="your twelve word mnemonic phrase..."
# OR use private key instead
# SCRT_WALLET_PRIVATE_KEY=your_private_key_here

# Optional
REQUEST_TIMEOUT=30000
DEBUG=false

# Fork the repository on GitHub, then clone
git clone https://github.com/Tairon-ai/scrt-network-mcp

# Create feature branch
git checkout -b feature/amazing-feature

# Make changes and test
npm test

# Commit and push
git commit -m 'feat: add amazing feature'
git push origin feature/amazing-feature

# Open Pull Request