# Nuncio Docs

Canonical URL: https://nuncio.one/docs
Markdown URL: https://nuncio.one/docs/index.md
Summary: Nuncio gives personal AI agents one user-authorized payment stack: MagicCard, Secrets requests, and routing across browser, API, and agentic payment rails.
Description: Product and developer documentation for Nuncio, the payment infrastructure for personal AI agents.

## Canonical Answer

Nuncio gives personal AI agents one user-authorized payment stack: MagicCard, Secrets requests, and routing across browser, API, and agentic payment rails. Product and developer documentation for Nuncio, the payment infrastructure for personal AI agents. MagicCard, requests, secrets, and approvals stay under the human owner's control.

![Nuncio overview architecture](https://nuncio.one/docs-assets/images/nuncio-overview-architecture.png)

## Key Points

- Payment infrastructure for personal AI agents.
- One user-authorized payment stack for online purchases, subscriptions, and agent-native rails.
- MagicCard, requests, secrets, and approvals stay under the human owner's control.
- Sensitive data is resolved inside Nuncio, never in LLM context.

## What Nuncio Is

Nuncio is designed to be the universal payment tool for a personal AI agent. The agent can use provider-backed cards and payment operations, APIs, crypto rails, browser checkout, and agent-native protocols to get the job done, while the user sees a simple MagicCard with one balance. MagicCard makes payments in the complex world of agentic protocols, new payment standards, and crypto feel as simple as topping up a card.

## Nuncio Overview

Nuncio is payment infrastructure for personal AI agents. The goal is to feel as simple as Apple Pay for users and their agents while hiding wallets, cards, protocols, approval routing, and protected execution behind one MagicCard interface.

- Protected requests: Approvals, secrets, identity details, and payment execution move through user-controlled requests instead of model context. (https://nuncio.one/docs/components/secrets-fill)
- Commerce Routing: Marketmap finds provider-method guidance; the agent executes with built-in browser, an API, or an agentic protocol. (https://nuncio.one/docs/reference/payment-methods)

## Purchase Loop

Every purchase is a session: the personal agent clarifies intent, Nuncio raises requests when user authority is needed, and execution continues through the best available payment rail.

- Intent To Session: The user asks their agent for a purchase, and Nuncio turns it into a tracked payment session with events. (https://nuncio.one/docs/reference/entities#payment-session)
- User Authority: KYC, balance, approvals, secrets, and final confirmations stay owned by the human. (https://nuncio.one/docs/reference/entities#request)
- Payment Execution: The session can finish through x402, MCP/API, or the host browser for the approved checkout. (https://nuncio.one/docs/guides/e2e-purchase)

## Build With Nuncio

Connect your agent through remote MCP for purchase requests, decisions and payment tracking while the host owns its native browser.

- Built-In Payment Agent: Searches providers, coordinates built-in browser, ranks payment channels, and asks the user to approve each protected step. (https://nuncio.one/docs/guides/e2e-purchase)
- Connect With MCP: Use the host’s native remote MCP connection, then discover the current tools and follow their returned requests. (https://nuncio.one/docs/guides/connect-agent)
- Human UI: Web, mobile, ChatGPT, Claude, Telegram, and email apps handle approvals, sessions, card state, and confirmations. (https://nuncio.one/docs/components/omnichannel-ui)

## Choose Your Path

Use the docs path that matches what you want to do next.

- Set up an account: Create the user account, pass KYC, top up the MagicCard balance, and connect your first agent. (https://nuncio.one/docs/guides/account-setup)
- Understand the product: Start with account readiness, Secrets requests, the host browser, discovery and current MCP tools. (https://nuncio.one/docs/components)
- Run a purchase: Follow the built-in agent purchase flow from intent discovery to provider selection and user approval. (https://nuncio.one/docs/guides/e2e-purchase)
- Connect With MCP: Use the host’s native remote MCP connection, then discover the current tools and follow their returned requests. (https://nuncio.one/docs/guides/connect-agent)

## Recommended Path

Most users and builders should follow the same staged path before a real payment. This keeps setup, safety, and payment authority understandable for both humans and agents.

1. Create a Nuncio account and complete account, KYC, and balance prerequisites.
2. Connect one agent runtime and verify that Nuncio and built-in browser are available.
3. Run a browser-only task so the agent proves it can navigate without any protected data.
4. Run a low-risk protected form handoff, such as a shipping address.
5. Add reusable Nuncio Secrets values only after the user understands what will be stored.
6. Move to MCP, API, or full purchase flows once request handling is observable end to end.

## Use Case Entry Points

Start from the workflow you are trying to ship. The components underneath are modular, but each path trusts the agent with a different amount.

- I want my agent to buy something: Use the end-to-end purchase guide to combine Marketmap, built-in browser, approvals, and payment execution. (https://nuncio.one/docs/guides/e2e-purchase)
- I want protected form fill: Use Nuncio Secrets fill when the agent reaches card, login, identity, or confirmation fields. (https://nuncio.one/docs/components/secrets-fill)
- I want to connect my agent: Use the host’s native remote MCP connection, then discover the current tools and follow their returned requests. (https://nuncio.one/docs/guides/connect-agent)
- I want provider-backed payments: Use Payment Bridge docs for account linking, KYC, card state, top-up, and provider callbacks. (https://nuncio.one/docs/components/payment-bridge)
- I want agent-readable rules: Use the agent operating guide for machine-readable rules, routing guidance, and discovery hints. (https://nuncio.one/docs/agents)
- Something is stuck: Use troubleshooting for checkout, request, Secrets, payment, and payment provider failure modes. (https://nuncio.one/docs/guides/troubleshooting)

## Related

- MagicCard: https://nuncio.one/docs/magiccard
- Getting Started: https://nuncio.one/docs/getting-started
- Nuncio Components: https://nuncio.one/docs/components