# Micropay Test Suite

> Micropay Test Suite is a free MCP server for finance and payments. Testnet playground for checking that an AI agent can complete x402 payments. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI
- **Website:** https://micropay-test-suite.netlify.app
- **MCP Registry name:** app.netlify.micropay-test-suite/micropay-test-suite
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The Micropay Test Suite lets developers confirm that an AI agent can handle a full x402 payment exchange before any real funds are involved. The agent requests a test endpoint, receives a 402 Payment Required response, signs a payment, retries, and gets back a receipt if the flow works.

Payments run on the Base Sepolia testnet, so no production spend is needed. The browser version signs payments locally and the signing key is never sent to the server. The same endpoint can also be called directly with curl or an x402 client for scripted checks.

The suite is aimed at teams building agents that pay for API access with micropayments and want a cheap way to validate their payment stack. The MCP entry exposes the same test flow to AI clients over streamable HTTP.

## Features

- **Testnet payment flow:** Runs the 402-pay-retry cycle on Base Sepolia so payment logic can be tested without real money.
- **Local browser signing:** Signs test payments in the browser, with keys kept on the client side rather than sent to the server.
- **Curl-compatible endpoint:** Exposes the test endpoint over plain HTTP so command-line tools and scripts can exercise the flow.
- **Signed receipt output:** Returns a receipt as proof that the payment was constructed, signed and accepted.
- **MCP server access:** Provides the test flow to AI clients through a streamable HTTP MCP endpoint.

## Good for

- Verify that an agent can construct and sign an x402 payment before launch
- Test a payment integration against Base Sepolia without spending real funds
- Check that an agent retries correctly after receiving a 402 Payment Required response
- Run scripted payment checks in CI using curl or an x402 client

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http micropay-test-suite https://micropay-test-suite.netlify.app/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://micropay-test-suite.netlify.app/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "micropay-test-suite": {
      "url": "https://micropay-test-suite.netlify.app/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "micropay-test-suite": {
      "type": "http",
      "url": "https://micropay-test-suite.netlify.app/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "micropay-test-suite": {
      "serverUrl": "https://micropay-test-suite.netlify.app/api/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://micropay-test-suite.netlify.app/api/mcp
```

Enter a Name (for example "Micropay Test Suite"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "micropay-test-suite": {
      "type": "http",
      "url": "https://micropay-test-suite.netlify.app/api/mcp"
    }
  }
}
```

## Tools

- `check_payment_flow`: Verifies an agent's x402 payment flow against a free Base Sepolia testnet endpoint. Call with no arguments first to get back the payment-required challenge (price, network, payTo). Sign it with your x402 client, then call again passing paymentSignature as the encoded PAYMENT-SIGNATURE header value to get back a verified/failed receipt.

## FAQ

### Does this move real money?

No. The suite is described as testnet only and the free check says no money moves.

### Which network does it use?

The MCP registry entry and the product's description point to the Base Sepolia testnet.

### How do I call the endpoint directly?

The site shows a GET request to /api/test-payment that returns 402 Payment Required, then a retry with an X-PAYMENT header that returns 200 OK with receipt JSON.

### Is the signing key sent to the server?

The site says payments are signed locally in the browser and are never sent to its server.

### Is Micropay Test Suite free?

Yes. Micropay Test Suite is free to use.

### How do I add Micropay Test Suite to Claude Code?

Run this command in your terminal: claude mcp add --transport http micropay-test-suite https://micropay-test-suite.netlify.app/api/mcp

### What are the best alternatives to Micropay Test Suite?

The closest alternatives to Micropay Test Suite are X402 Payagent MCP, PayStage x402 Guard — payment safety before the wallet signs, Clawpay, Agent Receipt Verify and Minia2a MCP Remote.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [X402 Payagent MCP](https://ai-powered.com/mcp/x402-payagent-mcp): X402 Payagent MCP is an open-source MCP server for finance and payments.
- [PayStage x402 Guard — payment safety before the wallet signs](https://ai-powered.com/mcp/paystage-x402-guard-payment-safety-before-the-wallet-signs): PayStage x402 Guard — payment safety before the wallet signs is a freemium MCP server for finance and payments.
- [Clawpay](https://ai-powered.com/mcp/clawpay): Clawpay is an open-source MCP server for finance and payments.
- [Agent Receipt Verify](https://ai-powered.com/mcp/agent-receipt-verify): Agent Receipt Verify is an open-source MCP server for finance and payments.
- [Minia2a MCP Remote](https://ai-powered.com/mcp/minia2a-mcp-remote): Minia2a MCP Remote is an MCP server for finance and payments.
- [Minia2a MCP](https://ai-powered.com/mcp/minia2a-mcp-2): Minia2a MCP is a paid MCP server for finance and payments.
- [PayStage — x402 payment safety and spend policy](https://ai-powered.com/mcp/paystage-x402-payment-safety-and-spend-policy): PayStage — x402 payment safety and spend policy is an open-source MCP server for finance and payments.
- [x402Shield](https://ai-powered.com/mcp/x402shield): x402Shield is an MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/micropay-test-suite
