Skip to content
MCP server

BillboardBug

Create GPS-anchored AR billboards and local deals that appear in the BillboardBug apps

Runs locallyStatus and history
Pricing
Paid
Platforms
API, iOS, Android
Runs
Locally
Version
1.0.1
Listing updated
2 days ago

About BillboardBug

BillboardBug is a paid MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • BILLBOARDBUG_API_KEYAPI key from https://app.billboardbug.com (Settings > API Keys)Required

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Paid

Day Pass or monthly plan with 120 credits; prices not published

Prices change. Check billboardbug.com before you buy.

BillboardBug 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 to BillboardBug

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  5. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  6. Virkly CVR

    MCP server

    Czech property marketplace for AI agents that draft sales and bids, with people deciding

    • Remote
    • Free
    • Local services