From 4a8f6a0cbdb71121999f1f5a929998bd1264910c Mon Sep 17 00:00:00 2001
From: tmm <tmm@tmm.dev>
Date: Mon, 23 Mar 2026 11:44:14 -0400
Subject: [PATCH] feat: add mppx agent skill and fix skills CLI command

---
 skills/mppx/SKILL.md                      | 88 +++++++++++++++++++++++
 src/pages/guides/building-with-an-llm.mdx |  2 +-
 2 files changed, 89 insertions(+), 1 deletion(-)
 create mode 100644 skills/mppx/SKILL.md

diff --git a/skills/mppx/SKILL.md b/skills/mppx/SKILL.md
new file mode 100644
index 00000000..a282fc68
--- /dev/null
+++ b/skills/mppx/SKILL.md
@@ -0,0 +1,88 @@
+---
+name: mppx
+description: TypeScript SDK for the Payment HTTP Authentication Scheme. Handles 402 Payment Required flows with Tempo, Stripe, and other payment methods. Use when integrating payments or mppx into a client or server application.
+---
+
+# mppx
+
+TypeScript SDK for the "Payment" HTTP Authentication Scheme. Full 402 flow: challenge → credential → receipt.
+
+## Client
+
+```ts
+import { Mppx, tempo } from 'mppx/client'
+
+// Polyfills globalThis.fetch to handle 402 automatically
+Mppx.create({
+  methods: [tempo({ account })],
+})
+
+const res = await fetch('https://api.example.com/resource')
+```
+
+Without polyfilling:
+
+```ts
+const mppx = Mppx.create({
+  methods: [tempo({ account })],
+  polyfill: false,
+})
+
+const res = await mppx.fetch('https://api.example.com/resource')
+```
+
+## Server
+
+```ts
+import { Mppx, tempo } from 'mppx/server'
+
+const mppx = Mppx.create({
+  methods: [tempo({ currency: '0x...', recipient: '0x...' })],
+  secretKey: process.env.MPP_SECRET_KEY,
+})
+
+async function handler(request: Request): Promise<Response> {
+  const result = await mppx.charge({ amount: '1.00' })(request)
+  if (result.status === 402) return result.challenge
+  return result.withReceipt(Response.json({ data: '...' }))
+}
+```
+
+## Methods
+
+| Method | Intent | Description |
+|---|---|---|
+| `tempo.charge` | `charge` | One-time stablecoin payment (TIP-20 token transfer on Tempo) |
+| `tempo.session` | `session` | Streaming payments via payment channels on Tempo |
+| `stripe.charge` | `charge` | One-time payment via Stripe |
+
+`tempo()` returns `[tempo.charge, tempo.session]` as a tuple. Use `tempo.charge()` or `tempo.session()` individually if you only need one intent.
+
+## Exports
+
+| Path | Purpose |
+|---|---|
+| `mppx` | Core primitives (`Challenge`, `Credential`, `Method`, `Receipt`, `PaymentRequest`) |
+| `mppx/client` | `Mppx`, `tempo`, `stripe`, `session`, `Transport` |
+| `mppx/server` | `Mppx`, `tempo`, `stripe`, `Transport`, `Store`, `NodeListener` |
+| `mppx/hono` | Hono middleware |
+| `mppx/express` | Express middleware |
+| `mppx/nextjs` | Next.js middleware |
+| `mppx/elysia` | Elysia middleware |
+
+## CLI
+
+`mppx` includes a CLI for making paid requests during development:
+
+```sh
+npx mppx account create        # create wallet
+npx mppx mpp.dev/api/ping/paid # make paid request
+npx mppx example.com -v        # verbose output
+```
+
+## References
+
+- Docs: https://mpp.dev/sdk/typescript
+- Repo: https://github.com/wevm/mppx
+- Spec: https://github.com/tempoxyz/payment-auth-spec
+- Tempo: https://docs.tempo.xyz
diff --git a/src/pages/guides/building-with-an-llm.mdx b/src/pages/guides/building-with-an-llm.mdx
index 7438935a..6a0d823a 100644
--- a/src/pages/guides/building-with-an-llm.mdx
+++ b/src/pages/guides/building-with-an-llm.mdx
@@ -28,7 +28,7 @@ These alternatives provide different ways to consume the docs depending on your
 Install skills for your coding agent using the [`skills` CLI](https://github.com/vercel-labs/skills):
 
 ```bash [terminal]
-npx skills install wevm/mppx -g
+npx skills add tempoxyz/mpp -g
 ```
 
 After installing, your agent knows how to integrate `mppx` with your chosen framework.