Trillboards DOOH Advertising
DOOH advertising via AI agents. 5,000+ screens with edge AI audience intelligence.
Ask AI about Trillboards DOOH Advertising
Powered by Claude Β· Grounded in docs
I know everything about Trillboards DOOH Advertising. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
DOOH Agent Example
Complete working examples of building a DOOH (Digital Out-of-Home) advertising agent using Trillboards APIs.
Install the MCP Server
The Trillboards DOOH MCP server is available through multiple registries:
| Registry | Link |
|---|---|
| Smithery | smithery.ai/servers/trillboards/dooh-advertising |
| MCP Registry | registry.modelcontextprotocol.io |
| Direct (Streamable HTTP) | https://api.trillboards.com/mcp |
Claude Desktop / Cursor / Windsurf
Add to your MCP config:
{
"mcpServers": {
"trillboards-dooh": {
"url": "https://api.trillboards.com/mcp"
}
}
}
Smithery CLI
npx @smithery/cli install trillboards/dooh-advertising
Quick Start
npm install
# Demo mode β no API key needed
node mcp-agent.js --demo
# Full flow with API key
export TRILLBOARDS_API_KEY=trb_partner_xxxxx
node mcp-agent.js
Two Integration Paths
MCP (Model Context Protocol) β Recommended for AI Agents
node mcp-agent.js
Connects to the Trillboards MCP server at https://api.trillboards.com/mcp/ and uses structured tool calling for pricing discovery, inventory browsing, audience analysis, and billing.
REST API β Direct HTTP
node rest-agent.js
Same flow using standard HTTPS requests. Useful as a fallback or for non-MCP environments.
Agent Lifecycle
βββββββββββββββββββ
β 1. Get Pricing β No auth needed
β get_pricing β β pricing, free tiers, billing URLs
ββββββββββ¬βββββββββ
β
ββββββββββΌβββββββββ
β 2. Register β No auth needed
β agent/register β β API key, sandbox screens
ββββββββββ¬βββββββββ
β
ββββββββββΌββββββββββββββ
β 3. Use Free Tier β API key auth
β discover_inventory β β screens, audience data
β get_live_audience β
β get_audience_forecastβ
ββββββββββ¬ββββββββββββββ
β Free tier exhausted β 402
ββββββββββΌβββββββββ
β 4. Set Up β API key auth
β Billing β setup_billing β active billing
β β purchase_credits β volume discounts
ββββββββββ¬βββββββββ
β
ββββββββββΌβββββββββ
β 5. Pay-Per-Use β Metered usage, monthly invoicing
β Full API Access β
βββββββββββββββββββ
Available MCP Tools
| Tool | Auth | Description |
|---|---|---|
get_pricing | No | Machine-readable pricing for all products |
discover_inventory | Yes | Find available ad slots and screens |
get_live_audience | Yes | Real-time audience data for a screen |
get_audience_forecast | Yes | Predict audience for a screen/time |
get_usage_summary | Yes | Current billing period usage |
get_billing_status | Yes | Billing setup status and credit balance |
setup_billing | Yes | Attach Stripe payment method |
purchase_credits | Yes | Buy credits at volume discounts |
Getting an API Key
Option A: Self-service registration (recommended for agents)
curl -X POST https://api.trillboards.com/v1/partner/agent/register \
-H "Content-Type: application/json" \
-d '{"agent_type":"developer","name":"My Agent","email":"you@example.com"}'
Option B: Via MCP β The agent can register itself using the register_partner tool.
Billing
Trillboards uses usage-based pricing with generous free tiers:
- Data API: 10,000 free calls/month
- Proof-of-Play: 50,000 free proofs/month
When free tier is exhausted, API returns 402 Payment Required with pricing details and billing setup URL.
Resources
- API Documentation
- MCP Server (Streamable HTTP)
- Smithery Listing
- MCP Registry
- Pricing
- NPM SDK
- Proof-of-Play Verifier
License
MIT
