Quick Start

Get your AI agent running on Starknet in under 5 minutes. The CLI auto-detects your environment and configures Starknet accordingly.

Prerequisites

• Node.js 18+ installed (download)
• A Starknet wallet (Ready or Braavos recommended)

One Command Setup

npx create-starknet-agent@latest

The CLI detects your environment and sets up Starknet:

Platform-Specific Setup

OpenClaw / MoltBook Users

If you're using OpenClaw, the CLI configures everything automatically:

npx create-starknet-agent@latest

Or let your agent self-configure:

# Agent runs this in non-interactive mode
npx create-starknet-agent@latest --non-interactive --json

What gets configured:

• MCP server pointing to @starknet-agentic/mcp-server
• Skills: starknet-wallet, starknet-defi
• Environment template for credentials

After setup:

1. Add your credentials: npx create-starknet-agent credentials
2. Restart your agent
3. Try: "What's my ETH balance on Starknet?"

Claude Code Users

npx create-starknet-agent@latest

What gets configured:

• MCP server in .mcp.json
• CLAUDE.md updated with Starknet skill references
• .env.example with required variables

After setup:

1. Configure credentials: npx create-starknet-agent credentials
2. Restart Claude Code
3. Verify: /mcp should show the starknet server

Cursor Users

npx create-starknet-agent@latest

What gets configured:

• MCP configuration in Cursor settings
• Environment template

Standalone Agent

For building a custom agent from scratch:

npx create-starknet-agent@latest my-agent
cd my-agent
cp .env.example .env
# Edit .env with your credentials
pnpm start

Your agent will be available at http://localhost:3000.

Configure Credentials

After platform setup, configure your wallet credentials:

npx create-starknet-agent credentials

The wizard guides you through:

1. Network selection — Sepolia (testnet) or Mainnet
2. Wallet export — Instructions for Ready or Braavos
3. Secure storage — Credentials stored safely for your platform

Getting Your Credentials

Ready Wallet:

1. Install Ready Wallet
2. Create/import wallet on Sepolia Testnet
3. Settings → Account → Export Private Key
4. Get testnet tokens from the Starknet Faucet

Braavos Wallet:

1. Install Braavos
2. Account Settings → Security → Export Private Key
3. Copy account address from wallet header

RPC Endpoint:

• Alchemy — Create account → New App → Starknet
• Infura — Create account → New Project → Starknet

Verify Setup

Confirm everything is working:

npx create-starknet-agent verify

This checks:

• MCP server configuration exists
• Required credentials are set
• Skills are installed
• Can query Starknet (optional balance check)

Output:

✓ MCP configuration found
✓ Credentials configured
✓ Skills installed: starknet-wallet, starknet-defi
✓ Connected to Starknet Sepolia
✓ Account balance: 0.5 ETH

Test the Connection

Once verified, test with your AI assistant:

In Claude Code:

Check my STRK balance

Expected:

Using starknet_get_balance tool... Your STRK balance is 1,234.56 STRK

CLI Reference

# Auto-detect platform and configure
npx create-starknet-agent@latest

# Force specific platform
npx create-starknet-agent@latest --platform openclaw
npx create-starknet-agent@latest --platform claude-code
npx create-starknet-agent@latest --platform cursor
npx create-starknet-agent@latest --platform standalone

# Configure credentials
npx create-starknet-agent credentials

# Verify setup
npx create-starknet-agent verify

# Non-interactive (for agent self-setup)
npx create-starknet-agent@latest --non-interactive --json

# Show detected platforms
npx create-starknet-agent@latest --detect-only

What's Next?

Troubleshooting

Need more help? Open an issue on GitHub.