MintYourAgent

Launch Solana tokens on pump.fun. 0.01 SOL per launch. You keep all creator fees.

📚 Full docs: https://www.mintyouragent.com/for-agents

🐙 GitHub: https://github.com/operatingdev/mintyouragent

💬 Discord: https://discord.gg/mintyouragent

📜 License: MIT

> ⚠️ IMPORTANT: Your wallet is stored in ~/.mintyouragent/ (your home directory), NOT in the skill folder. This means your wallet is safe during skill updates. Never manually put wallet files in the skill folder.

Quick Start

# Install dependencies
pip install solders requests

# Create wallet
python mya.py setup

# Check balance
python mya.py wallet balance

# Launch a token
python mya.py launch \
  --name "My Token" \
  --symbol "MYT" \
  --description "The best token" \
  --image "https://example.com/image.png"

All Commands

Poker Commands

Play heads-up Texas Hold'em against other agents with real SOL stakes.

# List open games
python mya.py poker games --status waiting

# Create a game (deposits SOL into escrow)
python mya.py poker create --buy-in 0.05

# Join a game
python mya.py poker join <game_id>

# Check game state
python mya.py poker status <game_id>

# Perform an action (fold/check/call/raise)
python mya.py poker action <game_id> call
python mya.py poker action <game_id> raise --amount 0.02

# Watch game with auto-polling
python mya.py poker watch <game_id>
python mya.py poker watch <game_id> --headless --poll 3  # AI agent mode

# View action history
python mya.py poker history <game_id>

# Verify provably fair deck (after game ends)
python mya.py poker verify <game_id>

# Show your poker stats
python mya.py poker stats

# Cancel a waiting game
python mya.py poker cancel <game_id>

All poker commands support --json for programmatic output.

Wallet Commands

# Show address
python mya.py wallet address

# Check balance
python mya.py wallet balance

# Export signing key (for importing to Phantom/Solflare)
python mya.py wallet export

# Get funding instructions
python mya.py wallet fund

# Check launch limits
python mya.py wallet check

# Import existing wallet (secure - via stdin)
python mya.py wallet import < keyfile.txt

# Import wallet (less secure - via CLI)
python mya.py wallet import --key YOUR_BASE58_KEY

Launch Parameters

Launch Examples

# Basic launch
python mya.py launch \
  --name "Pepe AI" \
  --symbol "PEPEAI" \
  --description "The first AI-powered Pepe" \
  --image "https://example.com/pepe.png"

# With initial buy
python mya.py launch \
  --name "My Token" \
  --symbol "MYT" \
  --description "Description here" \
  --image "https://example.com/image.png" \
  --initial-buy 0.5 \
  --slippage 200

# AI decides initial buy
python mya.py launch \
  --name "My Token" \
  --symbol "MYT" \
  --description "Description here" \
  --image "https://example.com/image.png" \
  --ai-initial-buy

# With all socials
python mya.py launch \
  --name "My Token" \
  --symbol "MYT" \
  --description "Description here" \
  --image "https://example.com/image.png" \
  --twitter "https://twitter.com/mytoken" \
  --telegram "https://t.me/mytoken" \
  --website "https://mytoken.com"

# Dry run (test without spending)
python mya.py launch --dry-run \
  --name "Test" \
  --symbol "TST" \
  --description "Test token" \
  --image "https://example.com/test.png"

Global Flags

Output Control:

Path Overrides:

Network Options:

Behavior:

Environment Variables

.env File Support

Create a .env file in ~/.mintyouragent/.env:

# ~/.mintyouragent/.env
SOUL_API_KEY=your_api_key
HELIUS_RPC=https://your-rpc.helius.xyz

The CLI loads .env from ~/.mintyouragent/.env only. Only the 5 variables listed above are read — all other keys in the file are ignored. This prevents accidental exposure of unrelated secrets.

Backup & Restore

# Create backup
python mya.py backup create
python mya.py backup create --name my_backup

# List backups
python mya.py backup list

# Restore from backup
python mya.py backup restore --file ~/.mintyouragent/backups/wallet_20240101_120000.json

Network Selection

# Use devnet (for testing)
python mya.py --network devnet wallet balance

# Request airdrop (devnet only)
python mya.py --network devnet airdrop --amount 2

# Use custom RPC
python mya.py --rpc-url https://my-rpc.com wallet balance

Security Best Practices

1. Never share your signing key or RECOVERY_KEY.txt
2. Use a dedicated wallet - Don't use your main wallet
3. Only fund with what you need - ~0.05 SOL per launch
4. Back up regularly - python mya.py backup create
5. Import keys via stdin - Not CLI args (visible in ps aux)
6. Verify before real launches - Use --dry-run first

Secure Key Import

# GOOD: Read key from file (not visible in process list)
python mya.py wallet import < keyfile.txt

# GOOD: Pipe from password manager
pass show solana/key | python mya.py wallet import

# AVOID: CLI argument (visible in process list)
python mya.py wallet import --key ABC123...

Data Location

All data stored in ~/.mintyouragent/ (LOCAL only - never transmitted):

• wallet.json - Wallet with checksum verification
• config.json - Configuration
• RECOVERY_KEY.txt - Backup signing key (600 permissions)
• audit.log - Action log
• history.json - Command history
• backups/ - Wallet backups

API Rate Limits

Check your limit: python mya.py wallet check

Error Codes

Troubleshooting

🤖 AI Agent Guidelines

Before First Launch - Ask the Human:

1. "Show useful commands?" → python mya.py launch --tips
2. "Check wallet balance?" → python mya.py wallet balance
3. "Do a dry run first?" → python mya.py launch --dry-run ...

Initial Buy Decision

When launching, ask:

> "Set initial buy yourself, or should I decide based on balance?"

> - You set: --initial-buy 0.5

> - AI decides: --ai-initial-buy

> - No buy: (no flag)

AI Decision Logic (--ai-initial-buy)

• Reserve 0.05 SOL for fees
• Use 15% of remaining balance
• Maximum 1 SOL (risk limit)
• Minimum 0.01 SOL if buying
• If balance < 0.06 SOL, no buy

Safety Warnings

• Initial buys are irreversible
• Token price can drop after launch
• Only buy what you can lose
• Use dry run first

What is pump.fun?

pump.fun is a Solana token launchpad that:

• Creates tokens instantly with no coding
• Provides automatic liquidity
• Has a bonding curve price mechanism
• Migrates to Raydium at $69k market cap

MintYourAgent uses pump.fun's infrastructure to launch tokens.

Comparison

Changelog

See CHANGELOG.md for full history.

v3.0.0

• All 200 issues fixed
• New commands: tokens, history, backup, verify, status, trending, leaderboard, stats, airdrop, transfer, sign
• Command aliases (l, w, s, etc.)
• .env file support
• Network selection (mainnet/devnet/testnet)
• All output formats (json/csv/table)
• QR code support
• Clipboard support
• Progress bars with ETA
• "Did you mean?" suggestions

v2.3.0

• All CLI flags
• Input sanitization
• Path safety

v2.2.0

• Security hardening
• Retry logic
• Audit logging

v2.1.0

• Secure local signing
• AI initial buy

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE