# 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.
Canonical: https://www.mcpfolio.com/servers/agentaos
## Catalog record

- Publisher: AgentaOS
- Categories: development, communication, finance

## Website

https://agentaos.ai/

## Transports

Streamable HTTP (hosted), stdio (local)

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

## Tools

### agenta_status_get

Your account and go-live overview, with the next step.

Input schema is not included in the available catalog record.

### agenta_audit_request

Request the free Revenue & Pricing Audit.

Input schema is not included in the available catalog record.

### agenta_audit_show

Audit status, plus the report once it exists.

Input schema is not included in the available catalog record.

### agenta_verify_declaration

The five statements you attest to when submitting verification.

Input schema is not included in the available catalog record.

### agenta_verify_submit

Submit business verification so you can accept live payments.

Input schema is not included in the available catalog record.

### agenta_verify_status

Where your verification stands.

Input schema is not included in the available catalog record.

### agenta_verify_resubmit

Resend verification for review after requested changes.

Input schema is not included in the available catalog record.

### agenta_products_create

Create a one-time product or a subscription plan.

Input schema is not included in the available catalog record.

### agenta_products_list

List products and plans.

Input schema is not included in the available catalog record.

### agenta_pay_checkout

Create a checkout and get a shareable link.

Input schema is not included in the available catalog record.

### agenta_pay_get

Check whether a checkout is paid, open, expired or canceled.

Input schema is not included in the available catalog record.

### agenta_pay_list

List checkouts, optionally filtered by status.

Input schema is not included in the available catalog record.

### agenta_subscriptions_list

List subscriptions.

Input schema is not included in the available catalog record.

### agenta_subscriptions_cancel

Cancel at the end of the current period.

Input schema is not included in the available catalog record.

### agenta_subscriptions_change_plan

Move to another plan. Upgrades charge now; downgrades start at period end.

Input schema is not included in the available catalog record.

### agenta_subscriptions_credit

Add credit to a subscriber's account, applied to their next invoice.

Input schema is not included in the available catalog record.

### agenta_subscriptions_credits

Credits given on a subscription and the unspent balance.

Input schema is not included in the available catalog record.

### agenta_discounts_create

Create a discount code buyers enter at checkout.

Input schema is not included in the available catalog record.

### agenta_discounts_list

List discount codes.

Input schema is not included in the available catalog record.

### agenta_discounts_show

One discount code, its discount and usage count.

Input schema is not included in the available catalog record.

### agenta_discounts_archive

Stop a discount code. Existing subscribers keep their discount.

Input schema is not included in the available catalog record.

### agenta_customers_list

List customers.

Input schema is not included in the available catalog record.

### agenta_invoices_list

List invoices.

Input schema is not included in the available catalog record.

### agenta_invoices_receipt

Receipt PDF for a paid invoice.

Input schema is not included in the available catalog record.

### agenta_invoices_send_receipt

Resend the receipt email to the buyer on file.

Input schema is not included in the available catalog record.

### agenta_businesses_list

List businesses you manage (platforms only).

Input schema is not included in the available catalog record.

### agenta_businesses_get

One managed business and its status.

Input schema is not included in the available catalog record.

### agenta_businesses_create

Add a client's business or another app of your company.

Input schema is not included in the available catalog record.

### agenta_businesses_invite

Resend a client's invitation, which replaces the old link.

Input schema is not included in the available catalog record.

### agenta_businesses_revoke_invite

Withdraw an open invitation.

Input schema is not included in the available catalog record.

### agenta_businesses_id_link

Identity check link for your client.

Input schema is not included in the available catalog record.

## Sources

