docs: copy improvements across landing, overview, FAQ, and quickstart (#317)

Author: brendanjryan

src/components/LandingPage.tsx

@@ -528,12 +528,12 @@ function Hero() {
               }}
               onClick={() =>
                 captureEvent(AnalyticsEvents.LANDING_CTA_CLICKED, {
-                  cta_label: "Monetize your API",
+                  cta_label: "Add payments to your API",
                   href: "/quickstart/server",
                 })
               }
             >
-              Monetize your API
+              Add payments to your API
             </Link>
           </div>
         </div>
@@ -552,8 +552,9 @@ function Tagline() {
       className="leading-relaxed max-w-xl font-normal max-[1080px]:max-w-lg"
       style={{ color: "var(--vocs-text-color-secondary)" }}
     >
-      The open protocol for internet-native payments. Charge for API requests,
-      tool calls, or content. Agents, apps, and humans securely pay per request.
+      The open protocol for machine-to-machine payments. Charge for API
+      requests, tool calls, or content—agents and apps pay per request in the
+      same HTTP call.
     </div>
   );
 }

src/pages.gen.ts

@@ -94,6 +94,9 @@ type Page =
 | { path: '/payment-methods/tempo/session'; render: 'static' }
 | { path: '/payment-methods/stripe/charge'; render: 'static' }
 | { path: '/payment-methods/stripe'; render: 'static' }
+| { path: '/payment-methods/lightning/charge'; render: 'static' }
+| { path: '/payment-methods/lightning'; render: 'static' }
+| { path: '/payment-methods/lightning/session'; render: 'static' }
 | { path: '/intents/charge'; render: 'static' }
 | { path: '/guides/building-with-an-llm'; render: 'static' }
 | { path: '/guides/one-time-payments'; render: 'static' }

src/pages/faq.mdx

@@ -1,9 +1,5 @@
 # Frequently asked questions [Common questions about the Machine Payments Protocol]
 
-## What is MPP?
-
-The Machine Payments Protocol (MPP) is an internet-native protocol that lets any client—agents, software, or humans—pay for services inline over HTTP. The protocol is payment-method agnostic, open by design, and engineered for extensibility, performance, and security.
-
 ## Is MPP only for stablecoins?
 
 No. MPP is payment-method agnostic—the protocol works with any payment rail.
