Aiusd Trade Agent

Build Artifacts

This directory contains the final packaged skill files ready for distribution.

Contents

• *.skill - Packaged skill files (tarball format)
• build-info.json - Build metadata including version, size, and build time

Usage

Install a skill

# Extract the skill package
tar -xzf aiusd-skill-agent.skill

# Install dependencies (required)
cd aiusd-skill-agent/
npm install

# Setup authentication and test
npm run setup

Note: Starting from v1.1, skill packages exclude node_modules to stay under the 5MB size limit. Dependencies are installed automatically during setup.

🔐 Authentication Setup

After extracting and installing dependencies, you need to set up authentication to use AIUSD services.

Quick Setup (Recommended)

# Automatic setup with guided authentication
npm run setup

Method 1: Environment Variable (Simplest)

# Get your token from: https://mcp.alpha.dev/oauth/login
export MCP_HUB_TOKEN="Bearer your_jwt_token_here"

# Test the connection
npm test

Method 2: mcporter OAuth (Recommended)

# Install mcporter if needed
npm install -g mcporter

# OAuth login with browser
npx mcporter list --http-url https://mcp.alpha.dev/api/mcp-hub/mcp --name aiusd

# This will open a browser for OAuth login
# Credentials will be saved to ~/.mcporter/credentials.json

Method 3: Manual Token File

# Create token directory
mkdir -p ~/.mcp-hub

# Create token file (get token from OAuth login page)
cat > ~/.mcp-hub/token.json << 'EOF'
{
  "token": "Bearer your_token_here",
  "timestamp": 1738123456,
  "expires_in": 86400
}
EOF

🔄 Re-authentication (Clear Cache)

If you encounter authentication issues or need to switch accounts:

# Clear all cached authentication and re-login
npm run reauth

# This will:
# 1. Clear ~/.mcporter/ cache
# 2. Clear ~/.mcp-hub/ tokens
# 3. Start fresh OAuth login
# 4. Verify new authentication works

Authentication Priority

The skill checks authentication in this order:

1. Environment variables (MCP_HUB_TOKEN, AIUSD_TOKEN)
2. mcporter credentials (~/.mcporter/credentials.json)
3. Local token files (~/.mcp-hub/token.json)

Troubleshooting

• 401 Unauthorized: Run npm run reauth to clear cache and re-login
• Token expired: Re-run any of the authentication methods above
• Connection failed: Check if MCP server is accessible

Distribution

# Copy skill file to deployment location
cp aiusd-skill-agent.skill /path/to/skills/directory/

# Or upload to CDN, share via GitHub releases, etc.

Build Process

Skills are built using:

npm run build-skill

This creates:

1. A temporary build directory with all necessary files
2. A compressed .skill tarball in this directory
3. Build metadata for tracking versions and sizes

Version Control

This directory is tracked in git to:

• Provide ready-to-use skill packages
• Track build history and versions
• Enable easy distribution via GitHub releases
• Allow users to download skills without building

File Naming

Skill files follow the pattern: {package-name}-{type}.skill

• aiusd-skill-agent.skill - Main AIUSD trading skill for Claude Code

Automation

Future improvements could include:

• Automated builds on CI/CD
• GitHub releases with attached skill files
• Version-based file naming
• Multi-format packaging (zip, tar.gz, etc.)