- [publisher-setup](https://docs.agentaos.ai/mcp/setup)
- [publisher-product](https://agentaos.ai/)
- [publisher-logo](https://agentaos.ai/assets/agentaos-icon.png)

## Client setup instructions

### Cursor

Status: ready to configure.

Configuration:

```json
{
  "mcpServers": {
    "agentaos": {
      "url": "https://mcp.agentaos.ai/mcp"
    }
  }
}
```

Prerequisites:

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

Authentication:

- Complete the provider's documented credential flow in the client's supported secure credential or environment storage. Do not put credentials in this setup plan or chat.

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

Reload:

- Open Cursor Settings → Tools & MCP; restart or reconnect the server if Cursor does not pick up the saved project configuration.

Verify the connection:

- Open Cursor Settings → Tools & MCP and confirm the server is enabled with its tools listed. Ask for a harmless read-only operation only after authentication.

Official client guide: [Cursor](https://docs.agentaos.ai/mcp/setup)

### VS Code

Status: ready to configure.

Configuration:

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

Prerequisites:

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

Authentication:

- Complete the provider's documented credential flow in the client's supported secure credential or environment storage. Do not put credentials in this setup plan or chat.

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

Reload:

- Run `MCP: List Servers` from the Command Palette and use its Start/Restart action, or reload the VS Code window if needed.

Verify the connection:

- Run `MCP: List Servers`; confirm the server is running and its tools appear in Copilot Chat's Agent mode.

Official client guide: [VS Code](https://docs.agentaos.ai/mcp/setup)

### Claude Desktop

Status: ready to configure.

Configuration:

```json
Remote connector URL: https://mcp.agentaos.ai/mcp
Add it in Claude Desktop → Settings → Connectors → Add custom connector.
```

Prerequisites:

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

Authentication:

- Complete the provider's documented credential flow in the client's supported secure credential or environment storage. Do not put credentials in this setup plan or chat.

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

Reload:

- For a remote connector, enable it from Claude's Connectors UI. After editing `claude_desktop_config.json` or installing a local extension, fully quit and reopen Claude Desktop; the config is read only at launch.

Verify the connection:

- Open the Connectors/tools picker and confirm the server and its tools are available. Check Settings → Developer for local server status and logs for startup failures.

Official client guide: [Claude Desktop](https://docs.agentaos.ai/mcp/setup)

### Claude Code

Status: ready to configure.

Configuration:

```text
claude mcp add --transport http agentaos --scope project "https://mcp.agentaos.ai/mcp"
```

Prerequisites:

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

Authentication:

- Complete the provider's documented credential flow in the client's supported secure credential or environment storage. Do not put credentials in this setup plan or chat.

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

Reload:

- Start or restart the Claude Code session in the project if it was already open. Review and approve a new project-scoped server when Claude Code asks.

Verify the connection:

- Run 'claude mcp get agentaos' or 'claude mcp list'; in an interactive session, use '/mcp'. Confirm the status is connected and tools are listed. A configured entry alone is not proof of connection.

Official client guide: [Claude Code](https://docs.agentaos.ai/mcp/setup)

### Gemini CLI

Status: ready to configure.

Configuration:

```text
gemini mcp add --transport http agentaos "https://mcp.agentaos.ai/mcp"
```

Prerequisites:

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

Authentication:

- Complete the provider's documented credential flow in the client's supported secure credential or environment storage. Do not put credentials in this setup plan or chat.

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

Reload:

- Gemini CLI reads its settings on startup. Restart the CLI after direct file edits; its `mcp add` command writes the configuration.

Verify the connection:

- Run 'gemini mcp list' and confirm agentaos reports Connected. For local stdio servers, trust the current folder if Gemini CLI requires it.

Official client guide: [Gemini CLI](https://docs.agentaos.ai/mcp/setup)

### Codex CLI

Status: ready to configure.

Configuration:

```text
codex mcp add agentaos --url "https://mcp.agentaos.ai/mcp"
```

Prerequisites:

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

Authentication:

- Complete the provider's documented credential flow in the client's supported secure credential or environment storage. Do not put credentials in this setup plan or chat.

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

Reload:

- Restart an already-open Codex session or IDE extension if the server does not appear; the IDE extension offers a Restart action.

Verify the connection:

- Run 'codex mcp list' or '/mcp' in the Codex TUI. Confirm the server is enabled/connected and its tools are available.

Official client guide: [Codex CLI](https://docs.agentaos.ai/mcp/setup)

### Windsurf

Status: ready to configure.

Configuration:

```json
{
  "mcpServers": {
    "agentaos": {
      "serverUrl": "https://mcp.agentaos.ai/mcp"
    }
  }
}
```

Prerequisites:

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

Authentication:

- Complete the provider's documented credential flow in the client's supported secure credential or environment storage. Do not put credentials in this setup plan or chat.

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

Reload:

- Save `mcp_config.json`, then restart or reconnect the server from Cascade's MCP controls.

Verify the connection:

- Open Cascade's MCP panel and confirm the server is enabled and lists tools. Note: this documentation applies to legacy Cascade; newer Devin Local setup may differ.

Official client guide: [Windsurf](https://docs.agentaos.ai/mcp/setup)

### ChatGPT

Status: ready to configure.

Configuration:

```json
Remote MCP endpoint: https://mcp.agentaos.ai/mcp
Add it in ChatGPT web → Settings/Workspace Settings → Apps → Create.
```

Prerequisites:

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

Authentication:

- Complete the provider's documented credential flow in the client's supported secure credential or environment storage. Do not put credentials in this setup plan or chat.

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

Reload:

- Save/Create the app draft, then open a new chat and select the app from the tools menu. Admin approval or publishing may be required for workspace use.

Verify the connection:

- Confirm the app appears as a draft or enabled app, its tool scan completes, and the tools are available in a chat. ChatGPT web cannot connect directly to local stdio servers.

Official client guide: [ChatGPT](https://docs.agentaos.ai/mcp/setup)

### Manual

Status: ready to configure.

Configuration:

```json
{
  "mcpServers": {
    "agentaos": {
      "url": "https://mcp.agentaos.ai/mcp"
    }
  }
}
```

Prerequisites:

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

Authentication:

- Complete the provider's documented credential flow in the client's supported secure credential or environment storage. Do not put credentials in this setup plan or chat.

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

Reload:

- Restart/reload the selected client only if its documentation requires it.

Verify the connection:

- Use the selected client's MCP status view and verify the server exposes tools; do not report connected based only on a saved config.

Official client guide: [Manual](https://docs.agentaos.ai/mcp/setup)