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: | Flag | Description | |------|-------------| | --json | Output as JSON | | --format | Output format: text/json/csv/table | | -o, --output-file | Write output to file | | --no-color | Disable colors | | --no-emoji | Disable emoji | | --timestamps | Show timestamps | | -q, --quiet | Quiet mode (errors only) | | -v, --verbose | Verbose logging | | --debug | Debug mode (show stack traces) |

Path Overrides: | Flag | Description | |------|-------------| | --config-file | Custom config file path | | --wallet-file | Custom wallet file path | | --log-file | Custom log file path |

Network Options: | Flag | Description | |------|-------------| | --network | mainnet/devnet/testnet | | --api-url | Override API endpoint | | --rpc-url | Override RPC endpoint | | --proxy | HTTP proxy URL | | --user-agent | Custom user agent |

Behavior: | Flag | Description | |------|-------------| | --timeout | Request timeout (seconds) | | --retry-count | Number of retries | | --priority-fee | Priority fee (microlamports) | | --skip-balance-check | Skip balance verification | | -y, --yes | Skip confirmation prompts |

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