Quick Start

Deploy web apps and APIs to a public URL with a single command. No config, no Docker, no CI pipeline.

npx agentscale register   # get an API key (saved to ~/.agentscale)
npx agentscale deploy     # package and deploy the current directory

Your app gets a public .agentscale.app URL on deploy.

Example Deploy Output

Packaging project...
Uploading tarball (123.4 KB)...
Deployed to service: quick-fox-1234
Free tier: service will expire in 24 hours. Add credits for permanent deploys.
URL: https://quick-fox-1234.agentscale.app
Your service should be live shortly.

Supports Node.js, Python, Go, and anything Nixpacks can detect.

Authentication

AgentScale uses API keys for authentication. Your API key is generated during registration and stored locally.

API Key Storage

When you run npx agentscale register, your API key is saved to:

~/.agentscale/config.json

How It Works

The CLI automatically includes your API key in the x-api-key header for all requests to the AgentScale API.

Environment Variable

You can override the default API URL by setting:

export AGENTSCALE_API_URL=https://api.agentscale.co

Warning: This redirects all API calls, including those carrying your API key, to the specified URL.

Commands Reference

agentscale register

Creates an API key and saves it to ~/.agentscale/config.json. No account or payment needed.

npx agentscale register

agentscale deploy

Packages the current directory and deploys it to AgentScale.

npx agentscale deploy              # auto-generates a service name
npx agentscale deploy --name myapp # deploy to a specific service

Options:

• --name <name> — Specify a service name (auto-generated if omitted)

Returns:

• Service name
• Public URL: https://<service-name>.agentscale.app
• Expiry notice (if on free tier)

agentscale list

Lists your services, their status, and URLs.

npx agentscale list

Example Output:

Your services:
  quick-fox-1234  [expires in 23h 42m]  (created 2/15/2026)
    https://quick-fox-1234.agentscale.app
  my-api  [running]  (created 2/14/2026)
    https://my-api.agentscale.app

Credits: $5.00 | $0.01/hr (2 services) | ~500h remaining

agentscale account

Shows your account tier, credit balance, and burn rate.

npx agentscale account

Example Output:

Tier: paid
Credits: $5.00
Burn rate: $0.01/hr (2 active services)
Time remaining: ~20d 20h

To add credits, pay https://api.agentscale.co/add-credits
Payments are processed via the x402 protocol.

Pricing & Billing

Free Tier

• No signup or payment required
• 1 service maximum
• Services expire after 24 hours
• 3 deploys per 15 minutes

Paid Tier

Add credits to unlock permanent deploys and remove the 24-hour expiry.

• Unlimited services
• No expiry time
• 20 deploys per 15 minutes
• $0.05 per hour per service

How Billing Works

Credits are deducted hourly based on the number of active services. Your burn rate is displayed in agentscale account and agentscale list.

# Check your credit balance and burn rate
npx agentscale account

# Output:
Tier: paid
Credits: $5.00
Burn rate: $0.01/hr (2 active services)
Time remaining: ~20d 20h

Cost Examples

• 1 service running: ~$0.05/hour = ~$1.20/day = ~$36/month
• 2 services running: ~$0.10/hour = ~$2.40/day = ~$72/month

Adding Credits

Use the x402 payment protocol to add credits. See the x402 Protocol section for details.

x402 Protocol Guide

AgentScale uses the x402 protocol for all payments. x402 is a machine-to-machine payment protocol designed for AI agents and automated workflows.

What is x402?

x402 enables seamless HTTP-based payments without traditional authentication flows. It's perfect for:

• AI agents making autonomous payments
• Programmatic credit purchases
• Automated billing workflows

Payment Method

AgentScale accepts cryptocurrency payments via USDC on Base network.

Adding Credits with x402

Use an x402-compatible wallet to pay directly:

POST https://api.agentscale.co/add-credits
Headers:
  x-api-key: your-api-key
  Content-Type: application/json
Body:
  {"amount_cents": 1000}

Finding Your API Key

Your API key is stored in ~/.agentscale/config.json after running npx agentscale register.

Credit Amounts

Specify the amount in cents (USD):

• 1000 = $10.00
• 5000 = $50.00
• 10000 = $100.00

Example Response

{
  "credits": 15.00,
  "amountAdded": 10.00,
  "tier": "paid"
}