Install one middleware. Monetize unused 402 responses with recommendations, discovery, and machine commerce analytics.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add x402-ads --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' --env X402_ADS_PUBLISHER_KEY='<X402_ADS_PUBLISHER_KEY>' -- npx -y @forgemeshlabs/x402-ads-mcp~/.codex/config.toml
[mcp_servers.x402-ads]
command = "npx"
args = ["-y", "@forgemeshlabs/x402-ads-mcp"]
env = { WALLET_PRIVATE_KEY = "<WALLET_PRIVATE_KEY>", X402_ADS_PUBLISHER_KEY = "<X402_ADS_PUBLISHER_KEY>" }
# codex mcp add x402-ads --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' --env X402_ADS_PUBLISHER_KEY='<X402_ADS_PUBLISHER_KEY>' -- npx -y @forgemeshlabs/x402-ads-mcp~/.cursor/mcp.json
{
"mcpServers": {
"x402-ads": {
"command": "npx",
"args": [
"-y",
"@forgemeshlabs/x402-ads-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"x402-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@forgemeshlabs/x402-ads-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"x402-ads": {
"command": "npx",
"args": [
"-y",
"@forgemeshlabs/x402-ads-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"x402-ads": {
"command": "npx",
"args": [
"-y",
"@forgemeshlabs/x402-ads-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"x402-ads": {
"command": "npx",
"args": [
"-y",
"@forgemeshlabs/x402-ads-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
}
}
}
}Environment variables
WALLET_PRIVATE_KEYX402_ADS_PUBLISHER_KEY
Replace the placeholders with your own credentials and keep them out of version control.