@abstraxn/cli

Terminal client for Abstraxn Agent Kit — authenticate, list MCP tools, and manage Web3 agents.

Requirements

• Node.js 18+
• Abstraxn application API key from Dashboard → Agentic Stack → Overview

Install

npm install -g @abstraxn/cli

Verify:

abstraxn --version

Permission denied on npm install -g?

Use a user-owned npm prefix (no sudo):

mkdir -p ~/.local/bin ~/.local/lib/node_modules
npm config set prefix "$HOME/.local"
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g @abstraxn/cli

Quick start

# Interactive login (welcome screen + prompts)
abstraxn login

# Or non-interactive (CI / scripts)
abstraxn login --api-key "$ABSTRAXN_API_KEY" --no-welcome

# List MCP tools
abstraxn mcp tools

# Agents
abstraxn agents list
abstraxn agents create --name "My CLI Agent"
abstraxn agents use <agent-uuid>

# Call a tool
abstraxn mcp call get_wallet_address --args '{"chain":"base"}'

# Chat (needs LLM API key)
abstraxn chat --setup
abstraxn chat

Chat

Uses an OpenAI-compatible LLM (OpenRouter, OpenAI, etc.) to call Agent Kit MCP tools.

# 1. Configure LLM once
abstraxn chat --setup

# Or via env
export LLM_API_KEY="your-openrouter-or-openai-key"

# 2. Interactive REPL
abstraxn
# or: abstraxn chat

# 3. One-shot
abstraxn "What is my wallet address on Base?"

Type /exit to leave the REPL. Set a default agent (abstraxn agents use <id>) for wallet tools.

On-chain transactions

Use abstraxn mcp call for direct tool invocation (no LLM), or ask in chat.

# Balance & wallet
abstraxn mcp call get_balance --args '{"chain":"base"}'
abstraxn mcp call get_wallet_address --args '{"chain":"base"}'

# Prepare unsigned transfer (sign & broadcast with accessKey on your backend)
abstraxn mcp call transfer --args '{"chain":"base","to":"0x…","amount":"0.01"}'

# Track a broadcast transaction
abstraxn mcp call get_transaction_status --args '{"chain":"base","hash":"0x…"}'

In chat:

abstraxn "What is my balance on Base?"
abstraxn "Prepare a transfer of 0.01 ETH on Base to 0x…"

Schedule a transaction

Defer execution by adding scheduleInMinutes, scheduleInSeconds, or executeAt (ISO 8601) to transfer or swap tool args.

# In 10 minutes
abstraxn mcp call transfer --args '{
  "chain":"base","to":"0x…","amount":"0.01",
  "scheduleInMinutes": 10
}'

# At a specific time
abstraxn mcp call transfer --args '{
  "chain":"base","to":"0x…","amount":"0.01",
  "executeAt":"2026-07-03T18:00:00+05:30"
}'

Or in chat:

abstraxn "Send 0.01 ETH on Base to 0x… in 30 minutes"

Schedulable tools: transfer, evm_swap_quote, uniswap_swap_quote, lifi_swap_quote, jupiter_swap_quote, oneinch_swap_quote.

A successful schedule returns status: transaction_scheduled with scheduledTransactionId.

Commands

| Command | Description | |---------|-------------| | abstraxn login | Save API key and MCP URL to ~/.abstraxn/config.json | | abstraxn logout | Remove saved config | | abstraxn config | Show config (secrets masked) | | abstraxn mcp tools | tools/list from Agent Kit MCP | | abstraxn mcp call <tool> | tools/call with --args JSON and optional --agent | | abstraxn agents list | List agents via REST | | abstraxn agents create | Create agent + server wallet | | abstraxn agents use <id> | Set default agent (per-agent MCP key) | | abstraxn chat | Interactive chat with MCP tools | | abstraxn chat "..." | One-shot question | | abstraxn chat --setup | Configure LLM API key and model |

Login flags

| Flag | Description | |------|-------------| | --api-key <key> | Application API key (skip interactive prompt) | | --base-url <url> | Agent Kit REST base (default: https://agent-kit.abstraxn.com) | | --mcp-url <url> | MCP endpoint (default: {baseUrl}/mcp) | | --no-welcome | Skip welcome screen |

Configuration

Config file: ~/.abstraxn/config.json (file mode 600, directory mode 700).

| Variable | Purpose | |----------|---------| | ABSTRAXN_API_KEY | Application API key (overrides config) | | ABSTRAXN_MCP_URL / MCP_SERVER_URL | MCP endpoint | | ABSTRAXN_AGENT_KIT_BASE_URL / AGENT_KIT_BASE_URL | REST base URL | | LLM_API_KEY / OPENAI_API_KEY | LLM provider API key | | LLM_BASE_URL | OpenAI-compatible API base (default: OpenRouter) | | LLM_MODEL | Model id (default: openai/gpt-4o-mini) |

When a default agent is set with a per-agent apiKey, MCP calls use that key automatically.

Dev / local Agent Kit

abstraxn login \
  --api-key "$ABSTRAXN_API_KEY" \
  --base-url "http://localhost:3010" \
  --mcp-url "http://localhost:3010/mcp" \
  --no-welcome

Credentials

| Secret | Source | CLI usage | |--------|--------|-----------| | Application API key | Dashboard Overview | login, REST, MCP (with agent_id) | | Per-agent apiKey | agents create | Default agent MCP auth | | Wallet accessKey | Shown once at create | Not stored by CLI yet — needed for transfer / x402 |

See Credentials cheat sheet.

Development

git clone https://github.com/Abstraxn-Labs/abstraxn-sdks.git
cd abstraxn-sdks/cli
npm install
npm run build

# Run without global install
npx abstraxn --help
npm run dev -- login

# Link globally (after user npm prefix setup)
npm link

Publishing (maintainers)

From abstraxn-sdks/cli:

npm login                    # npmjs.com account with @abstraxn scope access
npm run build
npm pack --dry-run           # verify tarball contents
npm publish --access public

Bump version in package.json and add a section to CHANGELOG.md before each release.

Changelog

See CHANGELOG.md.

Related

• 5-minute smoke test
• MCP in Cursor
• @abstraxn/agent-kit

License

MIT — see LICENSE.