diff --git a/src/pages/quickstart/agent.mdx b/src/pages/quickstart/agent.mdx index 7d6851de..4b0b8551 100644 --- a/src/pages/quickstart/agent.mdx +++ b/src/pages/quickstart/agent.mdx @@ -1,5 +1,5 @@ --- -description: "Connect your coding agent to MPP-enabled services. Set up Tempo Wallet or the mppx SDK to handle 402 payment flows automatically." +description: "Connect your coding agent to MPP-enabled services. Set up a wallet to handle payment flows automatically." imageDescription: "Connect your agent to paid APIs" --- @@ -9,16 +9,22 @@ import { Badge, Card, Cards, Tab, Tabs } from 'vocs' Agents can automatically interact with MPP-enabled services, paying for API calls without human intervention. Learn more about [agentic payments](/use-cases/agentic-payments) or get started below. +| Tool | Best for | Setup | +|------|----------|-------| +| [Tempo Wallet](#tempo-wallet) | MPP services with spend controls and service discovery | `tempo wallet login` | +| [Privy Agent CLI](#privy-agent-cli) | Multi-chain agent wallets with browser-based funding | `privy-agent-wallets login` | +| [AgentCash](#agentcash) | Discover and use 300+ premium APIs via MPP | `npx agentcash onboard` | +| [`mppx` CLI](#mppx) | Development and debugging | `mppx account create` | + ## Tempo Wallet Recommended -The [Tempo Wallet](https://wallet.tempo.xyz) is a managed MPP client with built in spend controls and service discovery. Agents can use `tempo wallet` to pay for powerful new capabilities on demand. +The [Tempo Wallet](https://wallet.tempo.xyz) is a managed MPP client with built in spend controls and service discovery. Agents can use `tempo wallet` to discovery and pay for MPP-enabled services on demand. Paste this into your agent to set up Tempo Wallet: - ``` Read https://tempo.xyz/SKILL.md and set up tempo ``` @@ -63,6 +69,110 @@ tempo request -X POST \ +## Privy Agent CLI + +[Privy Agent CLI](https://docs.privy.io/recipes/agent-integrations/agent-cli) gives agents a CLI-first way to create, fund, and manage wallets with no integration code. It pairs with the [Agent Sandbox](https://agents.privy.io/) where users track agent spending, manage funds, and revoke access. + +The agent never holds the wallet private key—each CLI session generates a P-256 keypair used to sign authorization payloads. + + + + +Paste this into your agent to set up Privy Agent CLI: + +``` +Set up https://agents.privy.io/skill.md +``` + + + +::::steps + +#### Install + +```bash +npm install -g @privy-io/agent-wallet-cli +``` + +#### Log in + +```bash +privy-agent-wallets login +``` + +This opens a browser flow—complete Privy auth, approve signer access, then paste the credential back into the terminal. + +#### Fund wallets + +```bash +privy-agent-wallets fund +``` + +#### List wallets + +```bash +privy-agent-wallets list-wallets +``` + +#### Send a transaction + +```bash +privy-agent-wallets rpc --json '{"method": "eth_sendTransaction", "params": {"to": "0xRecipient", "value": "0.01"}}' +``` + +:::: + + + +## AgentCash + +[AgentCash](https://agentcash.dev) gives agents instant access to 300+ premium APIs for data enrichment, social data, image generation, web scraping, email, and much more, all through one USDC balance. + + + + +Paste this into your agent to set up AgentCash: + +``` +Set up agentcash.dev/skill.md +``` + + + +::::steps + +#### Onboard and get free credits + +Visit [agentcash.dev/onboard](https://agentcash.dev/onboard) to claim a sign-up bonus, then redeem in your terminal: + +```bash +npx agentcash onboard +``` + +#### Search for services + +```bash +npx agentcash search "image generation" +``` + +#### Use a service + +```bash +npx agentcash fetch https://stableenrich.dev/api/exa/search \ + --method POST \ + --body '{"query":"agentcash.dev"}' +``` + +#### Install as MCP server (optional) + +```bash +claude mcp add agentcash --scope user -- npx -y agentcash@latest +``` + +:::: + + + ## mppx The [`mppx`](/sdk/typescript/cli) CLI is a lightweight MPP client bundled with the `mppx` package. It is designed for simple use cases and debugging during development. @@ -97,6 +207,7 @@ mppx https://mpp.dev/api/ping/paid :::: + ## Next steps @@ -106,4 +217,10 @@ mppx https://mpp.dev/api/ping/paid title="Services" to="/services" /> + diff --git a/src/pages/tools/wallet.mdx b/src/pages/tools/wallet.mdx new file mode 100644 index 00000000..73cb24e8 --- /dev/null +++ b/src/pages/tools/wallet.mdx @@ -0,0 +1,260 @@ +--- +description: "Agent wallets for MPP -- enable your agent to pay for services." +imageDescription: "Enable your agent to pay for services" +--- + +import { Badge, Card, Cards, Tab, Tabs } from 'vocs' + +# Wallets [Give your agent a wallet] + +Agents need a wallet to pay for MPP-enabled services. Choose the wallet that fits your use case best. + +| Wallet | Best for | Supported methods | Setup | +|--------|----------|-------------------|-------| +| [Tempo Wallet](#tempo-wallet) | Tempo MPP services with spend controls and service discovery | `tempo` | `tempo wallet login` | +| [Privy Agent CLI](#privy-agent-cli) | Multi-chain agent wallets with browser-based funding | `tempo`, `solana` | `privy-agent-wallets login` | +| [AgentCash](#agentcash) | Discover and use 300+ premium APIs via MPP | `tempo` | `npx agentcash onboard` | +| [`mppx` CLI](#mppx) | Development and debugging | All | `mppx account create` | + +## Tempo Wallet + +The [Tempo Wallet](https://wallet.tempo.xyz) is a managed MPP client with built-in spend controls and service discovery. Agents use `tempo wallet` to discovery and pay for MPP-enabled services on demand. + + + + +Paste this into your agent: + +``` +Read https://tempo.xyz/SKILL.md and set up tempo +``` + + + +::::steps + +### Install the CLI + +```bash +curl -fsSL https://tempo.xyz/install | bash +``` + +### Connect your wallet + +```bash +tempo wallet login +``` + +### Verify setup + +```bash +tempo wallet whoami +``` + +### List available services + +```bash +tempo wallet services +``` + +### Make a paid request + +```bash +tempo request -X POST \ + --json '{"prompt": "a sunset over the ocean"}' \ + https://fal.mpp.tempo.xyz/fal-ai/flux/dev +``` + +:::: + + + +**Supported methods:** tempo.charge tempo.session + +**Key features:** + +- **Service discovery**—`tempo wallet services` lists endpoints, pricing, and request schemas +- **Spend controls**—scoped access keys enforce per-key spending limits +- **Dry-run previews**—`tempo request --dry-run` validates cost before committing funds +- **Efficient output**—`-t` flag gives compact, machine-readable output for agent tooling + +## Privy Agent CLI + +[Privy Agent CLI](https://docs.privy.io/recipes/agent-integrations/agent-cli) gives agents a CLI-first way to create, fund, and manage wallets with no integration code. It pairs with the [Privy Agent Sandbox](https://agents.privy.io/) where users track spending, manage funds, and revoke access. + +The agent never holds the wallet private key—each session generates a P-256 keypair used to sign authorization payloads. + + + + +Paste this into your agent: + +``` +Set up https://agents.privy.io/skill.md +``` + + + +::::steps + +### Install + +```bash +npm install -g @privy-io/agent-wallet-cli +``` + +### Log in + +```bash +privy-agent-wallets login +``` + +This opens a browser flow—complete Privy auth, approve signer access, then paste the credential back into the terminal. + +### Fund wallets + +```bash +privy-agent-wallets fund +``` + +### List wallets + +```bash +privy-agent-wallets list-wallets +``` + +### Send a transaction + +```bash +privy-agent-wallets rpc --json '{"method": "eth_sendTransaction", "params": {"to": "0xRecipient", "value": "0.01"}}' +``` + +:::: + + + +**Supported methods:** tempo.charge tempo.session solana.charge + +**Key features:** + +- **No private key exposure**—each session generates a P-256 keypair; the agent signs authorization payloads, never holds the wallet key +- **Browser-based funding**—the human owner retains a visual dashboard to check balances, view history, and onramp funds +- **Session management**—sessions stored in the OS credential manager, expire after seven days, revocable from [agents.privy.io/manage](https://agents.privy.io/manage) + +## AgentCash + +[AgentCash](https://agentcash.dev) gives agents instant access to 300+ premium APIs for data enrichment, social data, image generation, web scraping, email, and much more, all through one USDC balance. + + + + +Paste this into your agent: + +``` +Set up agentcash.dev/skill.md +``` + + + +::::steps + +### Onboard and get free credits + +Visit [agentcash.dev/onboard](https://agentcash.dev/onboard) to claim a sign-up bonus, then redeem in your terminal: + +```bash +npx agentcash onboard +``` + +### Search for services + +```bash +npx agentcash search "image generation" +``` + +### Use a service + +```bash +npx agentcash fetch https://stableenrich.dev/api/exa/search \ + --method POST \ + --body '{"query":"agentcash.dev"}' +``` + +### Install as MCP server (optional) + +```bash +claude mcp add agentcash --scope user -- npx -y agentcash@latest +``` + +:::: + + + +**Supported methods:** tempo.charge + +**Key features:** + +- **300+ premium APIs** - enrichment, social data, image generation, web scraping, email, all accessible instantly +- **No human required** - pay per request with USDC, no subscriptions or manual sign-up flows +- **API and tool discovery** - any service that implements MPP is automatically discoverable and usable +- **MPPScan integration** — easily discover and use services via [mppscan.com](https://www.mppscan.com/) + +## `mppx` + +The [`mppx`](/sdk/typescript/cli) CLI is a lightweight MPP client bundled with the `mppx` package. It handles `402` responses automatically using a local keychain account—ideal for development, testing, and debugging. + +::::steps + +### Install + +:::code-group +```bash [npm] +npm install -g mppx +``` +```bash [pnpm] +pnpm add -g mppx +``` +```bash [bun] +bun add -g mppx +``` +::: + +### Create an account + +```bash +mppx account create +``` + +### Make a paid request + +```bash +mppx https://mpp.dev/api/ping/paid +``` + +:::: + +**Supported methods:** tempo.charge tempo.session stripe.charge solana.charge + +**Key features:** + +- **Zero config**—create an account and start making paid requests immediately +- **All payment methods**—supports every payment method implemented in the `mppx` SDK +- **Local keychain**—private keys stored in the OS keychain, configurable via `MPPX_PRIVATE_KEY` env var +- **Development-first**—designed for testing and debugging MPP integrations + +## Next steps + + + + + diff --git a/vocs.config.ts b/vocs.config.ts index b323b11a..baa9458a 100644 --- a/vocs.config.ts +++ b/vocs.config.ts @@ -837,6 +837,10 @@ export default defineConfig({ }, ], }, + { + text: "Tools", + items: [{ text: "Wallets", link: "/tools/wallet" }], + }, { text: "Use Cases", items: [