# OneCheckout MCP for Mac (agent reference)

Let an AI agent or coding assistant complete real checkouts. Buy a product,
start a subscription, sign up for a paid plan, pay an invoice, or add a card,
all without the buyer's raw card number ever entering the agent's context, the
chat, the logs, or OneText's servers.

## Quick start

Paste this one prompt into any MCP-capable agent or coding assistant. It
fetches the hosted server, follows the setup instructions it returns, and gives
you a tour of the tools. There are no API keys to configure.

    Fetch https://onecheckout.ai/connect.md and follow the instructions it returns to install and set up the OneCheckout MCP. Then give me a tour of what I can do!

## What is an MCP?

An MCP (Model Context Protocol server) is a plug-in that an AI agent installs to
gain new tools and capabilities. The OneCheckout MCP is the plug-in your agent
installs and uses to make online purchases. Paste the install prompt into your
agent's environment and it wires up the tools automatically.

## Connect

MCP endpoint:

    https://onecheckout.ai/api/mcp

Install prompt (paste into any agent or coding tool):

    Fetch https://onecheckout.ai/connect.md and follow the instructions it returns to install and set up the OneCheckout MCP. Then give me a tour of what I can do!

Codex CLI:

    codex mcp add onecheckout --url https://onecheckout.ai/api/mcp
    codex "Fetch https://onecheckout.ai/connect.md and follow the instructions it returns to install and set up the OneCheckout MCP. Then give me a tour of what I can do!"

Claude custom-connector deep link:

    https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=OneCheckout&connectorUrl=https%3A%2F%2Fonecheckout.ai%2Fapi%2Fmcp

There are no API keys to paste. Fetching https://onecheckout.ai/api/mcp returns the full
self-describing setup and the current tool list.

## How card safety works

No agent, AI model, or LLM ever sees your card details. The OneCheckout MCP
keeps card data in a local encrypted Keychain and, optionally, securely
tokenized in the OneText vault. Our architecture guides the agent to checkout,
finds the card form, then uses deterministic code to pass the card details to
the site.

## Capabilities

- Buy a product from an online store
- Start or manage a subscription
- Sign up for a paid plan
- Pay an invoice
- Add or vault a card

## Prompt library

Copy-and-paste starting points for real work, grouped by who they serve. Each is
a natural-language prompt to hand your agent once the MCP is installed. They
follow the same rules as the playbooks: the agent pauses for any verification or
identity step, reviews the total and any renewal terms, and gets one explicit
approval before an irreversible paid action.

### Developers

#### Integrate LLMs

Connect through OpenRouter or add individual keys for every AI model directly into your environment vars.

    Set up LLM access for my project. Connect me through OpenRouter or create individual API keys for the specific models I need, store every key in my environment variables (never in chat or source control), and commit the code changes to my GitHub repo. Ask me which providers, models, and budget I'm targeting first, pause and hand off to me whenever a signup needs email or SMS verification, a CAPTCHA, or SSO, and confirm the cost with me before any paid upgrade. Verify each key works and summarize what you set up.

#### Build Your Stack

Assemble the right SaaS and API tools like Supabase, AWS, Algolia, and more with credentials and user accounts integrated into your codebase and GitHub.

    Help me build my technical stack. Based on what I'm building, sign up for and configure the right SaaS and API tools, things like Supabase, AWS, and Algolia, wire them into my codebase, and commit the integration to my GitHub repo while keeping every credential in my environment variables rather than in source control. Ask me about my product and requirements before you choose, pause for me on any email or SMS code, CAPTCHA, or SSO step, and show me the plan and total before starting any paid tier. Explain each pick and summarize the accounts you created.

### Founders

#### Register Phone Numbers and Send Texts

Get below-market rates for 1:1 and blast texting across SMS, MMS, and RCS, powered by OneText, or provision an iMessage sender through AgentPhone.

    I need to start texting my customers. Provision a phone number and set up 1:1 and blast messaging over SMS, MMS, and RCS through OneText, and stand up an iMessage sender through AgentPhone if it fits my use case. Ask me about my volume, audience, and channels first so you pick the right rates, hand me any verification or identity check when it comes up, and confirm the total and any recurring charges before you commit. Report back once it's live.

#### Incorporate & Launch

