> ## 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.

# FAQ

> Common questions about AgentaOS: payments, pricing, security, CLI, and AI agent integration.

# 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](https://github.com/AgentaOS/agentaos).

### 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](https://app.agentaos.ai) → create a payment link.

**From the CLI:**

```bash theme={null}
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:

```bash theme={null}
agenta pay get <sessionId>
```

Or configure a [webhook](/payments/webhooks) 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](https://www.x402.org/) 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.

```bash theme={null}
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?

```bash theme={null}
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](/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.

```bash theme={null}
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](/sub/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](https://github.com/LFDT-Lockness/cggmp21) Rust crate with formal security proofs.

### How is this different from Fireblocks?

|         | AgentaOS      | Fireblocks            |
| ------- | ------------- | --------------------- |
| Pricing | Free to start | $50k–$500k/yr         |
| Source  | Open source   | Proprietary           |
| Custody | Non-custodial | You trust their infra |
| Lock-in | None          | Enterprise contract   |