Skip to content
MCP server

GenesisPay

Let an agent find x402 services and shop catalogues and pay in USDC within set limits

Install
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
1.10.0
Listing updated
today

Similar MCP servers

About GenesisPay

GenesisPay is an MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://genesispay.finance/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://genesispay.finance/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GENESISPAY_AGENT_KEYAgent API key (gp_ag_...), created on the GenesisPay dashboard under the agent account's Keys tab.Required
  • GENESISPAY_BASE_URLBase URL of the GenesisPay deployment the agent key belongs to.Required

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Pricing unknown

Payments paused; catalog connector free to read

Prices change. Check genesispay.finance before you buy.

GenesisPay 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.

How AIPoweredBot checks servers