# Pushnami Ads

> Pushnami Ads (ads.pushnami.com) is the advertiser dashboard for the Pushnami push notification ad network. Advertisers create campaigns, write push creatives, set bids and budgets, and choose which publisher sources to buy. The dashboard itself requires a signed-in advertiser; AI agents should not scrape it. Use the MCP server or the REST API with the advertiser's API key instead.

## For AI agents

- [Agent Guide](https://help.pushnami.com/developers/agents): start here. How to connect, the tools, validation rules, and the actions that need the user's confirmation.
- [MCP Server](https://help.pushnami.com/developers/mcp-server): MCP endpoint https://ads-api.pushnami.com/mcp (Streamable HTTP). Two ways in: OAuth sign-in with the advertiser's Pushnami Ads login, for any MCP client that supports OAuth (metadata at https://ads-api.pushnami.com/.well-known/oauth-protected-resource/mcp), or `Authorization: Bearer pnk_...` with an API key for clients that send a header.
- [Campaign Management API](https://help.pushnami.com/developers/campaign-management-api): REST reference at https://ads-api.pushnami.com/v1. OpenAPI: https://ads-api.pushnami.com/v1/openapi.json
- [Spend Report API](https://help.pushnami.com/developers/spend-report-api): reporting (spend, clicks and conversions by campaign, creative and source).

## Connecting an agent without a key

In an MCP client that supports OAuth sign-in, the advertiser adds https://ads-api.pushnami.com/mcp as an MCP server or connector and signs in on the Pushnami sign-in page with the email address and password they use for Pushnami Ads. No API key is needed. The connection can read and change the account, like a read & write key; removing the server or connector in the client stops it. The REST API takes API keys only.

## Getting an API key

The advertiser creates one in the dashboard at https://ads.pushnami.com/developers/api (**API Access** in the side menu). They choose read-only or read & write and a lifetime (30 days, 90 days or 1 year), then copy the key, which is shown once. Keys last up to 1 year; renew in place from the same page before or after expiry. Renewing keeps the same key string, so a configured agent keeps working. Never ask the user for their dashboard password in chat.

## What an agent can and can't do

- Can: list and read campaigns, creatives and source settings; create, edit, clone, pause, activate and archive campaigns and creatives; upload images (from a link or a file); set per-source bids; block or allow sources; check the account balance (read-only).
- Can't: add funds, change payment methods or read invoices. Those stay in the dashboard. Reporting is in the Spend Report API.
- New and edited creatives go through human review before they serve. Pausing is always allowed. Daily limits apply to other changes.

## Discovery

- AI Catalog: https://ads.pushnami.com/.well-known/ai-catalog.json (also on https://ads-api.pushnami.com)
- MCP server card: https://ads-api.pushnami.com/mcp/server-card
- API catalog (RFC 9727): https://ads-api.pushnami.com/.well-known/api-catalog

## Product docs

- [Help center](https://help.pushnami.com)
- [Campaigns](https://help.pushnami.com/campaigns)
- [Creatives](https://help.pushnami.com/creatives)
- [Creative review process](https://help.pushnami.com/creatives/review-process)
- [Source optimization](https://help.pushnami.com/campaigns/source-optimization)
- [Push notification specifications](https://help.pushnami.com/best-practices/push-notification-specifications)