# GenesisPay

> GenesisPay is an MCP server for finance and payments. Let an agent find x402 services and shop catalogues and pay in USDC within set limits. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** API, CLI, Web
- **Website:** https://genesispay.finance/docs/mcp
- **Repository:** https://github.com/genesistechat/genesispay-js/tree/HEAD/packages/mcp-server
- **MCP Registry name:** finance.genesispay/mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-18

## About

GenesisPay's server has two faces. The payment connector lets an agent search everything it can buy, including GenesisPay sellers' x402 services, physical shop products and an external x402 directory, then pay in USDC on Base. Spending policies and human approvals are enforced on the server, and the README lists seventeen tools. For physical products an agent first gets a read-only quote to the owner's saved shipping address, with subtotal, shipping, tax and total, and is told to have the user confirm both before buying.

The docs now say GenesisPay payments and payment APIs are paused, new accounts are closed, and the payment tools answer 503 payments_disabled with nothing charged. What still works is a read-only catalog connector at /mcp/catalog that needs no account or key. It searches stores that accept agent checkout through UCP, reports store health and returns their published discount codes, tagging results as main products or accessories based on the merchant's own categories.

There is a stdio npm package, @genesis-tech/genesispay-mcp, and a hosted remote that uses OAuth so web chats can connect without installing anything.

## Features

- **Unified discovery:** One search across GenesisPay sellers, shop products and an external x402 directory.
- **Priced quotes:** Read-only quote for physical goods to the saved address before any purchase.
- **Spending controls:** Policies and human approvals are enforced server-side.
- **Catalog connector:** Keyless read-only lookup of UCP stores, store health and discount codes.
- **Accessory awareness:** Search marks products as main items or accessories using merchant categories.
- **Stdio and remote:** Run the npm package or add the hosted URL as a connector with OAuth.

## Good for

- Search UCP-enabled stores from a chat without an account
- Find a pay-per-call x402 API and see its schema before paying
- Quote a physical product to a saved address
- Look up a store's published discount codes

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://genesispay.finance/mcp
```

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

```sh
https://genesispay.finance/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://genesispay.finance/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://genesispay.finance/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://genesispay.finance/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://genesispay.finance/mcp"
    }
  }
}
```

## Tools

- `genesispay_discover`: Searches GenesisPay sellers, shop products and the external x402 directory with filters.
- `genesispay_describe_service`: Reads the schema, constraints and examples for a listed service.
- `genesispay_quote`: Returns a read-only quote for a physical product to the saved shipping address.
- `genesispay_shipping_profile`: Reads or sets the saved shipping address.
- `genesispay_pay`: Pays an x402 resource or purchases a quoted product within spending limits.
- `passt_search`: Searches the catalog of UCP stores and their products.

## FAQ

### Can it make payments right now?

The docs say payments are paused and payment tools return 503 payments_disabled with nothing charged.

### Do I need an account for the catalog connector?

No. It is read-only and needs no account, login or key.

### What currency does it pay in?

USDC on Base; listings in other assets come back as not payable.

### How do web chats connect?

Add the hosted /mcp URL as a custom connector and sign in with OAuth.

### Can I get an account?

New accounts are closed; the docs point to an early-access request.

### How do I add GenesisPay to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://genesispay.finance/mcp

### What are the best alternatives to GenesisPay?

The closest alternatives to GenesisPay are ChatGPT for Amazon, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, O'So MCP Server for PrestaShop and Budget Tracker.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [ChatGPT for Amazon](https://ai-powered.com/mcp/chatgpt_for_amazon): ChatGPT for Amazon is a freemium MCP server for marketing.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/genesispay