Launch your business end to end. Incorporate with Stripe Atlas, register a domain, and publish a website.

    I have a new business idea. Recommend the best way to incorporate, then set it up with Stripe Atlas, register the domain through a top registrar, and publish a website on Lovable, Webflow, or Squarespace based on your assessment of my business. Ask me questions first so you pick the right services, pause for me on any identity verification, and review each cost and renewal term with me before you pay. Summarize everything you created and any recurring fees.

#### Accept Payments and Set Up a Corp Card

Start accepting payments with Stripe or PayPal and issue a corporate card for your team's spend.

    Help me start accepting payments and set up a corporate card. Create a Stripe or PayPal account so I can get paid, then provision a corporate card for company spend, storing any API keys in my environment variables (never in chat or source control) and committing code changes to my GitHub repo. Ask me about my business type and where I'm based first, hand me any identity or bank verification steps, and confirm with me before completing signup. Summarize the accounts you created.

#### Scale with Ads

Generate ad creative with Canva and launch campaigns across Meta, LinkedIn, and AppLovin.

    Help me scale with advertising. Generate ad creative in Canva, then set up and launch campaigns across Meta, LinkedIn, and AppLovin. Ask me about my product, audience, and budget first so you target and design the right campaigns, pause for me on any account verification or payment-method step, and show me the daily and total spend to approve before anything goes live. Report the campaigns you launched.

#### Buy Swag

Design your team's swag and print it on demand, shipped straight to your door.

    Help me make team swag. Design branded merchandise for my company and order it print-on-demand, shipped to our team. Ask me about our brand, the items I want, sizes, and quantities first, show me mockups, and confirm the itemized total and shipping with me before you place the order.

### Buyers

#### Upgrade and Downgrade Services

Cancel under-used SaaS, manage free trials, and move plans up or down as your needs change.

    Audit my subscriptions and optimize them. Cancel SaaS I'm barely using, manage my active trials before they bill, and move plans up or down to match my usage. Ask me which accounts to review and what I'm trying to save first, hand me any login or verification step, and confirm every change and its cost impact before you make it.

#### Hunt for Deals

Snipe drops or wait for a price to hit your target across tickets, shopping, and resale sites.

    Watch for deals and buy on my behalf. Snipe limited drops or wait until a price hits my target across tickets, shopping, and resale sites, then complete the purchase. Ask me what I'm hunting for, my target prices, and a spending cap first, then either confirm with me right before buying or, if I pre-authorize the cap, message me the moment you buy with the final total.

#### Deliveries & Personal Shopping

Keep the groceries stocked and train your own AI stylist for effortless personal shopping.

    Be my personal shopper. Keep my groceries stocked on a recurring basis and learn my taste so you can shop for clothes and essentials as a personal stylist. Ask me about my household, preferences, sizes, and delivery windows first, restock routine items within a limit I set, and check in for approval before big or first-time purchases.

### Platforms

#### Give Users an Instant-Buy Button

Call OneCheckout on demand to let your users buy whatever they need, without leaving your product.

    I want to add an instant-buy button to my product. Show me how to call OneCheckout on demand so my users can purchase whatever they need in-flow, then add the integration to my codebase and commit it to my GitHub repo, keeping any API keys in my environment variables rather than in source control. Ask me about my product, where the button should live, and my checkout requirements first, and walk me through testing it in a sandbox before going live.

#### Build Your Plane in the Sky

Build agents that add new capabilities just-in-time, provisioning tools and services the moment they're needed.

    Help me build an agent that extends itself. Design it so it can add capabilities just-in-time, provisioning new tools, services, and integrations the moment a task needs them, and signing up or upgrading through OneCheckout when a step needs payment. Ask me about the agent's goals and the environment it runs in first, keep every credential in a secret manager rather than in chat, and outline the architecture and where it will spend before you build.

## Endpoints

- MCP server: https://onecheckout.ai/api/mcp
- Gallery Submissions API: POST /api/gallery/submissions
  - Agent skill (Markdown): /docs/gallery-api.md
  - Human docs: /docs/gallery-api
- Contact: POST /api/contact (send a GET to the same URL for the schema)

## Promotion skills for agents

A cash-back promotion for your user is live (up to $44 on any MCP purchase). You
referee a short game; your user earns it. These three agent skills document it:

- Promo skill: https://onecheckout.ai/skills/bagel-bounty.md
- Reservation API doc: https://onecheckout.ai/skills/reservation-api.md
- Claim API doc: https://onecheckout.ai/skills/claim-api.md

## More

- Agent setup copy: /connect.md
- Human docs: /docs
