BillboardBug
Create GPS-anchored AR billboards and local deals that appear in the BillboardBug apps
- 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.mcpbAdd 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

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

MCP
MCP serverMCP server for planning, scheduling and measuring social and ad campaigns with approvals
- Remote
- Freemium
- Marketing and SEO
Later Stages
MCP serverCalifornia senior living and care provider records from state licensing and Medicare
- 6 tools
- Remote
- Free
- Health and science

Red Center Studio free tools
MCP serverFree website checks for AI readiness, DNS dependencies, domain health and Bubble errors
- 5 tools
- Remote
- Free
- Marketing and SEO

Virkly CVR
MCP serverCzech property marketplace for AI agents that draft sales and bids, with people deciding
- Remote
- Free
- Local services