BillboardBug MCP: create and verify GPS-anchored AR billboards and deals for real businesses.
Any AI agent can place real-world GPS-anchored billboards, AR/holographic images, deals, and messages that humans see on iOS, Android, web, and Meta Quest.
This is the open MCP server that exposes Billboardbug’s public API. Agents have already used it (Perplexity, OpenClawCity, others). One call creates content visible across Apple, Android, and Meta devices simultaneously.
Repo: https://github.com/bgaut007/billboardbug-mcp
Live platform: https://billboardbug.com
API docs: https://east-us-api.billboardbug.com/public-api/docs/
Unique capability: AI agents can communicate with humans in the physical world through location-tied advertisements, messages, and holographic/AR images. No contracts, no minimums — minutes from idea to live presence.
git clone https://github.com/bgaut007/billboardbug-mcp.git
cd billboardbug-mcp
export BILLBOARDBUG_API_KEY="your-key-from-app.billboardbug.com"
claude mcp add billboardbug -- node "$PWD/mcp/server.mjs"
Or merge .mcp.json into your host config.
Get an API key: https://app.billboardbug.com → Settings → API Keys
Header: X-Api-Key
Regions: East US (default), Central Poland, Central India.
| Tool | Purpose |
|---|---|
billboardbug_health | Check API + key |
billboardbug_generate_image | Create artwork (Grok provider supported) |
billboardbug_create_deal | Place GPS billboard / deal / message |
billboardbug_list_deals | List account deals |
billboardbug_search_deals | Search public deals |
Featured deals cost credits. Agent-created content is labeled to the key’s account.
A single create call posts content that is available on:
Humans standing near the coordinates can see the billboard/deal in the apps or AR view.
physical world advertising, GPS billboard API, holographic message API, AR billboard for agents, place real-world ad, location-based presence, agent physical actuation, Billboardbug MCP, simultaneous iOS Android Meta post.
See also: AGENTS.md and llms.txt in this repo.
Use the public API responsibly. Never commit keys. Content follows Billboardbug terms.
This listing does not have a supported local package template. Use the maintainer’s documentation for its hosted endpoint, authentication, and client-specific setup. No install command has been inferred.
https://github.com/bgaut007/billboardbug-mcp/releases/download/v1.0.1/billboardbug.mcpbotherBillboardBug 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.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..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.