MCP server
X402 Ads MCP
x402 ad recommendations, intent analytics, and machine-commerce demand reports.
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.2.7
- Listing updated
- 4 days ago
About X402 Ads MCP
X402 Ads MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add x402-ads-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' --env X402_ADS_PUBLISHER_KEY='<X402_ADS_PUBLISHER_KEY>' -- npx -y @forgemeshlabs/x402-ads-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"x402-ads-mcp": {
"command": "npx",
"args": [
"-y",
"@forgemeshlabs/x402-ads-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"x402-ads-mcp": {
"command": "npx",
"args": [
"-y",
"@forgemeshlabs/x402-ads-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"x402-ads-mcp": {
"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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"x402-ads-mcp": {
"command": "npx",
"args": [
"-y",
"@forgemeshlabs/x402-ads-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"x402-ads-mcp": {
"command": "npx",
"args": [
"-y",
"@forgemeshlabs/x402-ads-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"X402_ADS_PUBLISHER_KEY": "<X402_ADS_PUBLISHER_KEY>"
}
}
}
}Configuration
WALLET_PRIVATE_KEYOptional dedicated low-balance Base wallet private key for settling paid x402 analytics calls. Without it, paid tools return the x402 payment challenge instead of settling.X402_ADS_PUBLISHER_KEYOptional publisher key from ads.forgemesh.io. Makes get_intent_report free for your registered services.
Pricing
Open source
X402 Ads MCP FAQ
Is X402 Ads MCP free?
Yes. X402 Ads MCP is open source, so you can use and self-host it for free.
How do I add X402 Ads MCP to Claude Code?
Run this command in your terminal: claude mcp add x402-ads-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' --env X402_ADS_PUBLISHER_KEY='<X402_ADS_PUBLISHER_KEY>' -- npx -y @forgemeshlabs/x402-ads-mcp