PincerPay

by ds1

1 stars

272 downloads

Not rated

GitHub Website

Developer Tools

About

On-chain USDC payment gateway for AI agents. x402 protocol.

Details

Author: ds1
GitHub stars: 1
Downloads: 272
Categories: Developer Tools

- Non-custodial: private keys never leave the user’s machine
- x402 facilitator: automated HTTP 402 payment challenge handling
- Multi-chain support: Solana, Base, and Polygon
- Instant settlement in USDC
- Terminal-only merchant onboarding (no browser required)
- Merchant SDK with Express and Hono middleware
- Agent SDK with automatic 402 payment handling
- MCP server with 26 tools for AI assistant integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name PincerPay

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

From the repository

Install the MCP server package (@pincerpay/mcp) and use it with an AI assistant. Onboarding is done entirely via the terminal using npx @pincerpay/cli signup and npx @pincerpay/cli bootstrap-merchant. The same flows are available as MCP tools (bootstrap-wallets, bootstrap-merchant, create-api-key, list-merchants).

`list-supported-chains`

Returns supported blockchain networks and their USDC configurations. Includes Solana (primary), Base, and Polygon with mainnet/testnet variants. Shows chain shorthand, CAIP-2 ID, USDC contract address, and block time.

`estimate-gas-cost`

Estimate the gas/transaction fee for a USDC payment on a given chain. Returns the native gas token, estimated USD cost, and notes about Kora gasless transactions (Solana) or L2 gas optimization.

`check-facilitator-health`

Check whether the PincerPay facilitator is reachable and healthy. Returns database status, worker health, uptime, and Kora (gasless) status. No API key required. Use this as the first troubleshooting step.

`get-settlement-metrics`

Fetch performance metrics from the PincerPay facilitator. Returns settlement counters, latency percentiles (p50/p95/p99), verification stats, and error rates. No API key required.

`check-transaction-status`

Query the PincerPay facilitator for the status of a payment transaction. Returns chain, amount, addresses, status (pending/mempool/optimistic/confirmed/failed), and timestamps. Requires a PincerPay API key.

`verify-payment`

Dry-run payment validation against the PincerPay facilitator without broadcasting. Checks signature validity, balance, and payment requirements. Requires a PincerPay API key. Useful for debugging payment failures.

`list-paywalls`

List paywalled endpoints configured for your merchant account. Returns endpoint patterns, USDC amounts, chain overrides, and active status. Requires a PincerPay API key.

`create-paywall`

Create a new paywalled endpoint. Sets the USDC price and optional chain restrictions. The endpoint pattern must be unique per merchant. Requires a PincerPay API key.

`update-paywall`

Update an existing paywall's price, description, chains, or active status. Only provided fields are changed. Requires a PincerPay API key.

`delete-paywall`

Permanently delete a paywalled endpoint. This cannot be undone. Use update-paywall with isActive=false to disable without deleting. Requires a PincerPay API key. Pass confirm=true to proceed.

`list-transactions`

List payment transactions for your merchant account with filtering and pagination. Returns chain, amount, status, gas costs, and timestamps. Requires a PincerPay API key.

`list-agents`

List AI agents that have interacted with your merchant account. Shows Solana address, spending limits, Squads PDA, and status. Agents are auto-registered on first payment. Requires a PincerPay API key.

`update-agent`

Update an agent's name, status, or spending limits. Set status to 'paused' or 'revoked' to block further payments. Spending limits are in USDC base units (6 decimals). Requires a PincerPay API key.

`list-webhooks`

List webhook delivery attempts for your merchant account. Shows event type, HTTP status code, retry count, and delivery status. Useful for diagnosing missed webhook notifications. Requires a PincerPay API key.

`retry-webhook`

Manually retry a failed or pending webhook delivery. Resets the delivery status and queues it for immediate retry. Cannot retry already-delivered webhooks. Requires a PincerPay API key.

`get-merchant-profile`

Fetch your merchant profile including wallet address, supported chains, webhook URL, and on-chain registration status. Requires a PincerPay API key.

`validate-payment-config`

Validate a PincerPay merchant configuration object. Checks API key format, merchant address, route patterns, chain names, and USDC amounts. Returns validation results with specific error messages for each issue found.

`scaffold-x402-middleware`

