# BillboardBug (mcpb · billboardbug.mcpb)

BillboardBug MCP: create and verify GPS-anchored AR billboards and deals for real businesses.

- Trust score: 52/100 (low)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- mcpb · `billboardbug.mcpb`: 52/100 (this document), [markdown](https://verifymcp.io/servers/bgaut007-billboardbug/billboardbug.md), [page](https://verifymcp.io/servers/bgaut007-billboardbug/billboardbug)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb`
- Version: `1.0.1`
- Transport: `stdio`
- SHA-256: `983959451d426c6ded8871d07951fe64057231ea974772360792ea8d051fa42a`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 23/100
  - No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.
  - Known CVEs were checked across the 92 of 92 dependencies we could resolve, so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - 30 of 92 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 19 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 58/100
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 1308 tokens (~118/item across 11 items; 11 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 63/100
  - Stability observed for 19 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 84/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 53% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 11 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 12 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the BillboardBug MCP server?

BillboardBug ships as an MCPB bundle, a single file you download and open in an MCP host that supports MCPB bundles, such as Claude Desktop. The host reads the launch command from the bundle's own manifest, so there is no command to copy. Before opening it, check the file's SHA-256 matches the one the MCP registry declares for it, 983959451d426c6ded8871d07951fe64057231ea974772360792ea8d051fa42a; the commands to do that are on this page. If it does not match, do not open it.

- Download bundle: `https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb`
- SHA-256: `983959451d426c6ded8871d07951fe64057231ea974772360792ea8d051fa42a`

### Verify on macOS / Linux

```bash
echo "983959451d426c6ded8871d07951fe64057231ea974772360792ea8d051fa42a  billboardbug.mcpb" | shasum -a 256 -c
```

### Verify on Windows (PowerShell)

```powershell
(Get-FileHash -Algorithm SHA256 .\billboardbug.mcpb).Hash -eq "983959451d426c6ded8871d07951fe64057231ea974772360792ea8d051fa42a"
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 52, +1)

No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 51, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-31 (score 50, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-29 (score 49, +6)

- [functional improvement] Stability: unverified → 0.40

### 2026-10-17 (score 43)

First indexed and scored.

## MCP tools (11)

### `create_deal` (~280 tokens)

Create billboard deal

Create a live billboard deal at a real location. Requires an uploaded image or video. Returns storefrontId and billboardId. Never sets featured (paid) placement.

Input parameters:

- `address` (string, required): Street address shown as locationDescription
- `altitudeMeters` (number)
- `businessName` (string, required): Exact business name (confirm with your human)
- `categoryId` (string): Storefront category UUID from list_categories; default ce8f8f8f-8f8f-8f8f-8f8f-8f8f8f8f8f8f (Miscellaneous)
- `description` (string, required): Use only claims, prices, and hours the business provided
- `hours` (required): "24/7" or per-day: {monday: "closed" | "24h" | {open:"09:00",close:"17:00"}, ...}
- `imageId` (string): Blob id from upload_media (category billboard-image). The live API requires imageId or videoId.
- `isEnabled` (boolean)
- `lat` (number, required): Latitude of the business
- `lng` (number, required): Longitude of the business
- `title` (string, required): Deal title, max 18 characters
- `videoId` (string): Blob id from upload_media (category billboard-video)

### `update_deal` (~290 tokens)

Update billboard deal

Replace an existing deal (same fields as create_deal). Use isEnabled:false to take a deal down when the promotion ends.

Input parameters:

- `address` (string, required): Street address shown as locationDescription
- `altitudeMeters` (number)
- `billboardId` (string, required)
- `businessName` (string, required): Exact business name (confirm with your human)
- `categoryId` (string): Storefront category UUID from list_categories; default ce8f8f8f-8f8f-8f8f-8f8f-8f8f8f8f8f8f (Miscellaneous)
- `description` (string, required): Use only claims, prices, and hours the business provided
- `hours` (required): "24/7" or per-day: {monday: "closed" | "24h" | {open:"09:00",close:"17:00"}, ...}
- `imageId` (string): Blob id from upload_media (category billboard-image). The live API requires imageId or videoId.
- `isEnabled` (boolean)
- `lat` (number, required): Latitude of the business
- `lng` (number, required): Longitude of the business
- `storefrontId` (string, required)
- `title` (string, required): Deal title, max 18 characters
- `videoId` (string): Blob id from upload_media (category billboard-video)

### `get_deal` (~47 tokens)

Get deal (read-back)

Read a deal back by storefrontId and billboardId to verify it is live. Works without an API key.

Input parameters:

- `billboardId` (string, required)
- `storefrontId` (string, required)

### `list_my_deals` (~34 tokens)

List my deals

List deals owned by the API key's account.

Input parameters:

- `limit` (integer)
- `offset` (integer)

### `list_categories` (~57 tokens)

List storefront categories

List storefront categories for categoryId (about 7,000). Pass nameContains to filter. Requires an API key. Default used by create_deal is Miscellaneous.

Input parameters:

- `max` (integer)
- `nameContains` (string)

### `search_deals` (~47 tokens)

Search deals

Search BillboardBug deals by text (min 3 characters). Requires an API key.

Input parameters:

- `limit` (integer)
- `offset` (integer)
- `search` (string, required)

### `upload_media` (~111 tokens)

Upload image or video

Upload a local image/video file (or base64 data) to BillboardBug. Use billboard-image/billboard-video for deals, post-image/post-video for chirps. Returns the blob id.

Input parameters:

- `base64Data` (string): Base64 or data: URI content (alternative to filePath)
- `category` (string, required)
- `fileName` (string): File name to use with base64Data, e.g. billboard.jpg
- `filePath` (string): Absolute path to a local file

### `generate_image` (~91 tokens)

Generate AI image

Generate billboard artwork from a prompt (recommended 640x373). Returns base64 data URIs you can pass to upload_media. Prefer realistic photos.

Input parameters:

- `aiProvider` (integer): Provider type from GET /global-config/all: 5 = Grok (default, recommended), 1 = OpenAI
- `height` (integer)
- `prompt` (string, required)
- `width` (integer)

### `create_chirp` (~108 tokens)

Create chirp

Post a chirp (social post) on BillboardBug, e.g. announcing a new billboard. Returns the chirp id.

Input parameters:

- `imageId` (string): Blob id from upload_media (post-image)
- `isActive` (boolean)
- `isMature` (boolean)
- `parentPostId` (string): Set to comment on an existing chirp
- `text` (string)
- `videoId` (string): Blob id from upload_media (post-video)

### `update_chirp` (~97 tokens)

Update chirp

Edit an existing chirp you own.

Input parameters:

- `id` (string, required)
- `imageId` (string): Blob id from upload_media (post-image)
- `isActive` (boolean)
- `isMature` (boolean)
- `parentPostId` (string): Set to comment on an existing chirp
- `text` (string)
- `videoId` (string): Blob id from upload_media (post-video)

### `get_chirp` (~28 tokens)

Get chirp (read-back)

Read a chirp back by id to verify it posted.

Input parameters:

- `id` (string, required)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/bgaut007-billboardbug/billboardbug#diagnostics

## Score history

- 2026-11-05: 52
- 2026-11-04: 51
- 2026-11-03: 51
- 2026-11-02: 50
- 2026-11-01: 50
- 2026-10-31: 50
- 2026-10-30: 49
- 2026-10-29: 49
- 2026-10-28: 43
- 2026-10-27: 43
- 2026-10-26: 43
- 2026-10-25: 43
- 2026-10-24: 43
- 2026-10-23: 43
- 2026-10-22: 43
- 2026-10-21: 43
- 2026-10-20: 43
- 2026-10-19: 43
- 2026-10-18: 43
- 2026-10-17: 43

## Common questions

### What is the BillboardBug MCP server?

BillboardBug is an MCP server listed in the public MCP registry as io.github.bgaut007/billboardbug. BillboardBug MCP: create and verify GPS-anchored AR billboards and deals for real businesses. This page covers its MCPB bundle (https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpb).

### Is the BillboardBug MCP server safe to use?

BillboardBug scores 52 out of 100 on VerifyMCP. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the BillboardBug MCP server expose?

BillboardBug exposes 11 tools: create_deal, update_deal, get_deal, list_my_deals, list_categories, and 6 more. Their descriptions and schemas cost roughly 1,190 tokens of context every time the server is loaded.

### What licence is the BillboardBug MCP server under?

BillboardBug declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the BillboardBug MCP server?

VerifyMCP ran 15 checks on BillboardBug, covering Known CVEs, Install scripts, Dependency health, Source repository and 11 more. One item could not be completed, a gap on our side rather than a finding about BillboardBug: Malware scan. Endpoint Security and Transport & Reachability do not apply to an MCPB bundle, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Repository: https://github.com/bgaut007/billboardbug-mcp
- Website: https://billboardbug.com/
- Changelog RSS feed: https://verifymcp.io/servers/bgaut007-billboardbug/billboardbug.xml
- Changelog JSON feed: https://verifymcp.io/servers/bgaut007-billboardbug/billboardbug/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/bgaut007-billboardbug/billboardbug.json
- HTML version of this page: https://verifymcp.io/servers/bgaut007-billboardbug/billboardbug
