AgentaOS

io.github.AgentaOSPublished by GitHub account AgentaOSv3.4.0Updated Oct 24, 2026

Merchant of record: payment links, checkouts, subscriptions and invoices, with VAT handled.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant set up and manage AgentaOS merchant-of-record billing: products, payment links, checkouts, subscriptions, discount codes, invoices and payouts

What you can do
AgentaOS is a merchant-of-record service for selling digital products. Through the MCP server an assistant can work with the same operations as the CLI, described as 31 tools, covering products, checkouts, subscriptions with trials and credits, discount codes, customers, invoices and receipts. AgentaOS takes card or bank-transfer payments, charges buyer VAT, issues invoices and pays out to your bank account. Accounts start in test mode until the business is verified.
When to use it
Use it when you sell digital products and want an assistant to create products, generate buyer payment links, start checkouts, or manage subscriptions, discount codes and invoices. It suits founders who want billing handled by a merchant of record rather than building payments themselves.
Requirements
A remote MCP endpoint at mcp.agentaos.ai over streamable HTTP; no packages, environment variables or headers are declared. An AgentaOS account is needed, and the Claude Code path authenticates through a browser approval rather than a pasted key. The SDK example uses an AGENTAOS_API_KEY value. Business verification is required before taking live payments.
Before you install
This server handles real payments and money movement: it can create checkouts and charges, issue invoices, and trigger payouts to a bank account, with stablecoin payouts in public preview. Accounts begin in test mode, so verify before going live. The SDK example passes an AGENTAOS_API_KEY secret; treat it as sensitive. An agent wallet feature is mentioned but is in private preview.

Installation

In SourceWeft

  1. Open AgentaOS in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.AgentaOS%2Fagentaos/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "agentaos": {
      "type": "http",
      "url": "https://mcp.agentaos.ai/mcp"
    }
  }
}

README

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.

[npm] [npm] [License: Apache-2.0]

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:

bash
npm install -g agentaosagenta loginagenta 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:

bash
npm install @agentaos/pay
typescript
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:

bash
claude plugin marketplace add AgentaOS/agentaosclaude 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.

html
<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

PackageWhat it isDocs
@agentaos/payTypeScript SDK for your server: checkouts, products, subscriptions, discount codes, customers, invoices, webhooksSDK overview
@agentaos/nextjsNext.js route handlers: a checkout route for your products and a verified webhook routeREADME
@agentaos/better-authBetter Auth plugin: checkout and subscriptions for signed-in users, and verified webhooks with one handler per eventREADME
agentaosThe agenta CLI and the MCP server, one command per operationCLI install
@agentaos/checkoutThe embedded checkout for the browser, with React support. Not on npm yet: use the script tag aboveEmbedded checkout
plugins/agentaosThe Claude Code pluginMCP setup
packages/mcp-remoteThe hosted MCP server at mcp.agentaos.ai, for assistants that connect over the webMCP 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

bash
git clone https://github.com/AgentaOS/agentaos.git && cd agentaospnpm 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Ü

Source: README.md at commit 4f3b751

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v3.4.0LatestOct 15, 2026
  2. v3.1.0Oct 15, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts