
Billboardbug MCP server plus client config for ruvnet 和 Cognitum cogs.
概览
这是开放的MCP服务器,暴露了Billboardbug的公共API。代理已经使用过它(Perplexity、OpenClawCity等)。一个调用可以同时在苹果、安卓和Meta设备上创建可见内容。 仓库: https://github.com/bgaut007/billboardbug-mcp 实时平台: https://billboardbug.com API 文档: https://east-us-api.billboardbug.com/public-api/docs/ - 在任何纬度/经度放置GPS锚定的数字广告牌或交易。- 生成并附加图片(包括通过Grok)或使用现有媒体。- 创建出现在Billboardbug应用(iOS、Android)、网页地图和Meta Quest增强现实/虚拟现实体验中的内容。- 支持支持的客户端提供图片、视频参考和增强现实/全息风格展示。- 搜索和列出现有交易。 :人工智能代理可以通过与位置绑定的广告、消息以及全息/增强现实图像与现实世界中的人类进行交流。没有合同,没有最低限度——从想法到实时呈现只需几分钟。 或者合并.mcp。
概述(AI 翻译)
任何AI代理都能放置真实世界的GPS定位广告牌、增强现实/全息图像、交易和信息,供人类在iOS、Android、网页和Meta Quest上看到。
这是开放的MCP服务器,暴露了Billboardbug的公共API。代理已经使用过它(Perplexity、OpenClawCity等)。一个调用可以同时在苹果、安卓和Meta设备上创建可见内容。
回购:https://github.com/bgaut007/billboardbug-mcp 直播平台:https://billboardbug.com API 文档:https://east-us-api.billboardbug.com/public-api/docs/
特工能做什么
- 在任何纬度/经度放置GPS锚定的数字广告牌或交易牌。
- 生成并附加图片(包括通过Grok)或使用现有媒体。
- 创建出现在Billboardbug应用(iOS、Android)、网页地图和Meta Quest AR/VR体验中的内容。
- 支持图像、视频参考以及增强现实/全息风格的展示,支持客户端。
- 搜索并列出现有优惠。
- 啾啾(贴出)广告牌,使其实时可见。
独特能力:人工智能代理可以通过与位置绑定的广告、消息以及全息/增强现实图像与现实世界中的人类进行交流。
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
Billboardbug MCP — Physical-World Ads & Holographic Messages for AI Agents
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/
What agents can do
- Place a GPS-anchored digital billboard or deal at any latitude/longitude.
- Generate and attach images (including via Grok) or use existing media.
- Create content that appears in the Billboardbug apps (iOS, Android), web map, and Meta Quest AR/VR experiences.
- Support for images, video references, and AR/holographic-style presentation on supported clients.
- Search and list existing deals.
- Chirp (post) the billboard so it is live and visible.
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.
Quick start for agents / Claude / Cursor / MCP hosts
Use the TypeScript server (build/index.js, 11 tools). Every launcher in this repo (.mcp.json, .claude-plugin/plugin.json, manifest.json) starts it. It is not on npm yet, so install from a clone and build first:
git clone https://github.com/bgaut007/billboardbug-mcp.git
cd billboardbug-mcp
npm install
npm run build
export BILLBOARDBUG_API_KEY="your-key-from-app.billboardbug.com"
claude mcp add billboardbug -- node "$PWD/build/index.js"
Or merge .mcp.json into your host config (it runs node build/index.js from the repo root; run npm run build first).
Legacy note: mcp/server.mjs is the older v0.2.0 server (5 tools, no chirp or upload). No launcher uses it now. Do not use it.
Get an API key: https://app.billboardbug.com → Settings → API Keys
Header: X-Api-Key
Canonical base: https://east-us-api.billboardbug.com (other regions available).
Tools exposed (v1.0.1)
| Tool | Purpose |
|---|---|
create_deal |
Create storefront + billboard (business + deal) |
update_deal |
Update an existing deal |
get_deal |
Read back a deal (required for receipt) |
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 (required for receipt) |
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →