Quickstart
You need Node.js 20+ and a wallet to receive payments.
-
Get free credentials
Sign in at dashboard.request.network with your wallet and set up a receiving route: the network, wallet and token you want to be paid in.
On the route, open Manage → Client IDs → Generate. Copy the Client ID and the route’s Route ID:
0xYourWallet@eip155:1#ABCD1234:0xTokenAddress -
Add the server to your assistant
Add to
~/.cursor/mcp.json(or.cursor/mcp.jsonin a project):{"mcpServers": {"req-invoice": {"command": "npx","args": ["-y", "github:becomingmountains/req-invoice-mcp"],"env": {"REQUEST_CLIENT_ID": "your-client-id","REQUEST_DESTINATION_ID": "0xYourWallet@eip155:1#ABCD1234:0xTokenAddress","REQUEST_PAYEE": "0xYourWallet"}}}}Add to
.vscode/mcp.json:{"servers": {"req-invoice": {"type": "stdio","command": "npx","args": ["-y", "github:becomingmountains/req-invoice-mcp"],"env": {"REQUEST_CLIENT_ID": "your-client-id","REQUEST_DESTINATION_ID": "0xYourWallet@eip155:1#ABCD1234:0xTokenAddress","REQUEST_PAYEE": "0xYourWallet"}}}}Any MCP client that runs stdio servers works. Use the command
npx -y github:becomingmountains/req-invoice-mcpand set the environment variables from Configuration. -
Send your first link
Restart your assistant and ask:
Create a payment link for 25 USDC.
You’ll get back a
pay.request.networklink and an invoice ID. Later, ask “has it been paid?”