Generate Next.js middleware code that adds x402 USDC payment walls to API routes. Produces a complete, copy-paste-ready code snippet with PincerPay SDK setup, route configuration, and environment variable usage. Uses a Hono adapter in a catch-all App Router route. Supports Solana (primary), Base, and Polygon chains. Pass `merchantAddresses` for multi-chain merchants, `merchantAddress` for single-chain.

`scaffold-agent-client`

Generate agent-side code that automatically handles x402 USDC payments. Produces a PincerPayAgent setup with wallet configuration and spending policies. The agent's fetch() is a drop-in replacement for standard fetch that handles 402 challenges automatically.

`generate-ucp-manifest`

Generate a /.well-known/ucp JSON manifest for agent-readable commerce discovery. UCP (Universal Commerce Protocol) lets AI agents discover your API's payment requirements, supported chains, and endpoint pricing. Place the output at /.well-known/ucp on your domain.

`bootstrap-wallets`

Generates a non-custodial merchant wallet set: one BIP-39 mnemonic plus Solana + EVM addresses derived from it. Phantom and MetaMask compatible (Solana m/44'/501'/0'/0', EVM m/44'/60'/0'/0/0). Pure client-side crypto — PincerPay never sees the keys. Use this before bootstrap-merchant to provision wallets, or independently to generate any new keypair set.

`bootstrap-merchant`

End-to-end merchant onboarding: generates non-custodial wallets, creates a merchant record, and mints an API key in one call. Returns mnemonic + addresses + raw API key. Auth modes: (1) admin if DATABASE_URL is set on the MCP server, (2) public if ~/.pincerpay/credentials.json exists (run `npx @pincerpay/cli login` first). PincerPay never persists the mnemonic or private keys; the caller must display them once and discard.

`create-api-key`

Mints a new pp_live_* API key for the current merchant. The raw key is returned ONCE. Auth modes: (1) admin if DATABASE_URL is set, requires --merchant; (2) public if ~/.pincerpay/credentials.json exists, mints for the logged-in user's merchant.

`list-merchants`

Admin mode (DATABASE_URL): lists all merchants in the database. Public mode (CLI credentials): returns only the caller's own merchant.

`whoami`

Returns information about the currently authenticated user — auth mode (admin vs public), auth user id, session info, and current merchant. Useful diagnostic before mutating tools.

`login-instructions`

Returns instructions for authenticating the MCP server. Call this when an onboarding tool returns an auth error to guide the user through the right flow.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "pincerpay": {
            "pincerpay": {
                "command": "npx",
                "args": [
                    "-y",
                    "@pincerpay/mcp"
                ],
                "env": {
                    "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
                    "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "pincerpay": {
        "command": "npx",
        "args": [
            "-y",
            "@pincerpay/mcp"
        ],
        "env": {
            "PINCERPAY_FACILITATOR_URL": "https://facilitator.pincerpay.com",
            "PINCERPAY_API_KEY": "<YOUR_API_KEY>"
        }
    }
}

PincerPay

The payment gateway for the agentic economy. Accept payments from AI agents. Add a few lines of code. Settle instantly in USDC.

For merchants: sign up in 2 minutes, no browser

```bash
npx @pincerpay/cli signup

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

list-supported-chains

estimate-gas-cost

check-facilitator-health

get-settlement-metrics

check-transaction-status

verify-payment

list-paywalls

create-paywall

update-paywall

delete-paywall

list-transactions

list-agents

update-agent

list-webhooks

retry-webhook

get-merchant-profile

validate-payment-config

scaffold-x402-middleware

scaffold-agent-client

generate-ucp-manifest

bootstrap-wallets

bootstrap-merchant

create-api-key

list-merchants

whoami

login-instructions

Claude Desktop / Cursor

McpServers

PincerPay

For merchants: sign up in 2 minutes, no browser

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`list-supported-chains`

`estimate-gas-cost`

`check-facilitator-health`

`get-settlement-metrics`

`check-transaction-status`

`verify-payment`

`list-paywalls`

`create-paywall`

`update-paywall`

`delete-paywall`

`list-transactions`

`list-agents`

`update-agent`

`list-webhooks`

`retry-webhook`

`get-merchant-profile`

`validate-payment-config`

`scaffold-x402-middleware`

`scaffold-agent-client`

`generate-ucp-manifest`

`bootstrap-wallets`

`bootstrap-merchant`

`create-api-key`

`list-merchants`

`whoami`

`login-instructions`