# BillboardBug

> BillboardBug is a paid MCP server for marketing and seo. Create GPS-anchored AR billboards and local deals that appear in the BillboardBug apps. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, iOS, Android, Web
- **Website:** https://billboardbug.com
- **Repository:** https://github.com/bgaut007/billboardbug-mcp
- **MCP Registry name:** io.github.bgaut007/billboardbug
- **Categories:** marketing and SEO, local services
- **Listing updated:** 2026-11-15

## About

A deal here is not live until it has been published as a chirp. The README is firm about this: after creating a deal an agent must call create_chirp and then read it back with get_chirp, quoting the chirp ID as a receipt. Without that step the billboard exists but nobody sees it.

An agent supplies a latitude and longitude, a business and offer, and media, either uploaded or generated (Grok is supported). The content then shows to people near those coordinates in the iOS and Android apps, on a web map and in Meta Quest AR and VR views. Eleven tools cover creating and updating deals, listing your own and searching public ones, browsing storefront categories, and managing chirps. Featured deals cost credits, and agent-created content is attributed to the API key's account.

The TypeScript server is not on npm yet. You clone the repo, build it, set BILLBOARDBUG_API_KEY from the BillboardBug app settings and register it with your client; a packaged mcpb bundle is also listed. On the consumer side, BillboardBug sells a Day Pass (one billboard for 24 hours) and a monthly plan with 120 billboard credits, each credit running one billboard for 24 hours.

## Features

- **Deal and storefront creation:** Create a business storefront with a billboard offer at any coordinates.
- **Chirp publishing:** Publish a chirp to make a deal live, then read it back as a receipt.
- **Media upload and generation:** Upload images or video, or generate artwork with Grok.
- **Deal search:** Search public deals and list the deals on your key's account.
- **Multi-platform reach:** Content appears on iOS, Android, web map and Meta Quest.
- **Credit-based featuring:** Featured deals cost credits.

## Good for

- Let an agent publish a limited-time offer for a local shop at its location
- Post a geo-tied message people see when they are near a place
- Generate artwork for a promotion and attach it to a billboard
- Search nearby public deals through an assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add billboardbug --env BILLBOARDBUG_API_KEY='<BILLBOARDBUG_API_KEY>' -- npx -y https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "billboardbug": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb"
      ],
      "env": {
        "BILLBOARDBUG_API_KEY": "<BILLBOARDBUG_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "billboardbug": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb"
      ],
      "env": {
        "BILLBOARDBUG_API_KEY": "<BILLBOARDBUG_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "billboardbug": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb"
      ],
      "env": {
        "BILLBOARDBUG_API_KEY": "<BILLBOARDBUG_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "billboardbug": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb"
      ],
      "env": {
        "BILLBOARDBUG_API_KEY": "<BILLBOARDBUG_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "billboardbug": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb"
      ],
      "env": {
        "BILLBOARDBUG_API_KEY": "<BILLBOARDBUG_API_KEY>"
      }
    }
  }
}
```

## Tools

- `create_deal`: Create storefront and billboard (business and deal)
- `update_deal`: Update an existing deal
- `get_deal`: Read back a deal
- `list_my_deals`: List deals on the key's account
- `list_categories`: List storefront categories
- `search_deals`: Search public deals
- `upload_media`: Upload image or video
- `generate_image`: Generate artwork (Grok supported)
- `create_chirp`: Publish the chirp that makes the deal live
- `update_chirp`: Update a chirp
- `get_chirp`: Read back a chirp

## FAQ

### How do I get an API key?

Create one in the BillboardBug app under Settings, then API Keys; it is sent in the X-Api-Key header.

### Why is my deal not visible?

A deal is only live after its chirp is published with create_chirp.

### Is it on npm?

No. The README says it must be cloned and built, though an mcpb bundle is also listed.

### Which devices show the content?

iOS, Android, the web map and Meta Quest.

### What do the plans look like?

A Day Pass runs one billboard for 24 hours; the monthly plan includes 120 credits. Prices are not published.

### Is BillboardBug free?

No. BillboardBug is a paid product.

### How do I add BillboardBug to Claude Code?

Run this command in your terminal: claude mcp add billboardbug --env BILLBOARDBUG_API_KEY='<BILLBOARDBUG_API_KEY>' -- npx -y https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb

### What are the best alternatives to BillboardBug?

The closest alternatives to BillboardBug are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Later Stages and Red Center Studio free tools.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [Virkly CVR](https://ai-powered.com/mcp/virkly-cvr): Virkly CVR is a free MCP server for local services.
- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/billboardbug
