open-index/open-npm huggingface dataset:
npm package: @paynodelabs/paynode-402-cli
Description: The official command-line interface for the PayNode protocol. Designed for AI Agents to execute stateless micro-payments via HTTP 402.
Author: PayNode Labs
Latest version: 2.6.0

# ⚡ paynode-402-cli

[![Base L2](https://img.shields.io/badge/Network-Base%20L2-0052FF?style=for-the-badge&logo=base)](https://base.org)
[![HTTP 402](https://img.shields.io/badge/Protocol-x402-00ff88?style=for-the-badge)](https://paynode.dev)

The official command-line interface for the [PayNode](https://github.com/PayNodeLabs) protocol. Designed specifically for the **Agentic Era**, allowing AI Agents to execute zero-install, stateless micro-payments via the HTTP 402 standard.

---

## 🛠️ Configuration & Credentials

To enable automated blockchain signing, this tool requires a private key provided via environment variables.

> [!IMPORTANT]
> **Mandatory Variable**: `CLIENT_PRIVATE_KEY` (0x...)
> All signature and payment operations rely on this key. Ensure it is set in your environment before execution.

> [!CAUTION]
> **BURNER WALLET ONLY**: NEVER use a primary or "cold storage" wallet. This tool is designed for autonomous agents; always use a dedicated burner wallet with minimal funds (< 10 USDC).

### Setup Example (Unix)
```bash
export CLIENT_PRIVATE_KEY="0x..."
bunx @paynodelabs/paynode-402-cli check
```

---

## 🤖 For AI Agents (Zero-Install)

Your agent can use this tool dynamically via `bunx` without any manual installation:

### 1. Check Readiness (Gas & USDC)
```bash
bunx @paynodelabs/paynode-402-cli check --network testnet --json
```

### 2. Access a 402-Protected API
The CLI automatically detects the 402 challenge, performs the handshake, signs the payment (on-chain or EIP-3009), and returns the final resource.
```bash
bunx @paynodelabs/paynode-402-cli request "https://api.example.com/data" --network testnet --json
```

### 3. Mint Test USDC (Base Sepolia)
```bash
bunx @paynodelabs/paynode-402-cli mint --amount 100 --network testnet
```

---

## 📑 Command Summary

| Command | Description |
| :--- | :--- |
| `check` | Check ETH/USDC balances and readiness on Base L2 |
| `mint` | Mint Mock USDC on Base Sepolia for testing |
| `request <URL>` | Access a protected resource by handling the 402 challenge |
| `list-paid-apis` | Discover payable APIs from the PayNode Marketplace |
| `get-api-detail <id>` | Inspect one marketplace API |
| `invoke-paid-api <id>` | Invoke a marketplace API using the 402 flow |

### Global Flags
- `--network <name>`: `mainnet` or `testnet` (default: `testnet`).
- `--json`: Format output as machine-readable JSON (preferred for Agents).
- `--confirm-mainnet`: Explicit flag required for real USDC transactions on mainnet.
- `--background`: Execute in background and return a `task_id` for long-running handshakes.

---

## 🔗 References
- **Marketplace**: [https://mk.paynode.dev](https://mk.paynode.dev)
- **Protocol SPEC**: [PayNode Docs](https://docs.paynode.dev)
- **GitHub**: [PayNodeLabs/paynode-402-cli](https://github.com/PayNodeLabs/paynode-402-cli)
npm package: @paynow-gg/typescript-sdk
Description: Official TypeScript SDK for the PayNow API - providing type-safe access to storefront and management endpoints
Author: PayNow Services Inc
Latest version: 1.0.56

# PayNow TypeScript SDK

A TypeScript/JavaScript SDK for the [PayNow.gg API](https://paynow.gitbook.io/paynow-api)

## Installation

```bash
npm install @paynow-gg/typescript-sdk
```

## Quick Start

```typescript
import { createStorefrontClient } from "@paynow-gg/typescript-sdk";

const storefront = createStorefrontClient("411486491630370816");

storefront.store.getStorefrontStore().then((res) => console.log(res.data));
```

For issues with the SDK, please open an issue on GitHub.
For PayNow API documentation and support, visit the PayNow developer portal.

## PayNow.gg Support

For support, questions, or more information, join our Discord community:

- [Discord](https://discord.com/invite/paynow)

## Contributing

Contributions are welcome! If you'd like to improve the SDK or suggest new features, please fork the repository, make your changes, and submit a pull request.
npm package: @payo/mcp
Description: Add micropayments to MCP tools. Charge per API call with one line of code.
Latest version: 0.3.1

# @payo/mcp

Payment rail for AI agents. Providers monetize MCP tools. Agents pay per call.

```
┌─────────┐      ┌─────────────┐      ┌──────────┐
│  Agent  │─────▶│ MCP Server  │─────▶│   Payo   │
│         │      │ + @payo/mcp │      │ Platform │
└─────────┘      └─────────────┘      └──────────┘
```

## For Agents

Get a token at [payo.dev](https://payo.dev), then connect to paid MCPs:

```bash
claude mcp add my-paid-mcp -e AGENT_TOKEN=sk_live_your_token \
  -- npx some-paid-mcp-server
```

## For Providers

```bash
npm install @payo/mcp
```

```typescript
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { withPayments } from '@payo/mcp';

const server = new McpServer({ name: 'my-api', version: '1.0.0' });

const paidServer = withPayments(server, {
  apiKey: process.env.PAYO_API_KEY,
  pricing: {
    'premium_tool': 0.10,
    'basic_tool': 0.01,
  },
});

paidServer.registerTool('premium_tool', { ... }, handler);
```

## Documentation

**[docs.payo.dev](https://docs.payo.dev/introduction)** — Full guides, SDK reference, examples

## License

MIT