@@ -12,7 +8,7 @@ Today, [Tempo](/payment-methods/tempo) stablecoin payments, [Stripe](/payment-me
 
 ## Do I need a stablecoin wallet?
 
-No. Stripe supports cards and numerous fiat methods. Lightning supports Bitcoin. MPP is payment-method agnostic—any rail can be integrated.
+No. With Stripe, you can pay with cards without stablecoins. With Lightning, you can pay with Bitcoin.
 
 For Tempo payments, you need a stablecoin wallet to sign transactions. The SDK and the `tempo wallet` CLI handle key management for you.
 
@@ -32,9 +28,11 @@ Yes. The core x402 "exact" flows map directly onto MPP's charge intent. MPP clie
 
 ## Why build MPP on Tempo?
 
-High-throughput, low-value transactions require specific properties from the settlement layer:
+MPP works with any payment rail—Stripe for cards, Lightning for Bitcoin, or any custom method. You don't have to use Tempo.
+
+That said, high-throughput, low-value transactions benefit from specific properties that Tempo provides:
 
-- **Fast, deterministic finality**—Tempo consensus provides certainty that a payment has settled, not probabilistic confirmation.
+- **Fast, deterministic finality**—Certainty that a payment has settled, not probabilistic confirmation.
 - **Low, predictable cost**—Transaction fees stay stable regardless of global network congestion.
 - **Payment lanes**—Dedicated transaction routing for payment traffic, ensuring reliability even under heavy load.
 - **Stablecoin-native**—TIP-20 stablecoins (USDC, USDT) are first-class citizens, so payments are denominated in familiar currency.
@@ -59,12 +57,6 @@ MPP requires TLS 1.2+ for all connections. Challenge IDs are cryptographically b
 
 Payments use the same security model as the underlying payment method. For Tempo, that means cryptographic signatures over every transaction. For Stripe, it means Stripe's existing fraud and dispute infrastructure.
 
-## Can any agent use MPP?
-
-Yes. Any agent can interact with MPP services via a compatible CLI or SDK. The [quickstart guide](/quickstart/agent) has copy-paste setup instructions for Claude, Codex, and Amp.
-
-For programmatic integration, the [TypeScript](/sdk/typescript), [Python](/sdk/python), and [Rust](/sdk/rust) SDKs provide native support.
-
 ## What happens if a payment fails?
 
 The service returns an error with details following [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) (Problem Details for HTTP APIs). Your client can retry with a different payment method or surface the error. No money is deducted for failed requests.

src/pages/overview.mdx

@@ -4,16 +4,16 @@ import { TerminalPing } from '../components/TerminalPing'
 import { TypeScriptSdkCard, PythonSdkCard, RustSdkCard, QuickstartCard, ProtocolConceptsCard } from '../components/cards'
 import { PaymentFlowDiagram } from '../components/PaymentFlowDiagram'
 
-# Machine Payments Protocol [The open protocol for internet-native payments]
+# Machine Payments Protocol [The open protocol for machine-to-machine payments]
 
-The Machine Payments Protocol (MPP) lets any client—agents, apps, or humans—pay for any service, inline, over HTTP. Developers use MPP to let their agents pay for services. Service operators use MPP to monetize their APIs.
+The Machine Payments Protocol (MPP) lets any client—agents, apps, or humans—pay for any service in the same HTTP request. Developers use MPP to let their agents pay for services. Service operators use MPP to accept payments for their APIs.
 
-MPP is built around a simple extensible core and is neutral to the implementation of underlying payment flows and methods.
+MPP is built around a simple, extensible core and is neutral to the implementation of underlying payment flows and methods.
 
 - **Open standard built for the internet**—Built on an [open specification proposed to the IETF](https://paymentauth.org), not a proprietary API
 - **Designed for payments**—Idempotency, security, and receipts are first-class primitives
-- **Multi rail**—Stablecoins, cards, bank transfers, and digital wallets. All payment methods can be supported through one protocol and flexible control flow
-- **Multi currency**—The protocol is currency agnostic, allowing for transactions in USD, EUR, BRL, USDC, BTC, or any other asset
+- **Works with stablecoins, cards, and bank transfers**—All payment methods can be supported through one protocol and flexible control flow
+- **Any currency**—Transact in USD, EUR, BRL, USDC, BTC, or any other asset
 - **Composable and designed for extension**—A flexible core allows advanced flows like disputes or additional primitives like identity to be gradually introduced
 
 ## Who is MPP for?
@@ -22,7 +22,7 @@ MPP involves three parties:
 
 - **Developers** build apps and agents that consume paid services. You integrate an MPP client so your agent can discover, pay for, and use third-party APIs without manual signup or API keys.
 - **Agents** are the entities that take action—calling APIs, generating images, querying data. They pay for services autonomously on behalf of your users.
-- **Services** operate APIs that charge for access—LLM inference, image generation, web search, and more. You integrate an MPP server to accept payments inline with zero onboarding friction.
+- **Services** operate APIs that charge for access—LLM inference, image generation, web search, and more. You integrate an MPP server to accept payments with zero onboarding friction.
 
 ## The problem with payments on the internet
 
@@ -32,7 +32,7 @@ However, the very things that make these payment flows familiar and fast for hum
 
 This is not the fault of any individual payment method or credential. This is a global problem which exists at the _interface_ level: how buyer and seller negotiate cost, supported payment methods, and ultimately transact.
 
-The Machine Payments Protocol addresses this gap by providing an internet-native payment interface that strips away the complexity of rich checkout flows, while still providing robust security and reliability. By using MPP, you can accept payments from any client — agents, apps, or humans — and across any payment method, without the need for a complex checkout flows and integrations.
+The Machine Payments Protocol addresses this gap by providing a payment interface built for programmatic access that strips away the complexity of rich checkout flows, while still providing robust security and reliability. By using MPP, you can accept payments from any client—agents, apps, or humans—and across any payment method, without complex checkout flows and integrations.
 
 ## Try it out
 
@@ -45,9 +45,9 @@ See the full payment flow in action. The terminal creates an ephemeral wallet, f
 ## Use cases
 
 * **Pay for LLM usage**—Your agent calls LLM providers through MPP, paying per token over a Tempo session. No API key management needed.
-* **Generate an image**—Request image generation from fal.ai or ElevenLabs audio, paying per request with a Tempo charge. The agent gets the result inline.
+* **Generate an image**—Request image generation from fal.ai or ElevenLabs audio, paying per request with a Tempo charge. The agent gets the result in the same response.
 * **Search the web**—Query Parallel for real-time search results, paying per query over a Tempo session. Results flow back in the same HTTP response.
-* **Monetize your API**—Accept payments from any client—agents, apps, or humans—without requiring signups, billing accounts, or API keys.
+* **Accept payments for your API**—Accept payments from any client—agents, apps, or humans—without requiring signups, billing accounts, or API keys.
 
 ## Payment flow
 

src/pages/protocol/index.mdx

@@ -3,7 +3,7 @@ import { PaymentFlowDiagram } from "../../components/PaymentFlowDiagram";
 
 # Protocol overview [Standardizing HTTP 402 for machine-to-machine payments]
 
-The Machine Payments Protocol (MPP) is an internet-native protocol for machine-to-machine payments. It standardizes HTTP `402` "Payment Required" with an extensible framework that works with any payment network.
+The Machine Payments Protocol (MPP) is a protocol for machine-to-machine payments. It standardizes HTTP `402` "Payment Required" with an extensible framework that works with any payment network.
 
 These docs provide a developer-friendly overview. For the full specification, see the full [IETF Specification](https://paymentauth.org).
 

src/pages/quickstart/server.mdx

@@ -2,15 +2,15 @@ import { Badge, Cards } from 'vocs'
 import { ServerPrompt } from '../../components/QuickstartPrompt'
 import { ClientQuickstartCard, TempoMethodCard, MppxCreateReferenceCard } from '../../components/cards'
 
-# Monetize your API [Charge for access to protected resources]
+# Add payments to your API [Charge for access to protected resources]
 
 ## Overview
 
 This quickstart demonstrates how to plug MPP into any server framework to accept payments for protected resources. Pick the path that suits you:
 
 - [**Prompt mode**](#prompt-mode): paste a prompt into your coding agent and build in one prompt
 - [**Framework mode**](#framework-mode): use `mppx` middleware for Next.js, Hono, Elysia, or Express
-- [**Manual mode**](#manual-mode): call `mppx/server` directly with the Fetch API
+- [**Manual mode**](#advanced-manual-mode): call `mppx/server` directly with the Fetch API
 
 ## Prompt mode
 
@@ -30,7 +30,7 @@ import { Mppx, tempo } from 'mppx/nextjs'
 // [!code hl:start]
 const mppx = Mppx.create({
   methods: [tempo({
-    currency: '0x20c0000000000000000000000000000000000000',
+    currency: '0x20c0000000000000000000000000000000000000', // pathUSD on Tempo
     recipient: '0xa726a1CD723409074DF9108A2187cfA19899aCF8',
   })],
 })
@@ -119,10 +119,10 @@ mppx.charge({
 :::
 
 :::note
-Don't see your framework? `mppx` is designed to be framework-agnostic. See [Manual mode](#manual-mode) below.
+Don't see your framework? `mppx` is designed to be framework-agnostic. See [Manual mode](#advanced-manual-mode) below.
 :::
 
-## Manual mode
+## Advanced: manual mode
 
 If you prefer full control over the payment flow, use `mppx/server` directly with the Fetch API.
 

vocs.config.ts

@@ -95,7 +95,7 @@ export default defineConfig({
         text: "Quick Start",
         items: [
           { text: "Overview", link: "/quickstart" },
-          { text: "Monetize your service", link: "/quickstart/server" },
+          { text: "Add payments to your API", link: "/quickstart/server" },
           { text: "Use with agents", link: "/quickstart/agent" },
           { text: "Use with your app", link: "/quickstart/client" },
         ],
@@ -104,15 +104,15 @@ export default defineConfig({
         text: "Guides",
         items: [
           {
-            text: "Accept One-Time Payments",
+            text: "Accept one-time payments",
             link: "/guides/one-time-payments",
           },
           {
-            text: "Accept Pay-As-You-Go Payments",
+            text: "Accept pay-as-you-go payments",
             link: "/guides/pay-as-you-go",
           },
           {
-            text: "Accept Streamed Payments",
+            text: "Accept streamed payments",
             link: "/guides/streamed-payments",
           },
         ],
@@ -182,9 +182,9 @@ export default defineConfig({
             text: "TypeScript",
             collapsed: true,
             items: [
-              { text: "Getting Started", link: "/sdk/typescript" },
+              { text: "Getting started", link: "/sdk/typescript" },
               {
-                text: "Client Reference",
+                text: "Client reference",
                 items: [
                   {
                     text: "Methods",
@@ -247,7 +247,7 @@ export default defineConfig({
                 ],
               },
               {
-                text: "Server Reference",
+                text: "Server reference",
                 items: [
                   {
                     text: "Methods",
@@ -318,7 +318,7 @@ export default defineConfig({
                 ],
               },
               {
-                text: "Middleware Reference",
+                text: "Middleware reference",
                 items: [
                   {
                     text: "Elysia",
@@ -339,7 +339,7 @@ export default defineConfig({
                 ],
               },
               {
-                text: "Core Reference",
+                text: "Core reference",
                 items: [
                   {
                     text: "BodyDigest",
@@ -476,15 +476,15 @@ export default defineConfig({
                   },
                 ],
               },
-              { text: "CLI Reference", link: "/sdk/typescript/cli" },
+              { text: "CLI reference", link: "/sdk/typescript/cli" },
             ],
           },
           {
             text: "Python",
             collapsed: true,
             items: [
               { text: "Overview", link: "/sdk/python" },
-              { text: "Core Types", link: "/sdk/python/core" },
+              { text: "Core types", link: "/sdk/python/core" },
               { text: "Client", link: "/sdk/python/client" },
               { text: "Server", link: "/sdk/python/server" },
             ],
@@ -494,7 +494,7 @@ export default defineConfig({
             collapsed: true,
             items: [
               { text: "Overview", link: "/sdk/rust" },
-              { text: "Core Types", link: "/sdk/rust/core" },
+              { text: "Core types", link: "/sdk/rust/core" },
               { text: "Client", link: "/sdk/rust/client" },
               { text: "Server", link: "/sdk/rust/server" },
             ],