AgentaOS
Merchant of record: payment links, checkouts, subscriptions and invoices, with VAT handled.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http agentaos 'https://mcp.agentaos.ai/mcp'
{
"mcpServers": {
"agentaos": {
"type": "http",
"url": "https://mcp.agentaos.ai/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
AgentaOS
Turn your users into paying customers
AgentaOS is a merchant of record for AI agents: your agent (Claude, ChatGPT, Cursor) sets up products, checkout links and subscriptions, and AgentaOS is the legal seller, so VAT, sales tax, invoices and chargebacks are ours. What that means.
Website · Docs · Quickstart · SDK · CLI
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 security@agentaos.ai, as SECURITY.md describes.
License
Apache-2.0. See LICENSE.
Copyright 2025-2026 Aristokrates OÜ
الأسئلة الشائعة
ما هو AgentaOS؟
Merchant of record: payment links, checkouts, subscriptions and invoices, with VAT handled.
كيف أثبّت AgentaOS؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http agentaos 'https://mcp.agentaos.ai/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج AgentaOS إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل AgentaOS مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.
من يصون AgentaOS؟
ينشره AgentaOS. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.