cli

@codespar/cli

Command-line interface for CodeSpar — authenticate, browse servers, execute tools, manage sessions, stream logs, and scaffold projects from your terminal.

Install

npm install -g @codespar/cli

Usage

# Authenticate (stores API key in ~/.codespar/config.json)
codespar login

# Browse the catalog
codespar servers list
codespar tools list --server asaas

# Run a single tool call
codespar execute codespar_pay \
  --server asaas \
  --input '{"method":"pix","amount":15000,"currency":"BRL"}'

# Give an agent a unified multi-currency wallet under ONE signed mandate:
# a Pix (BRL) slot and a USDC slot, each with its own per-currency cap. No FX.
codespar mandate create --consumer shopper --agent buyer \
  --payee https://x402.codespar.dev/api/market-data,11144477735 \
  --slot BRL:pix:50000:1500 \
  --slot USDC:usdc:100:100

# See the wallet, rolled up per currency
codespar wallet shopper

# The same mandate pays a 402-protected API in USDC (gated by the USDC per-tx cap)
codespar spend --mandate <id> --amount 1 --agent buyer \
  --payee https://x402.codespar.dev/api/market-data

# Move value between slots (per-currency, no FX — a cross-currency move is a real
# ramp trade at the real rate). Omit --execute to just plan it.
codespar transfer shopper --from BRL --to USDC --amount 15000

# Manage sessions and logs
codespar sessions list
codespar logs tail --server stripe

# Scaffold a new agent
codespar init my-agent

Commands

Command	Description
login	Save API key to ~/.codespar/config.json
logout	Clear the stored API key
whoami	Show authenticated user, org, project, and scopes
servers list	List servers (filter by --category, --region)
servers show <id>	Show a server's details and tools
tools list	List tools (filter by --server)
tools show <name>	Show a tool's full input/output schema
execute <tool>	Run a single tool call in a throwaway session
discover <query>	Search the catalog for tools matching a use case
mandate create	Create a consumer mandate — the agent's allowance. --slot CURRENCY:METHOD:CAP:PER_TX (repeatable, e.g. BRL:pix:50000:1500) for a unified multi-currency wallet; per-currency caps, no FX
wallet <consumer>	Show the consumer's unified wallet, rolled up per currency
transfer <consumer>	Move value between wallet slots (--from --to --amount [--execute]); a cross-currency move is a real ramp trade at the real rate, no FX
spend	Execute an agentic spend against a mandate (x402 / USDC / Pix, routed by payee)
charge	Issue an inbound charge via codespar_charge
ship	Generate label / quote rates / track via codespar_ship
ledger	Post entries / read balances / create accounts via codespar_ledger
issue	Issue / freeze / read agent spend cards via codespar_issue
payment-status <id>	Poll async settlement status (add --stream)
verification-status <id>	Poll async KYC status (add --stream)
wizard [server]	Connection wizard — required secrets, connect URL, next steps
sessions list	List recent sessions (filter by --status, --limit)
sessions show <id>	Show session details (add --logs for tool calls)
sessions close <id>	Close an active session
connect list	List active Connect Links per user
connect start <server>	Start an OAuth Connect Link flow (add --open)
connect revoke <server>	Revoke a connection
logs tail	Stream tool-call logs in real time (SSE)
init <name>	Scaffold a new commerce agent from a template

Global flags

Flag	Description
--json	Machine-readable JSON output (pipe into jq)
--api-key <key>	Override the stored key
--base-url <url>	Point at a custom API (staging, self-hosted)
--project <id>	Scope requests to a project (multi-project orgs)

Configuration

Resolution order (first match wins):

1. Command-line flags (--api-key, --base-url, --project)
2. Environment variables (CODESPAR_API_KEY, CODESPAR_BASE_URL, CODESPAR_PROJECT)
3. Config file at ~/.codespar/config.json (chmod 600)

Templates

Slug	Stack
pix-agent	Node + OpenAI — minimal Pix charge + WhatsApp notify
ecommerce-checkout	Node + Claude — full Complete Loop
streaming-chat	Next.js + Vercel AI — token-by-token streaming
multi-tenant	Next.js + OpenAI — one API key, N tenants

Need more?

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT — codespar.dev