🧪 Skills

mintyouragent

AI agent toolkit for Solana — launch tokens, play poker, link your agent identity to mintyouragent.com. Reads agent personality files (SOUL.md) for profile l...

v3.6.3
⭐ —
❤️ 2
⬇️ 2.1k
👁 1
Save📁 Collect
Share

Description

name: mintyouragent description: AI agent toolkit for Solana — launch tokens, play poker, link your agent identity to mintyouragent.com. Reads agent personality files (SOUL.md) for profile linking. Stores wallet in ~/.mintyouragent/. Pure Python CLI. version: 3.6.3

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

Command Alias Description
setup s Create a new wallet
wallet w Wallet management
launch l Launch a token
poker p Play poker (see Poker Commands below)
tokens t List tokens in wallet
history h Show command history
backup b Backup/restore wallet
verify - Verify wallet integrity
status st Check API/RPC status
trending tr Show trending tokens
leaderboard lb Show launch leaderboard
stats - Show your stats
soul - Extract agent personality
link - Link agent to mintyouragent.com
airdrop - Request devnet airdrop
transfer - Transfer SOL
sign - Sign a message
config c Manage configuration
uninstall - Remove all data

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

Param Required Description
--name ✅ Token name (max 32 chars)
--symbol ✅ Ticker (max 10 chars, ASCII only)
--description ✅ Token description (max 1000 chars)
--image ✅ Image URL (HTTPS)
--image-file alt Local image path (max 5MB)
--banner ❌ Banner image URL (HTTPS)
--banner-file alt Local banner path (max 5MB)
--twitter ❌ Twitter/X link (HTTPS)
--telegram ❌ Telegram link (HTTPS)
--website ❌ Website link (HTTPS)
--initial-buy ❌ Initial buy in SOL (default: 0)
--ai-initial-buy ❌ Let AI decide buy amount
--slippage ❌ Slippage in bps (default: 100 = 1%)
--dry-run ❌ Test without launching
--preview ❌ Preview parameters
--tips ❌ Show first-launch tips
-y, --yes ❌ Skip confirmation prompts

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

Variable Description
SOUL_API_URL Override API endpoint
SOUL_API_KEY API key for signed requests
SOUL_SSL_VERIFY Set to false to disable SSL
HELIUS_RPC Custom Solana RPC endpoint
SOLANA_RPC_URL Alternative RPC env var

.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

Tier Daily Launches
Free 3
With $SOUL token More based on holdings

Check your limit: python mya.py wallet check

Error Codes

Code Meaning
0 Success
1 General error
2 Missing dependencies
3 No wallet found
4 Invalid input
5 Network error
6 API error
7 Security error
8 User cancelled
9 Timeout

Troubleshooting

Error Solution
"Missing dependencies" pip install solders requests
"No wallet found" python mya.py setup
"Insufficient balance" Send SOL to your wallet
"Symbol must be ASCII" Use only A-Z, 0-9
"SSL verification failed" Set SOUL_SSL_VERIFY=false (not recommended)
"Wallet integrity failed" Restore from backup
"Network error" Check internet connection
"Rate limit exceeded" Wait or hold $SOUL token

🤖 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

Feature MintYourAgent Raw pump.fun Other CLIs
AI Integration ✅ ❌ ❌
Local Signing ✅ ✅ ❌
CLI ✅ ❌ ✅
Open Source ✅ ❌ Varies

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

Reviews (0)

Sign in to write a review.

No reviews yet. Be the first to review!

Comments (0)

Sign in to join the discussion.

No comments yet. Be the first to share your thoughts!

Compatible Platforms

Links

📂 Source Code

Pricing

Free

Related Configs

🧪 Skill

self-improving-agent

Free

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...

❤️ 2.0k ⬇️ 218k
🧪 Skill

Self Improving Agent

Free

Captures learnings, errors, and corrections to enable continuous improvement. And also 50+ models for image generation, video generation, text-to-speech, spe...

❤️ 2.0k ⬇️ 206k
🧪 Skill

Find Skills

Free

Search, discover, and install skills from the open agent skills ecosystem to extend agent capabilities for specific tasks or domains.

❤️ 814 ⬇️ 199k
🧪 Skill

Summarize

Free

--- name: summarize description: Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube). homepage: https://summarize.sh metadata: {"clawdbot":{"emoji":"🧾","requires":{"b

❤️ 609 ⬇️ 160k