AgentaOS

What AgentaOS does

AgentaOS sells your product in its own name, as the merchant of record. For each sale, AgentaOS:

• takes the payment by card, or by bank transfer on EUR sales.
• charges the VAT that applies to the buyer.
• issues the invoice and sends the receipt.
• pays you out to your bank account. Stablecoin payouts are in public preview.

The same account also gives you:

• subscriptions with trials, plan changes and credits.
• discount codes, including codes that only track who a referral brought in.
• invoices, receipts and a customer list.
• a checkout you can embed on your own page.
• platforms, to run billing for your clients' businesses (private preview).

Your account starts in test mode. Verify your business to take live payments.

Start selling

Sign up at app.agentaos.ai, or start from the terminal:

npm install -g agentaos
agenta login
agenta products create --name "Pro" -a 29 -c EUR --subscription --interval month

The last command prints the product's buyer link. Share the link anywhere: every buyer who opens it gets a checkout.

To start a checkout from your own server, use the SDK:

npm install @agentaos/pay

import { AgentaOS } from '@agentaos/pay';

const agentaos = new AgentaOS(process.env.AGENTAOS_API_KEY!);

const checkout = await agentaos.checkouts.create({
  amount: 49,
  currency: 'EUR',
  description: 'Pro plan',
  successUrl: 'https://example.com/welcome',
});

// Send the buyer to checkout.checkoutUrl

The quickstart takes you from sign-up to the first paid sale.

Set up billing with your AI coding agent

The Claude Code plugin gives your coding agent the AgentaOS tools and a guide to the integration patterns:

claude plugin marketplace add AgentaOS/agentaos
claude plugin install agentaos@agentaos

In Claude Code, type /mcp, choose agentaos, then Authenticate. You approve the connection in your browser, so there is no key to paste.

Other MCP clients can run the MCP server from the agentaos package. It has 31 tools, the same operations as the CLI. See MCP setup.

Embed the checkout on your page

The embedded checkout shows your product's checkout inline, or as an overlay. Card, bank transfer, trials, discount codes and VAT work the same as on the hosted checkout.

<script src="https://app.agentaos.ai/v1/agentaos.js"></script>
<div id="checkout"></div>
<script>
  AgentaOS.checkout.open({
    link: 'https://app.agentaos.ai/pay/<your-product-link>',
    target: '#checkout',
  });
</script>

Add your site under Settings → Developers → Approved sites first. See Embedded checkout.

Packages

Package	What it is	Docs
@agentaos/pay	TypeScript SDK for your server: checkouts, products, subscriptions, discount codes, customers, invoices, webhooks	SDK overview
agentaos	The agenta CLI and the MCP server, one command per operation	CLI install
@agentaos/checkout	The embedded checkout for the browser, with React support. Not on npm yet: use the script tag above	Embedded checkout
plugins/agentaos	The Claude Code plugin	MCP setup
packages/mcp-remote	The hosted MCP server at mcp.agentaos.ai, for assistants that connect over the web	MCP setup

To run billing for other businesses from one account, see Build a platform.

Example

examples/paywall-demo is a small Express app with a paid Pro plan behind a login. It creates the checkout, confirms the payment, verifies the webhook and checks access.

Also in this repository

The agent wallet packages (core, signer, schemes, chains and mpc-wasm) are an on-chain wallet that an AI agent operates, with threshold signing so that no single party holds the full key. The agent wallet is in private preview. See Agent wallet and the paper.

Contributing

git clone https://github.com/AgentaOS/agentaos.git && cd agentaos
pnpm install && pnpm build && pnpm test

See CONTRIBUTING.md. Report security issues to [email protected], as SECURITY.md describes.

License

Apache-2.0. See LICENSE.

Copyright 2025-2026 Aristokrates OÜ