AgentaOS MCP

About AgentaOS MCP

Let an AI agent run the same operations as the agenta CLI: create products, checkouts and subscriptions, manage discount codes, and read customers and invoices. AgentaOS is the merchant of record, so it is the legal seller and handles sales tax or VAT, invoices, refunds and chargebacks.

What you can use it for

Create products, subscription plans and shareable checkout links
Check go-live status and submit business verification
Manage subscriptions, credits and discount codes
Read customers and invoices, and resend receipts
Manage several client businesses from one platform account

Connection and setup

Hosting: hosted, or local via npx
Transport: Streamable HTTP (hosted), stdio (local)
Endpoint: https://mcp.agentaos.ai/mcp
Authentication: Hosted: approve the connection once on an AgentaOS page and choose Test or Live mode; no key to paste. Local: API key in AGENTAOS_GATEWAY_KEY (sk_test_ keys see test data only).

Requirements

AgentaOS account.
Hosted: a client that can open a browser to approve the connection.
Local: Node.js 20 or later and an API key (Developers > API keys > Connect an AI agent > Other).

Setup steps

Hosted: add https://mcp.agentaos.ai/mcp as a server in Cursor, or as a custom connector in Claude.ai or ChatGPT, then approve it once and choose Test or Live mode.
Claude Code: run claude plugins marketplace add AgentaOS/agentaos, then claude plugins install agentaos@agentaos, then open /mcp, choose agentaos and Authenticate.
Local: claude mcp add agentaos-local -e AGENTAOS_GATEWAY_KEY=sk_test_your-key -- npx -y agentaos

Tools

All 31 tools are listed on the publisher's setup page. Every tool also accepts an optional business input to act as a managed business. Authenticated live tool listing was not performed.

agenta_status_get
Your account and go-live overview, with the next step.
01
agenta_audit_request
Request the free Revenue & Pricing Audit.
02
agenta_audit_show
Audit status, plus the report once it exists.
03
agenta_verify_declaration
The five statements you attest to when submitting verification.
04
agenta_verify_submit
Submit business verification so you can accept live payments.
05
agenta_verify_status
Where your verification stands.
06
agenta_verify_resubmit
Resend verification for review after requested changes.
07
agenta_products_create
Create a one-time product or a subscription plan.
08
agenta_products_list
List products and plans.
09
agenta_pay_checkout
Create a checkout and get a shareable link.
10
agenta_pay_get
Check whether a checkout is paid, open, expired or canceled.
11
agenta_pay_list
List checkouts, optionally filtered by status.
12
agenta_subscriptions_list
List subscriptions.
13
agenta_subscriptions_cancel
Cancel at the end of the current period.
14
agenta_subscriptions_change_plan
Move to another plan. Upgrades charge now; downgrades start at period end.
15
agenta_subscriptions_credit
Add credit to a subscriber's account, applied to their next invoice.
16
agenta_subscriptions_credits
Credits given on a subscription and the unspent balance.
17
agenta_discounts_create
Create a discount code buyers enter at checkout.
18
agenta_discounts_list
List discount codes.
19
agenta_discounts_show
One discount code, its discount and usage count.
20
agenta_discounts_archive
Stop a discount code. Existing subscribers keep their discount.
21
agenta_customers_list
List customers.
22
agenta_invoices_list
List invoices.
23
agenta_invoices_receipt
Receipt PDF for a paid invoice.
24
agenta_invoices_send_receipt
Resend the receipt email to the buyer on file.
25
agenta_businesses_list
List businesses you manage (platforms only).
26
agenta_businesses_get
One managed business and its status.
27
agenta_businesses_create
Add a client's business or another app of your company.
28
agenta_businesses_invite
Resend a client's invitation, which replaces the old link.
29
agenta_businesses_revoke_invite
Withdraw an open invitation.
30
agenta_businesses_id_link
Identity check link for your client.
31

Limitations and notes

The six business tools are for platforms only.
The hosted server needs a browser to approve the connection.
Test keys and Test mode see test data only.
The listing is source-reviewed but has not been tested with an authenticated account.

Original sources

publisher-setup
Official AgentaOS MCP setup page: endpoint, install commands, auth and full tool list.
publisher-product
Official publisher site.
publisher-logo
Official AgentaOS site icon, copied to the local catalog asset.

Documentation checked date not recorded. Connection has not been runtime tested.

Platforms

Remote · Streamable HTTP (hosted), stdio (local)

hosted, or local via npx

Authentication

Hosted: approve the connection once on an AgentaOS page and choose Test or Live mode; no key to paste. Local: API key in AGENTAOS_GATEWAY_KEY (sk_test_ keys see test data only).