HPP x402 MCP Bridge

by hpp-io

283 downloads

Not rated

GitHub Website

Finance

About

Gasless x402 payments for MCP agents on HPP — discover and pay for services per call, within a spend cap.

Details

Author: hpp-io
Downloads: 283
Categories: Finance

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 HPP x402 MCP Bridge

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": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

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": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

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": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

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": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

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": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

From the repository

The README includes setup instructions such as "command": "npx", "args": ["-y", "@hpp-io/x402-mcp-bridge"].

`wallet_address`

Return this agent's own wallet address (to receive/fund USDC.e) and its network. Use when the user asks 'what's my address' or where to send funds.

`wallet_balance`

Show the wallet's current USDC.e balance — what it can spend right now. In Safe mode this is the delegate's immediately-spendable balance (the Safe tops up more on demand).

`wallet_get_limits`

Show the wallet's spend limits (per-call + per-day in atomic USDC.e units) and how much has been spent today. Empty limits = uncapped.

`wallet_set_limit`

Set the wallet's spend guard: a per-call cap and/or a per-day cap in atomic USDC.e units (e.g. '10000' = 0.01 USDC.e). These bind across ALL payment tools and are enforced locally before signing (complements the Safe's on-chain cap). Omit a field to leave it unchanged.

`pay_a2a_agent`

Pay an external Agent2Agent (A2A) agent for one of its skills using x402 (exact scheme, USDC.e) and return the result. The operator supplies the agent's A2A endpoint URL (e.g. http://host:4021/a2a) and the skill id directly — this MVP does not yet fetch the AgentCard. The bridge gates (unpaid message/send), signs the x402 payment with its delegate wallet (subject to the daily spend cap), and re-sends with the payment in A2A metadata, returning the agent's output on success.

`x402_http_call`

Call an x402-protected HTTP endpoint and return its response. Payment (USDC.e) is handled automatically with your wallet, subject to the daily spend cap; per-host auth headers come from local policy (you do NOT pass keys). Only allow-listed hosts can be called. Use for paid HTTP APIs and account actions such as Hub credit top-up (POST <hub>/api/web3/credit/topup {amount}) and usage checks (GET <hub>/api/web3/credit/usage).

`hpp_discover`

Discover paid x402 services on the HPP chain from the curated discovery directory. Returns services with their resourceId, name, description, price (USDC.e atomic units), network, type and trust signals (how many times the service has actually been paid). Pass `query` for a semantic search (e.g. 'image generation'), or omit it to browse. Results are limited to the network this wallet can pay on unless you pass `network` explicitly (use "all" to see every network). Then call hpp_describe({ resourceId }) to learn the input arguments, and hpp_call({ resourceId, body }) to run it.

`hpp_describe`

Describe one service found via hpp_discover: its input arguments (JSON Schema plus a concrete example body), output example, price, network and endpoint. Read-only — no payment. Call this before hpp_call when you are not certain what the service expects: hpp_call pays first and the seller validates after, so a wrong body costs a real payment.

`hpp_call`

Call a service found via hpp_discover. Pass its `resourceId` and a `body` (the service's input args — check hpp_describe first if unsure). Payment (USDC.e) is handled automatically with your wallet, subject to the daily spend cap — you do not sign anything. HTTP, MCP and A2A typed services are all invoked directly; the price advertised by discovery is enforced as a ceiling.

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "hpp x402 mcp bridge": {
            "hpp-x402": {
                "command": "npx",
                "args": [
                    "-y",
                    "@hpp-io/x402-mcp-bridge"
                ]
            }
        }
    }
}

McpServers

{
    "hpp-x402": {
        "command": "npx",
        "args": [
            "-y",
            "@hpp-io/x402-mcp-bridge"
        ]
    }
}

@hpp-io/x402-mcp-bridge

> The agent payment rail for HPP. A stdio MCP bridge + the hpp-x402 CLI that let
> Claude Desktop / Claude Code / Cursor / Windsurf / OpenClaw make autonomous
> HPP USDC.e payments over x402 — discover paid services,
> pay per call, within a spend cap. No API keys, no manual signing.

📖 Full documentation

hpp-io/x402-tools — the complete manual:
how it works, every command, buyer and seller flows, payment schemes
(exact / upto), wallet modes, and troubleshooting. This README is a quick reference.

Install

```bash

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

wallet_address

wallet_balance

wallet_get_limits

wallet_set_limit

pay_a2a_agent

x402_http_call

hpp_discover

hpp_describe

hpp_call

Claude Desktop / Cursor

McpServers

@hpp-io/x402-mcp-bridge

📖 Full documentation

Install

Install

More like this

Stripe

Defeatbeta Api

MetaTrader MCP Server

EVM MCP Server

Polygon.io MCP Server

AI看线 - A股技术分析与AI预测工具

`wallet_address`

`wallet_balance`

`wallet_get_limits`

`wallet_set_limit`

`pay_a2a_agent`

`x402_http_call`

`hpp_discover`

`hpp_describe`

`hpp_call`