The Button Wall

Rent a clickable button on a million-pixel wall: find free space, get a quote, create a checkout.

OtherTypeScriptv0.1.1

buttonwall-mcp

MCP server for The Button Wall: a 1000×1000 px wall where every rented area is a real, clickable button.

Lets an AI assistant check how full the wall is, quote a button, find free space and create a Stripe checkout link. The agent never pays: the buyer opens the link and pays on Stripe, and every button is reviewed by a person before it goes live (full refund if rejected).

Tools

ToolWhat it does
get_wall_status% claimed, live buttons, pricing and rules
quote_spotPrice for a size and plan, and whether a position is free
find_free_spotsFree positions for a size, nearest to a point first
create_checkout_linkStripe checkout link for a new button (human pays)

Install

Claude Desktop / Claude Code / Cursor (mcpServers config):

{
  "mcpServers": {
    "buttonwall": { "command": "npx", "args": ["-y", "buttonwall-mcp"] }
  }
}

Claude Code: claude mcp add buttonwall -- npx -y buttonwall-mcp

Pricing

€0.10 per pixel per 30 days (10×10 px = €10). 6 months −10%, 12 months −20%. Prepaid, never auto-renews.

Example prompts

  • "How full is The Button Wall right now?"
  • "Find me a free 120×40 spot near the centre and tell me what 6 months costs."
  • "Put a button for my SaaS on The Button Wall: text 'Try Acme free', link https://acme.dev, brand colour #ff5a1f."

Limits

Checkout links are rate-limited to 10 per 10 minutes per IP. The server uses the same public, read-only endpoints as thebuttonwall.com.

License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y buttonwall-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-leovenom-buttonwall": {
      "command": "npx",
      "args": [
        "-y",
        "buttonwall-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

buttonwall-mcpnpm

Compatible MCP Clients

The Button Wall works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More