# Trillboards DOOH Advertising [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/trillboards/dooh-agent-example  
**GitHub Stars:** 1  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/trillboards-dooh-advertising

## Description
DOOH advertising via AI agents. 5,000+ screens with real-time audience signals.

## Tools
Capabilities this server exposes over MCP:

- **get_pricing** — Machine-readable pricing for all products
- **discover_inventory** — Find available ad slots and screens
- **get_live_audience** — Real-time audience data for a screen
- **get_audience_forecast** — Predict audience for a screen/time
- **get_usage_summary** — Current billing period usage
- **get_billing_status** — Billing setup status and credit balance
- **setup_billing** — Attach Stripe payment method
- **purchase_credits** — Buy credits at volume discounts

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "trillboards-dooh-advertising": {
    "command": "npx",
    "args": ["-y","@smithery/cli"]
  }
}
```

## Documentation & README

# 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](https://smithery.ai/servers/trillboards/dooh-advertising) |
| **MCP Registry** | [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io) |
| **Direct (Streamable HTTP)** | `https://api.trillboards.com/mcp` |

### Claude Desktop / Cursor / Windsurf

Add to your MCP config:

```json
{
  "mcpServers": {
    "trillboards-dooh": {
      "url": "https://api.trillboards.com/mcp"
    }
  }
}
```

### Smithery CLI

```bash
npx @smithery/cli install trillboards/dooh-advertising
```

## Quick Start

```bash
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

```bash
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

```bash
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 |

[Full tool list →](https://api.trillboards.com/mcp/)

## Getting an API Key

**Option A: Self-service registration (recommended for agents)**

```bash
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](https://api.trillboards.com/docs/partner)
- [MCP Server (Streamable HTTP)](https://api.trillboards.com/mcp/)
- [Smithery Listing](https://smithery.ai/servers/trillboards/dooh-advertising)
- [MCP Registry](https://registry.modelcontextprotocol.io)
- [Pricing](https://api.trillboards.com/v1/partner/pricing)
- [NPM SDK](https://www.npmjs.com/package/@trillboards/ads-sdk)
- [Proof-of-Play Verifier](https://github.com/trillboards/proof-of-play-verifier)

## License

MIT