Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agentaos.ai/llms.txt

Use this file to discover all available pages before exploring further.

Frequently Asked Questions

General

What is AgentaOS?

Agent banking for AI companies. Accept payments from humans and AI agents, manage autonomous agent wallets, and enforce spending guardrails, all from one platform.

How much does it cost?

Free to start. No license fees, no monthly charges, no usage limits. You pay only transaction fees on settlement. Open-source SDK on GitHub.

Is this custodial?

No. AgentaOS uses two non-custodial security models:
  • Organization wallet. passkey/WebAuthn with OPRF. Key derived from biometric, never stored.
  • Sub-accounts. MPC threshold signing (CGGMP24). 3 shares, any 2 sign. Key never exists.
No single party can access your funds.

Payments

How do I accept payments?

From the dashboard: app.agentaos.ai → create a payment link. From the CLI:
agenta pay checkout -a 50 -c EUR
Both generate a checkoutUrl (for human customers) and an x402Url (for machine to machine payments).

How do I know when a payment completes?

Check the status:
agenta pay get <sessionId>
Or configure a webhook for real-time notifications.

What currencies are supported?

EUR (settled as EURC) and USD (settled as USDC) on Base. The checkout shows the fiat amount, your customer doesn’t need to know about stablecoins.

What is x402?

The x402 protocol enables machine to machine payments. An AI agent hits a 402-protected endpoint, pays automatically, and gets the response. No checkout page, no human in the loop.
agenta sub x402 check https://api.example.com/data
agenta sub x402 fetch https://api.example.com/data

CLI & AI Agents

Can AI agents use the CLI?

Yes. Every command supports --json for machine-readable output. The only command requiring a human is agenta login (opens a browser). Everything else is AI-executable.

How do I install?

curl -fsSL https://agentaos.ai/install | bash
Requires Node.js 20+. Or: npm install -g agentaos.

What is the SKILL.md?

A structured instruction file that teaches AI agents how to use AgentaOS step by step. Install it as a skill: npx skills add AgentaOS/skills@agenta.

What is the MCP Server?

21 tools that connect AgentaOS to Claude Desktop, Cursor, Windsurf, or any MCP-compatible AI assistant. No code, just config. See MCP Setup.

Sub-accounts

What is a sub-account?

An autonomous wallet for an AI agent. Own Ethereum address, own API key, own spending policies. Create as many as you need.
agenta sub create --name trading-bot

What chains are supported?

Ethereum, Base, Arbitrum, Optimism, Polygon, mainnet and testnet. All EVM chains.

Can I set spending limits?

Yes. Policies are enforced on every transaction: daily limits, per-tx caps, allowed addresses, time windows, rate limits. See Policies.

Security

What happens if a server gets hacked?

The attacker gets one share. One share cannot sign anything. Revoke the compromised share, rotate, and move funds using the remaining two shares.

What if I lose a share?

Any 2 of 3 shares can sign. Losing one share does not lock your funds.

Is the cryptography audited?

Yes. The CGGMP24 protocol is implemented by the audited LFDT-Lockness/cggmp21 Rust crate with formal security proofs.

How is this different from Fireblocks?

AgentaOSFireblocks
PricingFree to start50k50k–500k/yr
SourceOpen sourceProprietary
CustodyNon-custodialYou trust their infra
Lock-inNoneEnterprise contract